第 1 章 置备并使用您的自定义 Red Hat Developer Hub 配置

流程

1. 为安全起见，请将您的 secret 作为环境变量值存储在 OpenShift Container Platform secret 中，而不是在配置文件中以明文形式保存。在 secrets.txt 文件中收集您的所有 secret，每行一个 secret ( KEY=value 格式)。

   • 输入您的身份验证 secret。

2. 编写自定义 app-config.yaml 文件。这是主要的 Developer Hub 配置文件。您需要自定义 app-config.yaml 文件来避免 Developer Hub 安装程序在升级过程中恢复用户编辑。当自定义 app-config.yaml 文件为空时，Developer Hub 将使用默认值。

   • 要在 OpenShift Container Platform 上使用 Red Hat Developer Hub Operator 准备部署，您可以从一个空文件开始。

   • 要使用 Red Hat Developer Hub Helm Chart 或 Kubernetes 准备部署，请在 app-config.yaml 文件中的相关字段中输入 Developer Hub 基础 URL，以确保 Developer Hub 正常工作。基本 URL 是 Developer Hub 用户在访问 Developer Hub 时看到的内容。相关字段在 app 和 backend 部分中是 baseUrl，在 backend.cors 子部分中是 origin ：

     例 1.1. 在 app-config.yaml中配置 baseUrl

     app:
       title: Red Hat Developer Hub
       baseUrl: https://<my_developer_hub_domain>
     
     backend:
       auth:
         externalAccess:
           - type: legacy
             options:
               subject: legacy-default-config
               secret: "${BACKEND_SECRET}"
       baseUrl: https://<my_developer_hub_domain>
       cors:
         origin: https://<my_developer_hub_domain>

     Copy to Clipboard Toggle word wrap

   • 另外，还可输入您的配置，例如：

     • Red Hat Developer Hub 中的身份验证.
     • Red Hat Developer Hub 中的授权。
     • 自定义.
     • 配置 OpenShift 容器平台集成.

3. 编写自定义 dynamic-plugins.yaml 文件以启用插件。默认情况下，Developer Hub 启用最小插件集，并禁用需要配置或 secret 的插件，如 GitHub 存储库发现插件和基于角色的访问控制(RBAC)插件。

   启用 GitHub 存储库发现和 RBAC 功能：

   dynamic.plugins.yaml

   includes:
     - dynamic-plugins.default.yaml
   plugins:
     - package: ./dynamic-plugins/dist/backstage-plugin-catalog-backend-module-github
       disabled: false
     - package: ./dynamic-plugins/dist/backstage-community-plugin-rbac
       disabled: false

   Copy to Clipboard Toggle word wrap

4. 为 OpenShift Container Platform 集群置备自定义配置文件。

   1. 创建包含 Developer Hub 实例的 < my-rhdh-project > {namespace}。

      $ oc create namespace my-rhdh-project

      Copy to Clipboard Toggle word wrap

   2. 将 app-config.yaml 和 dynamic-plugins.yaml 文件分别置备到 my-rhdh-app-config，并在 < my-rhdh-project> 项目中置备 dynamic-plugins-rhdh 配置映射。

      $ oc create configmap my-rhdh-app-config --from-file=app-config.yaml --namespace=my-rhdh-project
      $ oc create configmap dynamic-plugins-rhdh --from-file=dynamic-plugins.yaml --namespace=my-rhdh-project

      Copy to Clipboard Toggle word wrap

      或者，使用 Web 控制台创建配置映射。

   3. 将您的 secrets.txt 文件置备为 <my-rhdh- project> 项目中的 my-rhdh- secrets secret。

      $ oc create secret generic my-rhdh-secrets --from-file=secrets.txt --namespace=my-rhdh-project

      Copy to Clipboard Toggle word wrap

      或者，使用 Web 控制台创建机密。