搜索

第 4 章 Red Hat Developer Hub 支持的配置

download PDF

本节论述了访问 Red Hat Developer Hub 所需的配置,包括:

  • 自定义应用程序配置
  • Developer Hub 目录的源控制配置

4.1. 在 Red Hat OpenShift Container Platform 中添加自定义应用程序配置文件

要访问 Red Hat Developer Hub,您必须在 Red Hat OpenShift Container Platform 中添加自定义应用程序配置文件。在 OpenShift Container Platform 中,您可以使用以下内容作为基础模板,创建名为 app-config-rhdh 的 ConfigMap:

kind: ConfigMap
apiVersion: v1
metadata:
  name: app-config-rhdh
data:
  app-config-rhdh.yaml: |
    app:
      title: {product}

您可以使用以下方法之一将自定义应用程序配置文件添加到 OpenShift Container Platform 中:

  • Red Hat Developer Hub Operator
  • Red Hat Developer Hub Helm Chart。

4.1.1. 使用 Helm Chart 将自定义应用程序配置文件添加到 OpenShift Container Platform 中

您可以使用 Red Hat Developer Hub Helm Chart 将自定义应用程序配置文件添加到 OpenShift Container Platform 实例中。

先决条件

  • 您已创建了 Red Hat OpenShift Container Platform 帐户。

流程

  1. 在 OpenShift Container Platform Web 控制台中,选择 ConfigMaps 选项卡。
  2. Create ConfigMap
  3. Create ConfigMap 页面中,选择 Configure via 中的 YAML view 选项,并根据需要更改该文件。
  4. Create
  5. 进入 Helm 选项卡查看 Helm 发行版本列表。
  6. 点击您要使用的 Helm 发行版本的 overflow 菜单,然后选择 Upgrade
  7. 使用 Form viewYAML 视图 来编辑 Helm 配置。

    • 使用 Form view

      1. 展开 Root Schema Backstage chart schema Backstage parameters Extra app 配置文件到内联到命令参数 中
      2. Add Extra app 配置文件以内联到命令参数 链接。
      3. 在以下字段中输入值:

        • configMapRef: app-config-rhdh
        • filename: app-config-rhdh.yaml
      4. 单击 Upgrade
    • 使用 YAML 视图

      1. 设置 upstream.backstage.extraAppConfig.configMapRefupstream.backstage.extraAppConfig.filename 参数的值,如下所示:

        # ... other Red Hat Developer Hub Helm Chart configurations
        upstream:
          backstage:
            extraAppConfig:
              - configMapRef: app-config-rhdh
                filename: app-config-rhdh.yaml
        # ... other Red Hat Developer Hub Helm Chart configurations
      2. 单击 Upgrade

4.1.2. 使用 Operator 将自定义应用程序配置文件添加到 OpenShift Container Platform 中

自定义应用程序配置文件是一个 ConfigMap 对象,可用于更改 Red Hat Developer Hub 实例的配置。如果要在 Red Hat OpenShift Container Platform 上部署 Developer Hub 实例,您可以使用 Red Hat Developer Hub Operator 将自定义应用程序配置文件添加到 OpenShift Container Platform 实例,方法是创建 ConfigMap 对象并在 Developer Hub 自定义资源(CR)中引用它。

自定义应用配置文件包含一个名为 BACKEND_SECRET 的敏感环境变量。此变量包含一个强制的后端身份验证密钥,Developer Hub 用来引用 OpenShift Container Platform secret 中定义的环境变量。您必须创建一个名为 'secrets-rhdh' 的 secret,并在 Developer Hub CR 中引用它。

注意

您需要保护 Red Hat Developer Hub 安装不受外部和未授权访问的影响。像管理任何其他机密一样管理后端身份验证密钥。满足强的密码要求,不要在任何配置文件中公开它,仅将其作为环境变量注入配置文件中。

先决条件

  • 您有一个活跃的 Red Hat OpenShift Container Platform 帐户。
  • 您的管理员已在 OpenShift Container Platform 中安装了 Red Hat Developer Hub Operator。如需更多信息,请参阅安装 Red Hat Developer Hub Operator
  • 您已在 OpenShift Container Platform 中创建 Red Hat Developer Hub CR。

流程

  1. 从 OpenShift Container Platform Web 控制台中的 Developer 视角,选择 Topology 视图,然后点击 Developer Hub pod 上的 Open URL 图标来识别 Developer Hub 外部 URL: < RHDH_URL>
  2. 从 OpenShift Container Platform Web 控制台中的 Developer 视角,选择 ConfigMaps 视图。
  3. Create ConfigMap
  4. Configure via 中选择 YAML view 选项,并使用以下示例作为基础模板来创建 ConfigMap 对象,如 app-config-rhdh.yaml

    kind: ConfigMap
    apiVersion: v1
    metadata:
      name: app-config-rhdh
    data:
      "app-config-rhdh.yaml": |
        app:
          title: Red Hat Developer Hub
          baseUrl: <RHDH_URL> 1
        backend:
          auth:
            keys:
              - secret: "${BACKEND_SECRET}" 2
          baseUrl: <RHDH_URL> 3
          cors:
            origin: <RHDH_URL> 4
    1
    设置 Red Hat Developer Hub 实例的外部 URL。
    2
    使用环境变量公开 OpenShift Container Platform secret,以定义强制的 Developer Hub 后端身份验证密钥。
    3
    设置 Red Hat Developer Hub 实例的外部 URL。
    4
    设置 Red Hat Developer Hub 实例的外部 URL。
  5. Create
  6. 选择 Secrets 视图。
  7. Create Key/value Secret
  8. 创建名为 secrets-rhdh 的 secret。
  9. 添加名为 BACKEND_SECRET 的键,并将 base64 编码字符串作为值。为每个 Red Hat Developer Hub 实例使用唯一值。例如,您可以使用以下命令从终端生成密钥:

    node -p 'require("crypto").randomBytes(24).toString("base64")'
  10. Create
  11. 选择 Topology 视图。
  12. 点您要使用的 Red Hat Developer Hub 实例的 overflow 菜单,然后选择 Edit Backstage 来加载 Red Hat Developer Hub 实例的 YAML 视图。

    Operator 安装 2
  13. 在 CR 中,输入自定义应用程序配置配置映射的名称作为 spec.application.appConfig.configMaps 字段的值,并输入 secret 的名称作为 spec.application.extraEnvs.secrets 字段的值。例如:

    apiVersion: v1
    kind: ConfigMap
    metadata:
      name: example
    spec:
      application:
        appConfig:
          mountPath: /opt/app-root/src
          configMaps:
             - name: app-config-rhdh
        extraEnvs:
          secrets:
             - name: secrets-rhdh
        extraFiles:
          mountPath: /opt/app-root/src
        replicas: 1
        route:
          enabled: true
      database:
        enableLocalDb: true
  14. 点击 Save
  15. 返回到 Topology 视图,并等待 Red Hat Developer Hub pod 启动。
  16. Open URL 图标使用 Red Hat Developer Hub 平台以及配置更改。

其他资源

Red Hat logoGithubRedditYoutubeTwitter

学习

尝试、购买和销售

社区

关于红帽文档

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

让开源更具包容性

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

關於紅帽

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

© 2024 Red Hat, Inc.