第 3 章 自定义 config.yaml 文件


在集成外部产品和服务前自定义 config.yaml 文件,以便在安装过程中保留您的集成设置。

先决条件

  • 您可以访问 OpenShift Web 控制台。
  • 您计划至少集成一个外部产品或服务(如 RHACS 或 Quay)。
  • (可选)用于软件目录存储库 URL。RHADS - SSC 提供软件模板目录,供开发人员构建应用程序。要自定义这些模板,请在安装前分叉存储库。

    1. 在您的浏览器中,前往 RHADS - SSC 软件目录存储库
    2. Fork 对存储库进行分叉。

      1. 取消选中标有 Copy the main 分支的框
    3. 创建 fork 时,复制其 URL 并将其保存到 private.env 文件中。
    4. 在 fork 存储库中,单击 main 以打开分支/标签下拉菜单。
    5. 在标签下,选择与您的 RHADS - SSC 版本匹配的版本。

      注意

      定期更新您的分叉,使其包含来自上游存储库的更改。

流程

  1. 在 OpenShift 控制台中,切换到 Administrator 视角。
  2. 进入 Workloads > ConfigMaps
  3. 从 Project 下拉列表中,选择 RHADS - SSC。
  4. 打开 tssc-config ConfigMap。
  5. 选择 YAML 视图并导航到定义 config.yaml 参数的位置。

    注意
    • 为了避免在集群中已存在重新安装 operator 订阅,请设置 manageSubscription:false

      • manageSubscription:true (默认):安装程序管理和安装所有所需的 operator 订阅。
      • manageSubscription:false :安装程序跳过安装所需的 operator 订阅。
      • 确保现有的运算符 与 RHADS - SSC 兼容。不兼容的版本可能会导致安装失败。

config.yaml 文件的结构

config.yaml 文件的结构在带有这些关键属性的主 tssc 对象下:

  • 命名空间 :定义默认的安装命名空间(通常是 tssc),充当主要操作区域。
  • 设置 :控制全局部署设置和属性。
  • 产品 :列出部署的产品和功能,各自通过具有关联属性的唯一名称来标识。
  • dependencies :指定安装程序按配置文件中定义的顺序部署的依赖项。

自定义 tssc.products 部分

  1. 要使用自定义软件目录,请设置 catalogURL

    developerHub:
      properties:
        catalogURL: https://github.com/<your-org>/tssc-sample-templates/blob/release-v1.6.x/all.yaml
    Copy to Clipboard Toggle word wrap
  2. 要禁用外部集成的组件的自动安装:

    advancedClusterSecurity:
      enabled: &rhacsEnabled false
      namespace: &rhacsNamespace tssc-acs
    
    quay:
      enabled: &quayEnabled false
      namespace: &quayNamespace tssc-quay
    Copy to Clipboard Toggle word wrap
    注意

    如果没有在 config.yaml 中正确反映外部集成,安装程序将部署默认组件。更新该文件,以防止意外的调配。

  3. 为 Developer Hub 启用基于角色的访问控制(RBAC):

    developerHub:
      RBAC:
        enabled: true
        adminUsers:
          - yourGitHubUsername
          - anotherGitHubAdmin
        orgs:
          - your-github-org
    Copy to Clipboard Toggle word wrap
    注意

    如果您没有定义 adminUsersorgs,安装程序将默认使用集成期间指定的 GitHub 凭证。

  4. 要使用自定义命名空间前缀而不是默认的命名空间,请配置 namespacePrefixes 属性。默认情况下,RHADS - SSC 在安装过程中创建以下命名空间:

    • tssc-app-ci :用于持续集成管道工作负载
    • tssc-app-development,tssc-app-stage, 和 tssc-app-prod: 用于开发、暂存和生产部署

      您可以自定义这些命名空间的前缀,并定义其他集合。例如:

    developerHub:
      namespacePrefixes:
        - my_prefix1  # This generates the following namespaces: `my_prefix1-app-ci`, `my_prefix1-app-development`, `my_prefix1-app-stage`, `my_prefix1-app-prod`
        - my_prefix2 # This generates the following namespaces: `my_prefix2-app-ci`, `my_prefix2-app-development`, `my_prefix2-app-stage`, `my_prefix2-app-prod`
    Copy to Clipboard Toggle word wrap
  5. 完成所有必要的更改后,选择 Save
返回顶部
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

通过我们的产品和服务,以及可以信赖的内容,帮助红帽用户创新并实现他们的目标。 了解我们当前的更新.

让开源更具包容性

红帽致力于替换我们的代码、文档和 Web 属性中存在问题的语言。欲了解更多详情,请参阅红帽博客.

關於紅帽

我们提供强化的解决方案,使企业能够更轻松地跨平台和环境(从核心数据中心到网络边缘)工作。

Theme

© 2025 Red Hat