Files

Meow33 776848d2e2 docs: add application environment variables (#2577 )

* docs: updated installation env vars and runtime values references

* docs: fix content

* docs: update content

* Update table of contents, and refactored docs.

* Fixed capitalization.

* batch update to fix readability

* refactored declarative env var

* Updated translation.

* Updated based on suggestions.

* Updated based on suggestions.

---------

Co-authored-by: yajing wang <413741312@qq.com>

2026-03-05 17:52:22 +08:00

2.3 KiB

Raw Blame History

outline, description

outline

description

了解如何在 Olares 中将你的应用接入 MariaDB 服务。

集成 MariaDB

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

安装 MariaDB 服务

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

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

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

配置 `OlaresManifest.yaml`

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

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

示例

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

映射环境变量

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

示例

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>	请求的数据库集合，按数据库名为键。例如申请 `app_db`，可通过 `.Values.mariadb.databases.app_db` 获取对应的值。

2.3 KiB Raw Blame History Unescape Escape