在 OpenShift Container Platform 上安装 Red Hat Developer Hub

流程

1. 在 OpenShift Container Platform 控制台的导航菜单中点 Operators & gt; OperatorHub。
2. 在 Filter by keyword 框中，输入 Developer Hub 并点 Red Hat Developer Hub Operator 卡。
3. 在 Red Hat Developer Hub Operator 页面中，阅读有关 Operator 的信息，并点 Install 打开 Install Operator 页面。

4. 成功安装 Operator 后，置备自定义配置：

   在创建 Developer Hub 实例前，您必须在项目中创建所需的配置映射和 Secret 资源。这包括 baseUrl 和 service-to-service 身份验证 secret。

   具体步骤请参阅 置备自定义 Red Hat Developer Hub 配置。

5. 在 Update channel 下拉菜单中选择要使用的更新频道，例如 fast 或 fast-1.6。

   重要

   'fast 频道包括特定版本可用的所有更新。任何更新都可能会在 Red Hat Developer Hub 部署中引入意外更改。参阅发行注记以了解任何可能破坏更改的详细信息。

   fast-1.6 频道只提供 z-stream 更新，例如从 1.6.1 更新至 1.6.2。如果要在以后更新 Red Hat Developer Hub y-version，例如从 1.6 更新至 1.7，您必须手动切换到 fast-1.7 频道。

6. 在 Version 下拉菜单中选择要安装的 Red Hat Developer Hub Operator 版本。默认版本是所选频道中提供的最新版本。

7. 选择 Operator 安装模式。

   注意

   默认选择 All namespaces on the cluster (default) 选项。目前不支持 cluster 选项上的特定命名空间。

8. 在 Installed Namespace 字段中，执行以下操作之一：

   • 选择 Operator recommended Namespace 来创建并使用 rhdh-operator 命名空间。默认选择这个选项。

   • 选择 Select a Namespace 使用替代命名空间。

     • 在 Select Project 下拉菜单中，执行以下操作之一：

       • 选择现有项目。

       • 选择 Create Project 为 Operator 创建新项目。

         • 在 Create Project 对话框中，在必填字段中输入文本，然后单击 Create。

           重要

           为提高安全性，更好地控制 Operator 生命周期，并防止潜在的权限升级，请在专用默认 rhdh-operator 命名空间中安装 Red Hat Developer Hub Operator。您可以通过角色绑定或集群角色绑定限制其他用户对 Operator 资源的访问。

           您还可以通过创建所需资源（如 Operator 组）在另一个命名空间中安装 Operator。如需更多信息，请参阅 在自定义命名空间中安装全局 Operator。

           但是，如果 Red Hat Developer Hub Operator 与其他 Operator 共享一个命名空间，则它也会共享相同的更新策略，从而导致自定义更新策略。例如，如果一个 Operator 设置为手动更新，Red Hat Developer Hub Operator 更新策略也会设置为 manual。如需更多信息，请参阅 在命名空间中重新定位 Operator。

9. 为 Operator 选择 Update approval 方法。

   • 如果选择 Automatic 选项，则 Operator 会被更新，而无需手动确认。
   • 如果选择 Manual 选项，则当更新频道中发布新更新时，会打开通知。在开始安装前，管理员必须手动批准更新。

10. 点 Install。

    注意

    如果选择了手动批准策略，订阅的升级状态将保持在 Upgrading 状态，直至您审核并批准安装计划。在 Install Plan 页面中点 Approve 后，订阅升级状态将变为 Up to date。

    如果选择了 Automatic 批准策略，升级状态会在不用人工参与的情况下变为 Up to date。

流程

1. 在 OpenShift Container Platform web 控制台中，选择您的 &lt ;{my_product_namespace}&gt; 项目，然后单击 Add。
2. 在 Developer Catalog 面板中，单击 Operator Backed。
3. 在 Filter by keyword 框中，输入 Developer Hub 并点 Red Hat Developer Hub 卡。

4. 使用以下模板置备自定义配置：

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://__<my_developer_hub_url>__
       backend:
         auth:
           externalAccess:
               - type: legacy
                 options:
                   subject: legacy-default-config
                   secret: "${BACKEND_SECRET}"
         baseUrl: https://__<my_developer_hub_url>__
         cors:
           origin: https://__<my_developer_hub_url>__

   Copy to Clipboard Toggle word wrap

   使用名为 app-config-rhdh 的配置映射来提供 app-config.yaml 文件，以及用于服务到服务身份验证的 Secret （如 BACKEND_SECRET）。

   要创建并应用这些配置资源，请按照为完整流程 置备自定义 Red Hat Developer Hub 配置 中的步骤操作。

   注意

   app-config-rhdh 配置映射必须包含您自定义的 app-config.yaml 文件。此配置映射在运行时挂载到 Developer Hub 容器中。

