容器轻应用平台

    • 容器轻应用平台 > 使用指南 > 应用配置

    应用配置

    最近更新时间: 2023-04-19 11:18:33

    应用配置能够将环境配置信息和容器镜像解耦，方便您修改应用的配置，配置发生变更时，能避免额外的代码修改和镜像构建，从而有效降低了代码维护成本。您只需设定配置并指定挂载路径，应用即可从对应路径读取该配置文件。

    管理应用配置列表

    创建的配置项将显示在应用配置列表页面，您可以对其进行 更新、 修改 、 删除的操作。

    应用配置文件来源分为两种类型：

    • 手动创建：手动创建配置文件
    • 代码库：通过代码库导入配置文件

    img

    不同类型的文件来源，对应的操作不同

    1. 手动创建
      • 【修改】：修改范围，除了 配置名称 不可修改，其他均可修改
      • 【删除】：删除应用配置
    2. 代码库同步
      • 【更新配置文件】：通过代码库同步，更新覆盖之前的应用配置。
      • 【修改】：修改范围，除了 配置变量 可以修改，其他均不可修改
      • 【删除】：删除应用配置

    注意：

    如果当前应用配置被应用版本关联过，在应用配置列表页面，对其进行更新、 修改 、 删除的操作的影响范围如下：

    • 应用配置发生了变更（修改文件名 or 删除文件），需要新建版本选择修改后的应用配置，重新绑定文件路径后，再去部署实例，才可生效。如果不新建版本直接进行实例部署，会部署失败。
    • 应用配置发生了变更（修改文件内容），仅生效于新的实例部署，对存量已创建的实例部署不生效。
    • 应用配置发生了变更（新增文件），仅生效于新的实例部署，对存量已创建的实例部署不生效。如果需要使用新增的配置文件，建议先新建版本绑定新增文件路径后，再去部署实例。
    • 应用配置被删除，新建实例部署会失败，对存量已创建的实例部署不生效。

    手动创建应用配置

    1. 登录 容器轻应用平台。

    2. 在左侧导航栏单击 具体应用名称，在顶部菜单栏选择 应用配置。

    3. 在应用配置列表上方，单击 新建应用配置 按钮。

      img

    4. 在新建应用配置页面，设置相关参数。

      img

      参数 说明
      配置名称 必填，自定义。名称格式为1-63个字符，可以包含小写字母、数字、-，开头和结尾必须为字母或数字
      配置详情 必填，可以添加多个配置文件，每个文件配置内容包括：
      1) 文件名：名称格式为1-63个字符，可以包含字母、数字、.、-、_。
      2) 内容：自定义yaml文件内容。
      环境变量 非必填，默认关闭。点击开启后，设置以下参数：
      img 1) 生效区域：选择生效区域，可以设置替换多个区域的变量。
      2) 环境变量：自定义，变量替换的内容。

    5. 设置环境变量后，可点击 预览 进行校验。img

    6. 单击 保存，应用配置创建成功。

    代码库导入应用配置

    1. 登录 容器轻应用平台。

    2. 在左侧导航栏单击 具体应用名称，在顶部菜单栏选择 应用配置。

    3. 在应用配置列表上方，单击 代码库导入配置 按钮。

      img

    4. 弹出 导入配置文件 的弹窗，设置相关参数。

      img

      参数 说明
      配置名称 必填，自定义。名称格式为1-63个字符，可以包含小写字母、数字、-，开头和结尾必须为字母或数字
      代码源 1. 如果是公共库，填写规范：https://repo.git
      2. 如果是私有库，可以使用以下两种方式：
      1）通过 auth2 的方式，https://oauth2:@repo.git
      2）通过 username 的方式，https://:@repo.git
      3. apiToken 获取方式，示例：
      1）GitHub：Creating a personal access token - GitHub Docs
      2）GitLab：Personal access tokens
      文件路径 # 管理应用配置列表设置文件所在的路径

    5. 导入成功后，点击 更新配置文件 按钮，弹出 更新导入配置文件 的弹窗，修改设置相关参数。。

      img

    6. 导入成功后，点击 修改，去设置环境变量。

      img

      非必填项，默认关闭。点击开启后，设置以下参数：

      • 生效区域：选择生效区域，可以设置替换多个区域的变量。

      • 环境变量：自定义，变量替换的内容。

    7. 设置环境变量后，可点击 预览 进行校验。img

    8. 单击 保存，应用配置修改成功。

    如何配置环境变量

    如果配置中含有 {{...}} 格式的文本，会在部署到具体区域时使用 go-template 语法进行文本替换。

    普通用户只需了解 变量引用方式 和 拓展函数 即可快速上手。

    更复杂的使用方式可参考 Go doc 。

    变量引用方式

    示例

    • 配置，通过 {{.Values.url}} 引用某特定区域中的 url 变量

      http:
  url: {{.Values.url}}

    • 在特定区域中声明 url 变量

      url: qiniu.com

    • 替换结果

      http: 
  url: qiniu.com

    拓展函数及使用方式

    缩进函数 indent(int, string) => string

    第一个参数为空格数量，第二个参数为文本变量，返回自行首缩进指定空格数量后的文本变量。

    示例

    • 配置

      {{ .Values.url | indent 2 }}
{{ indent 4 .Values.url }}

    • 设置变量

      url: qiniu.com

    • 替换结果

       qiniu.com
    qiniu.com
    以上内容是否对您有帮助？
    • Close