Olares/docs/zh/developer/develop/app-env-index.md
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

1.2 KiB
Raw Blame History

outline description
2
3
了解 Olares 应用在部署期间的变量注入机制:声明式环境变量(.Values.olaresEnv与系统自动注入的运行时 Helm Values.Values.*)。

环境变量概览

Olares 应用通过 app-service 将运行时信息与配置项注入到应用的 values.yaml 中。应用在 Helm 模板中通过 .Values.* 引用这些值。

:::info 变量与 Helm 值 本文提到的“变量”主要指 Helm 值。它们不会自动进入容器环境变量。如需在容器内使用,请在模板中显式映射到 env:。 :::

变量注入通道

Olares 通过两种通道注入变量:

  • 声明式环境变量:开发者在 OlaresManifest.yamlenvs 下声明变量。在部署时app-service 会解析这些值并将其注入到 values.yaml.Values.olaresEnv 路径下。
  • 系统注入的运行时变量:由 Olares 在部署时自动注入,无需声明。不过,某些值(例如中间件)只有在声明相关依赖后才可用。

下一步

  1. 声明式环境变量envs 字段说明、变量映射以及变量参考。
  2. 系统注入的运行时变量:所有系统注入运行时变量的完整参考。