第 3 章 自定义 config.yaml 文件


在集成产品和外部服务前,使用此流程自定义 config.yaml 文件。自定义此文件可确保在安装过程中保留集成和首选项。

先决条件

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

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

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

      注意

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

流程

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

    注意
    • 如果您的集群已经包含所需的订阅或运算符,您可以通过将 manageSubscription 属性设置为 false 来防止安装程序创建新订阅。

      • manageSubscription: true (默认):安装程序管理和安装所有所需的 operator 订阅。
    • manageSubscription: false :安装程序跳过安装所需的 Operator 订阅,因为它假定它们已存在于集群中。

      • 确保预安装的运算符 与 RHTAP 兼容。不兼容的版本或配置可能会导致安装失败。
  6. 根据需要更新以下字段:

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

      redhatDeveloperHub:
        properties:
          catalogURL: https://github.com/<your-org>/tssc-sample-templates/blob/releases/all.yaml
    2. 要禁用外部集成的组件安装(例如 ACS 和 Quay):

      redhatAdvancedClusterSecurity:
        enabled: &rhacsEnabled false
        namespace: &rhacsNamespace rhtap-rhacs
      
      redHatQuay:
        enabled: &quayEnabled false
        namespace: &quayNamespace rhtap-quay
      注意

      如果您试图在产品外集成或预先存在的实例,但没有自定义 config.yaml,Red Hat Trusted Application Pipeline 仍会安装和使用其默认产品。您必须自定义 config.yaml 才能使 rhtap-cli 集成 命令生效。但是,如果您没有为 rhtap-cli 集成 自定义 config.yaml,安装程序会部署该产品并覆盖现有的集成。

  1. 要在 Developer Hub 中启用 RBAC 插件,请在 redhatDeveloperHub 部分中配置 RBAC 属性。

      RBAC:
        enabled: true # Enables the RBAC feature.
        adminUsers: # GitHub usernames that should have administrator access.
          - yourGitHubUsername
          - anotherGitHubAdmin
        orgs: # GitHub organizations whose members are imported into the Developer Hub catalog with access roles.
          - your-github-org
    注意

    如果省略 adminUsersorgs,安装程序将默认为集成 GitHub 应用程序时配置的 GitHub 用户和机构。

  1. 要使用自定义命名空间而不是默认命名空间,请在 config.yaml 文件的 redhatDeveloperHub 部分中配置 namespacePrefixes 属性。默认情况下,RHTAP 在安装过程中创建四个命名空间:

    • rhtap-app-ci :用于 CI 管道工作负载
    • rhtap-app-development,rhtap-app-stage, 和 rhtap-app-prod: 用于 development、stage 和 prod 部署

      您可以自定义这些命名空间的前缀,并使用 namespacePrefixes 属性定义额外的命名空间集。例如,您可以配置自定义前缀来生成命名空间,如 my_prefix1-app-cimy_prefix1-app-developmentmy_prefix1-app-stagemy_prefix1-app-prod

      redhatDeveloperHub:
        namespacePrefixes:
          - my_prefix1
          - my_prefix2
      1. 完成所有必要的更改后,选择 Save
Red Hat logoGithubredditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

Theme

© 2026 Red Hat
返回顶部