容器轻应用平台

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

    应用配置

    最近更新时间: 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
      
    以上内容是否对您有帮助?
  • Qvm free helper
    Close