5. 创建名为 my-rhdh-secrets 的 secret，并添加名为 BACKEND_SECRET 的键，其值为 Base64 编码的字符串，如下例所示：

   apiVersion: v1
   kind: Secret
   metadata:
     name: my-rhdh-secrets
   stringData:
     # TODO: Add the necessary auth secrets for service-to-service auth setup
     BACKEND_SECRET: "xxx" # Replace with your Base64-encoded secret

   Copy to Clipboard Toggle word wrap
   注意

   确保您的机密包含 BACKEND_SECRET，用于服务到服务身份验证。有关结构和置备步骤，请参阅置备自定义 Red Hat Developer Hub 配置。

6. 点 Create。
7. 添加 Backstage 自定义资源内容。
8. 在 Create Backstage 页面上，单击 Create。

1. 点 Topology 视图中的 pod 并确认 Details 面板中的 Status，以确认 pod 已就绪。当 pod 就绪时，pod 状态为 Active。

2. 在 Topology 视图中，点 Developer Hub pod 上的 Open URL 图标。

   

   View larger image

   

流程

1. 从 Developer Hub web 控制台的 Developer 视角，点 +Add。
2. 在 Developer Catalog 面板中点击 Helm Chart。
3. 在 Filter by keyword 框中，输入 Developer Hub 并点 Red Hat Developer Hub 卡。
4. 在 Red Hat Developer Hub 页面中，单击 Create。
5. 在集群中，复制 OpenShift Container Platform 路由器主机（例如： apps.<clusterName>.com）。

6. 选择单选按钮，以使用表单视图或 YAML 视图来配置 Developer Hub 实例。Form 视图会被默认选择。

   • 使用 Form view

     1. 要使用 Form 视图配置实例，请转至 Backstage 实例中 Root Schema → global → Enable service authentication，并将 OpenShift Container Platform 路由器主机粘贴到表单上的字段。

   • 使用 YAML 视图

     1. 要使用 YAML 视图配置实例，请将 OpenShift Container Platform 路由器主机名粘贴到 global.clusterRouterBase 参数值中，如下例所示：

        global:
          auth:
            backend:
              enabled: true
          clusterRouterBase: apps.<clusterName>.com
          # other Red Hat Developer Hub Helm Chart configurations

        Copy to Clipboard Toggle word wrap

7. 如果需要，请编辑其他值。

   注意

   有关主机的信息被复制，并可以被 Developer Hub 后端访问。

   当自动生成 OpenShift Container Platform 路由时，路由的主机值会被推断出来，同一主机信息发送到 Developer Hub。另外，如果在自定义域上存在 Developer Hub，通过使用值手动设置主机，则自定义主机具有优先权。

8. 点 Create 并等待数据库和 Developer Hub 启动。

9. 点 Open URL 图标以使用 Developer Hub 平台启动。

   

   View larger image

   

流程

1. 创建并激活 < my-rhdh-project> OpenShift Container Platform 项目：

   NAMESPACE=<emphasis><rhdh></emphasis>
   oc new-project ${NAMESPACE} || oc project ${NAMESPACE}

   Copy to Clipboard Toggle word wrap

2. 安装 Red Hat Developer Hub Helm Chart:

   helm upgrade redhat-developer-hub -i https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.6.3/redhat-developer-hub-1.6.3.tgz

   Copy to Clipboard Toggle word wrap

3. 使用 OpenShift Container Platform 集群中的 Developer Hub 数据库密码和路由器基本 URL 值配置 Developer Hub Helm Chart 实例：

   PASSWORD=$(oc get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
   CLUSTER_ROUTER_BASE=$(oc get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
   helm upgrade redhat-developer-hub -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.6.3/redhat-developer-hub-1.6.3.tgz" \
       --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
       --set global.postgresql.auth.password="$PASSWORD"

   Copy to Clipboard Toggle word wrap

4. 显示正在运行的 Developer Hub 实例 URL：

   echo "https://redhat-developer-hub-$NAMESPACE.$CLUSTER_ROUTER_BASE"

   Copy to Clipboard Toggle word wrap