在SAE中,配置项可以用作容器运行环境中的环境变量,便于应用部署后灵活变更容器配置,也可以通过挂载配置文件的方式向容器中注入配置信息。本文介绍如何管理和使用配置项。

创建配置项

请按照以下步骤在命名空间详情页面的配置项页面创建配置项。

  1. 登录 SAE 控制台
  2. 在左侧导航栏单击命名空间,在顶部菜单栏选择目标地域。
  3. 命名空间页面上,执行以下任一操作以进入命名空间详情页面。
    • 单击目标命名空间的名称。
    • 在目标命名空间的操作列中单击详情
  4. 在左侧导航栏单击配置项,在配置项页面单击创建
  5. 创建配置项面板上,选择以下方法之一来创建配置项,并单击确定
    • 手工创建:在默认显示的手工创建页签上,输入配置项名称配置项描述(可选),并添加配置映射键值对。如需添加更多键值对,单击添加panel_create_config_tab_manual
      说明 键的长度不超过250个字符,值的长度不超过10,000个字符。最多可添加20个键值对。
    • 文件录入:单击文件录入页签,输入配置项名称,选择配置格式,并在配置内容文本框中输入Kubernetes ConfigMap Manifest文件内容。 panel_create_config_tab_upload
      说明 支持JSON、YAML格式,字符为Unicode字符集,且文件内容中数据值大小不能超过512KB。具体格式要求请参见配置项文件格式
    创建的配置项将显示在配置项页面的表格中。

编辑和删除配置项

如需编辑或删除配置项,请按照以下步骤操作。

  • 如需编辑配置项,在配置项页面的表格中,单击目标配置项右侧操作列中的编辑,并按需修改配置项内容。
  • 如需删除配置项,在配置项页面的表格中,单击目标配置项右侧操作列中的删除

将配置项用作环境变量

配置项可以用作容器运行环境中的环境变量,便于部署后灵活变更容器配置。在SAE控制台创建应用时,可以在应用部署配置页签的环境变量设置区域使用按照本文步骤创建的配置项。

  1. 登录 SAE 控制台
  2. 在左侧导航树单击应用列表,并在应用列表页面单击右上角创建应用
  3. 创建应用页面的应用部署配置页签展开环境变量设置
  4. 环境变量设置区域的类型下拉框中选择引用配置项,输入变量名称,并在最右侧的下拉框中选择已创建的配置项名称和该配置项中的键。
    sc_environment_variable
  5. 可选:如需引用其他配置项,单击添加,并重复上一步。

利用配置项向容器中注入配置信息

您可以使用在命名空间配置项页面创建的配置项来向容器中注入配置信息。

  1. 登录 SAE 控制台
  2. 在左侧导航栏单击应用列表,并在应用列表页面右上角单击创建应用
  3. 应用基本信息页签输入所有必填信息,并单击下一步:应用部署配置
  4. 应用部署配置页签输入所有必填信息,然后展开配置管理
  5. 配置管理区域选择已创建的配置项名称和该配置项中的,并输入挂载配置项的挂载路径
    sc_configs
  6. 可选:如需引用其他配置项,单击添加,并重复上一步的操作。

配置项文件格式

如果选择以文件录入方式创建配置项,请确保文件符合以下格式要求。

  • 只能为JSON或YAML格式。
  • 键和值必须是字符串,不能是数组或对象。
  • 键的长度不超过250个字符。
  • 值的长度不超过10,000个字符。

文件格式示例:

  • JSON文件格式示例:

    {
      "key1": "value1",
      "key2": "value2",
      "key3": "k1=v1\nk2=v2\nk3=v3"
    }
  • YAML文件格式示例:

    key1: value1
    key2: value2
    key3: |-
      k1=v1
      k2=v2
      k3=v3