---
outline: [2, 3]
description: 了解如何在 Olares 中将你的应用接入 MariaDB 服务。
---
# 集成 MariaDB

通过在 `OlaresManifest.yaml` 中声明 MariaDB 中间件，并将系统注入的配置值映射到容器的环境变量中，即可在应用中使用 Olares 提供的 MariaDB 服务。

## 安装 MariaDB 服务

通过应用市场安装 MariaDB 服务。

1. 从启动台打开应用市场，搜索“MariaDB”。
2. 点击**获取**，然后点击**安装**，并等待安装完成。

安装完成后，MariaDB 服务及其连接信息将显示在控制面板的中间件列表中。

## 配置 `OlaresManifest.yaml`

在 `OlaresManifest.yaml` 中添加所需的中间件配置。

- 使用 `username` 字段指定数据库用户名。
- 使用 `databases` 字段申请一个或多个数据库。每个数据库的名称将作为键注入到 `.Values.mariadb.databases` 中。

**示例**
```yaml
middleware:
  mariadb:
    username: mariadbclient
    databases:
      - name: aaa
```

## 映射环境变量

在应用的部署 YAML 中，将系统注入的 `.Values.mariadb.*` 字段映射为应用所需的环境变量。

**示例**
```yaml
containers:
  - name: my-app
    # MariaDB 对应的注入值如下
    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 }}"
      
      # 数据库名称
      # 在 OlaresManifest 中配置的数据库名（例如：aaa）
      - name: MDB_DB
        value: "{{ .Values.mariadb.databases.aaa }}"
```

## MariaDB 变量参考

MariaDB 运运行时变量会在部署过程中注入到 `values.yaml` 中。这些变量由系统统一管理，用户无法自行修改。

| 变量 | 类型 | 说明 |
|--|--|--|
| `.Values.mariadb.host` | String | MariaDB 主机地址。 |
| `.Values.mariadb.port` | Number | MariaDB 端口。 |
| `.Values.mariadb.username` | String | MariaDB 用户名。 |
| `.Values.mariadb.password` | String | MariaDB 密码。 |
| `.Values.mariadb.databases` | Map<String,String> | 请求的数据库集合，按数据库名为键。<br/>例如申请 `app_db`，可通过 `.Values.mariadb.databases.app_db` 获取对应的值。 |