第 1 章 使用 OLM 框架安装 Developer Hub Operator

流程

1. 使用以下模板创建一个包含 app-config.yaml Developer Hub 配置文件的 app-config.yaml 配置映射：

   app-config.yaml 片段

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

   Copy to Clipboard

2. 创建一个 & lt;my_product_secrets > secret，并添加名为 BACKEND_SECRET 的键，并带有 Base64 编码的字符串 值，如下例所示：

   apiVersion: v1
   kind: Secret
   metadata:
     name: <my_product_secrets> 

   1

   
   stringData:
     # TODO: See https://backstage.io/docs/auth/service-to-service-auth/#setup
     BACKEND_SECRET: "xxx"

   Copy to Clipboard

   1

   <my_product_secrets > 是您首选的 Developer Hub secret 名称，其中 < my_product_secrets > 指定 Developer Hub 中 secret 配置的标识符。

   重要

   确保为每个 Developer Hub 实例使用唯一的 BACKEND_SECRET 值。

   您可以使用以下命令生成密钥：

   node-p'require("crypto").randomBytes(24).toString("base64")'

   Copy to Clipboard

3. 要启用从 Red Hat Ecosystem Catalog 拉取 PostgreSQL 镜像，请在部署 Developer Hub 实例的命名空间中的 default 服务帐户中添加镜像 pull secret：

   kubectl patch serviceaccount default \
       -p '{"imagePullSecrets": [{"name": "rhdh-pull-secret"}]}' \
       -n <your_namespace>

   Copy to Clipboard

4. 使用以下模板创建 Backstage 自定义资源(CR)文件：

   自定义资源片段

   apiVersion: rhdh.redhat.com/v1alpha3
   kind: Backstage
   metadata:
     # This is the name of your Developer Hub instance
     name: my-rhdh
   spec:
     application:
       imagePullSecrets:
       - "rhdh-pull-secret"
       route:
         enabled: false
       appConfig:
         configMaps:
           - name: my-rhdh-app-config
       extraEnvs:
         secrets:
           - name: <my_product_secrets> 

   1

   Copy to Clipboard

   1

   <my_product_secrets > 是您首选的 Developer Hub secret 名称，其中 < my_product_secrets > 指定 Developer Hub 中 secret 配置的标识符。

5. 通过创建一个 ManagedCertificate 对象来设置 Google 管理的证书，您必须附加到 Ingress，如下例所示：

   apiVersion: networking.gke.io/v1
   kind: ManagedCertificate
   metadata:
     name: <rhdh_certificate_name>
   spec:
     domains:
       - <rhdh_domain_name>

   Copy to Clipboard

   有关设置 Google 管理的证书的更多信息，请参阅设置 Google 管理的证书。

6. 创建 FrontendConfig 对象，来为重定向到 HTTPS 设置策略。您必须将此策略附加到 Ingress。

   FrontendConfig 对象示例

   apiVersion: networking.gke.io/v1beta1
   kind: FrontendConfig
   metadata:
     name: <ingress_security_config>
   spec:
     sslPolicy: gke-ingress-ssl-policy-https
     redirectToHttps:
       enabled: true

   Copy to Clipboard

   有关将策略设置为重定向到 HTTPS 的更多信息，请参阅 HTTP 到 HTTPS 重定向。

7. 使用以下模板创建入口资源，根据需要自定义名称：

   ingress 资源配置示例

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     # TODO: this the name of your Developer Hub Ingress
     name: my-rhdh
     annotations:
       # If the class annotation is not specified it defaults to "gce".
       kubernetes.io/ingress.class: "gce"
       kubernetes.io/ingress.global-static-ip-name: <ADDRESS_NAME>
       networking.gke.io/managed-certificates: <rhdh_certificate_name>
       networking.gke.io/v1beta1.FrontendConfig: <ingress_security_config>
   spec:
     ingressClassName: gce
     rules:
       # TODO: Set your application domain name.
       - host: <rhdh_domain_name>
         http:
           paths:
           - path: /
             pathType: Prefix
             backend:
               service:
                 # TODO: my-rhdh is the name of your `Backstage` custom resource.
                 # Adjust if you changed it!
                 name: backstage-my-rhdh
                 port:
                   name: http-backend

   Copy to Clipboard