配置

软件设计通常会将配置与代码进行分离，把易变内容、不同环境参数等提炼到应用配置中进行管理，具体配置方式一般会以文件、启动参数或环境变量的形式存在。

Erda 平台提供了两种配置：

  • 应用构建 (打包) 配置
  • 应用运行时配置

应用构建配置是在应用编译、构建、打包阶段提供的，构建打包结束后配置项将固化在软件包中，如果配置变更，需要重新打包应用。后者在应用部署启动阶段提供，大部分应用配置会采用此种方式，例如 MySQL 连接地址、业务功能开关配置等。

本文重点介绍应用运行时配置。

配置途径

运行时配置有两种配置途径：

  • 通过 erda.yml 的 envs 关键字进行配置。
  • 通过应用设置控制台界面配置。

:::tip 提示

两种途径写入的配置项最终都是通过环境变量（不是文件，也不是启动参数）的方式提供给应用程序使用，所以应用程序需要采用相应的方式从环境变量中读取配置项。环境变量的读取方式每种开发语言都有提供，都略有不同。

:::

erda.yml envs 关键字

通过全局 envs 配置

  1. envs:
  2.   TEST_ENV: test
  3.   TEST_ENV2: test2

通过 service 级 envs 配置

  1. services:
  2.   web:
  3.     envs:
  4.       TEST_ENV: test
  5.       TEST_ENV2: test2

:::tip 提示

services 下的 web 关键字只是此处的一个举例，web 是一个 service 名字。

:::

应用设置

进入 DevOps 平台 > 项目 > 应用 > 应用设置 > 部署中心 > 参数设置。

配置 - 图1

对于值类型的配置，会在容器内作为环境变量存在，可用 env 命令查看。

对于文件类型的配置，文件位于容器内 /init-data 目录下，文件名为配置时的 key 值，文件内容即为上传的文件, 可进入容器控制台查看。

优先级

对于一个应用服务，优先级按如下顺序由高到低。

  1. 平台环境变量，比如 SELF_HOST、 <被发现者服务名大写>_HOST、<被发现者服务名大写>_PORT, ERDA_*
  2. erda.yml service 级 envs
  3. Addon 环境变量，比如 MYSQL_HOST、REDIS_PORT
  4. 应用设置中的环境级配置
  5. erda.yml 全局 envs

蓝绿部署配置

只有生产环境默认是开启蓝绿部署配置的，其他环境如需要开启的话请联系平台技术支持团队进行更改。