应用管理

配置/密钥

配置/密钥 标签页用来把配置文件和敏感信息以文件的形式挂载到 Web 应用的容器中,适合 application.yaml、nginx.conf、.env、TLS 证书、API Token 等内容。

页面有两个标签页:

类型适合存放对应 Kubernetes 对象
配置不敏感的配置文件,如 nginx.conf、config.jsonConfigMap
密钥密码、Token、证书、私钥等敏感数据,值默认隐藏Secret

配置列表

note

这里的配置和密钥在应用运行时生效,与创建应用时填写的 构建环境变量 不同,后者只在构建阶段可用。

新建配置

点击 新建配置:

新建配置

字段说明
关联组件应用有多个组件时需要选择配置属于哪个组件;只有一个组件时自动选择。编辑时不能修改
名称小写字母、数字和 -,以字母或数字开头和结尾,例如 my-config。同一应用内不能重名,编辑时不能修改
描述可选,说明用途
键值对点击 新增 添加。key 是文件名,例如 application.yaml;值 是文件内容
挂载配置指定挂载到容器中的路径。留空表示只创建配置,不挂载

编辑键值对

点击键值对卡片打开 编辑配置项。值支持多种格式:String、JSON、YAML、TOML、XML、INI、.env、Properties。选择格式后编辑器会实时校验语法,格式错误时会提示 "解析错误"。key 不能为空,也不能重复。

新建密钥

切换到 密钥 标签页,点击 新建密钥:

新建密钥

字段与配置相同,另外多了 类型:

类型用途
Opaque (通用)默认类型,任意键值对
Basic Auth用户名和密码
TLS证书和私钥
Token访问令牌

密钥的值以密码框显示,可以点击 显示 / 隐藏 查看,或点击 多格式编辑 在大编辑器中修改。

挂载方式

点击 新增挂载,填写 mountPath 并选择挂载方式:

挂载方式效果示例
整体挂载把所有 key 作为文件放到 mountPath 目录下mountPath /etc/app,key a.yaml、b.yaml → 容器中得到 /etc/app/a.yaml、/etc/app/b.yaml
选择某个 key只把这个 key 挂载为 mountPath 指向的单个文件mountPath /etc/nginx/nginx.conf,选择 key nginx.conf → 容器中得到该文件

mountPath 规则:

  • 必须是 Linux 绝对路径,以 / 开头,不能以 / 结尾;
  • 只能包含字母、数字、.、_、-、/,不能包含 ..;
  • 同一配置或密钥中的 mountPath 不能重复。

warning

整体挂载会覆盖目标目录中的原有文件。只想放一个文件时,请选择具体的 key 进行单文件挂载。

生效方式

新建、修改或删除配置/密钥后,需要点击右上角 重启(或重新部署)才会生效。

列表与管理

列表显示名称、类型(仅密钥)、所有者、键数量、挂载和描述:

  • 所有者:用户 创建的可以编辑和删除;系统 或 模板托管 创建的只能查看。
  • 查看:查看内容,密钥值需要点击 显示值。
  • 删除:删除后,引用它的挂载将不可用。

示例:给 Node.js 应用挂载 .env

  1. 新建密钥,名称 app-env,类型 Opaque。

  2. 新增键值对,key 填 .env,值填写:

    DATABASE_URL=postgresql://user:pass@host:5432/postgres
    JWT_SECRET=change-me
  3. 新增挂载,mountPath 填 /app/.env,挂载方式选择 key .env。

  4. 保存后重启应用,应用即可在启动时读取 /app/.env。

更新于

此页面是否有帮助?