第4章 Red Hat Developer Hub と Microsoft Azure Kubernetes Service (AKS) の統合

手順

1. ターミナルを開き、次のコマンドを実行して Helm チャートリポジトリーを追加します。

   helm repo add openshift-helm-charts https://charts.openshift.io/

   Copy to Clipboard Toggle word wrap

2. ImagePull Secret を作成するには、次のコマンドを実行します。

   kubectl -n <your_namespace> create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<redhat_user_name> \
       --docker-password=<redhat_password> \
       --docker-email=<email>

   Copy to Clipboard Toggle word wrap

3. 次のテンプレートを使用して、values.yaml という名前のファイルを作成します。

   global:
     host: <app_address>
   route:
     enabled: false
   upstream:
     ingress:
       enabled: true
       className: webapprouting.kubernetes.azure.com
       host:
     backstage:
       image:
         pullSecrets:
           - rhdh-pull-secret
       podSecurityContext:
         fsGroup: 3000
     postgresql:
       image:
         pullSecrets:
           - rhdh-pull-secret
       primary:
         podSecurityContext:
           enabled: true
           fsGroup: 3000
     volumePermissions:
       enabled: true

   Copy to Clipboard Toggle word wrap

4. Helm Chart をインストールするには、次のコマンドを実行します。

   helm -n <your_namespace> install -f values.yaml <your_deploy_name> openshift-helm-charts/redhat-developer-hub --version 1.1.1

   Copy to Clipboard Toggle word wrap

5. デプロイメントのステータスを確認します。

   kubectl get deploy <your_deploy_name>-developer-hub -n <your_namespace>

   Copy to Clipboard Toggle word wrap
6. URL: https://<app_address> を使用して、デプロイした Developer Hub にアクセスします。ここで、<app_address> は、前に取得した Ingress アドレス (たとえば、https://108.141.70.228) です。

7. デプロイメントをアップグレードまたは削除するには、次のコマンドを実行します。

   アップグレードコマンド

   helm -n <your_namespace> upgrade -f values.yaml <your_deploy_name> openshift-helm-charts/redhat-developer-hub --version 1.1.1

   Copy to Clipboard Toggle word wrap

   削除コマンド

   helm -n <your_namespace> delete <your_deploy_name>

   Copy to Clipboard Toggle word wrap

手順

1. rhdh-operator-<VERSION>.yaml という名前の Red Hat Developer Hub Operator マニフェストファイルを取得し、次のフラグメントを追加して db-statefulset.yaml と deployment.yaml のデフォルト設定を変更します。

   securityContext:
     fsGroup: 300

   Copy to Clipboard Toggle word wrap

   マニフェストで指定された場所は次のとおりです。

   db-statefulset.yaml: | spec.template.spec
   deployment.yaml: | spec.template.spec

   Copy to Clipboard Toggle word wrap

2. 変更した Operator マニフェストを Kubernetes クラスターに適用します。

   kubectl apply -f rhdh-operator-<VERSION>.yaml

   Copy to Clipboard Toggle word wrap
   注記

   前のコマンドの実行はクラスター範囲であり、適切なクラスター権限が必要です。

3. 次の例に示すように、Red Hat 認証情報を使用して rhdh-pull-secret という名前の ImagePull Secret を作成し、保護された registry.redhat.io からイメージにアクセスします。

   kubectl -n <your_namespace> create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<redhat_user_name> \
       --docker-password=<redhat_password> \
       --docker-email=<email>

   Copy to Clipboard Toggle word wrap

4. rhdh-ingress.yaml という名前の Ingress マニフェストファイルを作成し、次のように Developer Hub サービス名を指定します。

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: rhdh-ingress
     namespace: <your_namespace>
   spec:
     ingressClassName: webapprouting.kubernetes.azure.com
     rules:
       - http:
           paths:
             - path: /
               pathType: Prefix
               backend:
                 service:
                   name: backstage-<your-CR-name>
                   port:
                     name: http-backend

   Copy to Clipboard Toggle word wrap

5. 作成した Ingress をデプロイするには、次のコマンドを実行します。

   kubectl -n <your_namespace> apply -f rhdh-ingress.yaml

   Copy to Clipboard Toggle word wrap

6. 次の例を使用して、Developer Hub 設定を含む app-config-rhdh という名前の ConfigMap を作成します。

   apiVersion: v1
   kind: ConfigMap
   metadata:
     name: app-config-rhdh
   data:
     "app-config-rhdh.yaml": |
       app:
         title: Red Hat Developer Hub
         baseUrl: https://<app_address>
       backend:
         auth:
           keys:
             - secret: "${BACKEND_SECRET}"
         baseUrl: https://<app_address>
         cors:
           origin: https://<app_address>

   Copy to Clipboard Toggle word wrap

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

   apiVersion: v1
   kind: Secret
   metadata:
     name: secrets-rhdh
   stringData:
     BACKEND_SECRET: "xxx"

   Copy to Clipboard Toggle word wrap

8. rhdh.yaml という名前のカスタムリソース (CR) マニフェストファイルを作成し、次のように以前に作成した rhdh-pull-secret を追加します。

   apiVersion: rhdh.redhat.com/v1alpha1
   kind: Backstage
   metadata:
     name: <your-rhdh-cr>
   spec:
     application:
       imagePullSecrets:
         - rhdh-pull-secret
       appConfig:
         configMaps:
           - name: "app-config-rhdh"
       extraEnvs:
         secrets:
           - name: "secrets-rhdh"

   Copy to Clipboard Toggle word wrap

9. CR マニフェストを namespace に適用します。

   kubectl -n <your_namespace> apply -f rhdh.yaml

   Copy to Clipboard Toggle word wrap
10. URL: https://<app_address> を使用して、デプロイした Developer Hub にアクセスします。ここで、<app_address> は、前に取得した Ingress アドレス (たとえば、https://108.141.70.228) です。

11. オプション: CR を削除するには、次のコマンドを実行します。

    kubectl -n <your_namespace> delete -f rhdh.yaml

    Copy to Clipboard Toggle word wrap