Integrate with MariaDB

Use Olares MariaDB middleware by declaring it in OlaresManifest.yaml, then mapping the injected values to your container environment variables.

Install MariaDB service

Install the MariaDB service from Market.

1. Open Market from Launchpad and search for "MariaDB".
2. Click Get, then Install, and wait for the installation to complete.

Once installed, the service and its connection details will appear in the Middleware list in Control Hub.

Configure OlaresManifest.yaml

In OlaresManifest.yaml, add the required middleware configuration.

• Use the username field to specify the database username.
• Use the databases field to request one or more databases. Each database name is used as the key in .Values.mariadb.databases.

Example

middleware:
  mariadb:
    username: mariadbclient
    databases:
      - name: aaa

Inject environment variables

In your deployment YAML, map the injected .Values.mariadb.* fields to the environment variables your app uses.

Example

containers:
  - name: my-app
    # For MariaDB, the corresponding value is as follows
    env:
      - name: MDB_HOST
        value: "{{ .Values.mariadb.host }}"
      
      - name: MDB_PORT
        value: "{{ .Values.mariadb.port }}"
      
      - name: MDB_USER
        value: "{{ .Values.mariadb.username }}"
      
      - name: MDB_PASSWORD
        value: "{{ .Values.mariadb.password }}"
      
      # Database Name
      # The database name configured in OlaresManifest (e.g., aaa)
      - name: MDB_DB
        value: "{{ .Values.mariadb.databases.aaa }}"

MariaDB Values reference

MariaDB Values are predefined environment variables injected into values.yaml during deployment. They are system-managed and not user-editable.

Key	Type	Description
.Values.mariadb.host	String	MariaDB database host
.Values.mariadb.port	Number	MariaDB database port
.Values.mariadb.username	String	MariaDB database username
.Values.mariadb.password	String	MariaDB database password
.Values.mariadb.databases	Map<String,String>	The requested database name is used as the key. For example, if you request aaa, the value is available at .Values.mariadb.databases.aaa.