第1章 OLM フレームワークを使用した Developer Hub Operator のインストール

手順

1. 次のテンプレートを使用して、app-config.yaml Developer Hub 設定ファイルを含む app-config.yaml config map を作成します。

   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 Toggle word wrap

2. 次の例に示すように、<my_product_secrets> シークレットを作成し、Base64-encoded 文字列値を持つ BACKEND_SECRET という名前のキーを追加します。

   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 Toggle word wrap

   1

   <my_product_secrets> は、任意の Developer Hub シークレット名です。<my_product_secrets> は、Developer Hub 内のシークレット設定の識別子を指定します。

   重要

   各 Developer Hub インスタンスには、必ず一意の値の BACKEND_SECRET を使用してください。

   次のコマンドを使用してキーを生成できます。

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

   Copy to Clipboard Toggle word wrap

3. Red Hat エコシステムカタログから PostgreSQL イメージをプルできるようにするには、Developer Hub インスタンスがデプロイされている namespace 内のデフォルトのサービスアカウントにイメージプルシークレットを追加します。

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

   Copy to Clipboard Toggle word wrap

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 Toggle word wrap

   1

   <my_product_secrets> は、任意の Developer Hub シークレット名です。<my_product_secrets> は、Developer Hub 内のシークレット設定の識別子を指定します。

5. 次の例に示すように、Ingress にアタッチする必要がある ManagedCertificate オブジェクトを作成して、Google マネージド証明書を設定します。

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

   Copy to Clipboard Toggle word wrap

   Google マネージド証明書の設定の詳細は、Setting up a Google-managed certificate を参照してください。

6. HTTPS にリダイレクトするためのポリシーを設定するには、FrontendConfig オブジェクトを作成します。このポリシーを 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 Toggle word wrap

   HTTPS にリダイレクトするポリシーの設定の詳細は、HTTP から HTTPS へのリダイレクト を参照してください。

7. 次のテンプレートを使用して Ingress リソースを作成し、必要に応じて名前をカスタマイズします。

   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 Toggle word wrap