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

手順

1. 次のコマンドを使用して GKE クラスターに接続します。

   gcloud container clusters get-credentials <cluster-name> \ 

   1

   
       --location=<cluster-location> 

   2

   1

   GKE クラスター名を入力します。

   2

   GKE クラスターの場所を入力します。

   このコマンドは、Kubernetes クライアントが GKE クラスターを指定するように設定します。

2. ターミナルで次のコマンドを実行して、Operator がインストールされている rhdh-operator namespace を作成します。

   kubectl create namespace rhdh-operator

3. 次のコマンドを使用してプルシークレットを作成します。

   kubectl -n rhdh-operator create secret docker-registry rhdh-pull-secret \
       --docker-server=registry.redhat.io \
       --docker-username=<user_name> \ 

   1

   
       --docker-password=<password> \ 

   2

   
       --docker-email=<email> 

   3

   1

   コマンドにユーザー名を入力します。

   2

   コマンドにパスワードを入力します。

   3

   コマンドにメールアドレスを入力します。

   作成されたプルシークレットは、Red Hat Ecosystem から Developer Hub イメージをプルするために使用されます。

4. Red Hat Ecosystem の Operator を含む CatalogSource リソースを作成します。

   CatalogSource リソースの例

   cat <<EOF | kubectl -n rhdh-operator apply -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: CatalogSource
   metadata:
     name: redhat-catalog
   spec:
     sourceType: grpc
     image: registry.redhat.io/redhat/redhat-operator-index:v4.17
     secrets:
     - "rhdh-pull-secret"
     displayName: Red Hat Operators
   EOF

5. 次のように OperatorGroup リソースを作成します。

   OperatorGroup リソースの例

   cat <<EOF | kubectl apply -n rhdh-operator -f -
   apiVersion: operators.coreos.com/v1
   kind: OperatorGroup
   metadata:
     name: rhdh-operator-group
   EOF

6. 次のコードを使用して Subscription リソースを作成します。

   Subscription リソースの例

   cat <<EOF | kubectl apply -n rhdh-operator -f -
   apiVersion: operators.coreos.com/v1alpha1
   kind: Subscription
   metadata:
     name: rhdh
     namespace: rhdh-operator
   spec:
     channel: fast
     installPlanApproval: Automatic
     name: rhdh
     source: redhat-catalog
     sourceNamespace: rhdh-operator
     startingCSV: rhdh-operator.v1.4.3
   EOF

7. 次のコマンドを実行して、作成した Operator が実行されていることを確認します。

   kubectl -n rhdh-operator get pods -w

   Operator Pod に ImagePullBackOff ステータスが表示される場合は、Operator デプロイメントのマニフェスト内でイメージを直接プルする権限が必要になる可能性があります。

   ヒント

   必要なシークレット名を deployment.spec.template.spec.imagePullSecrets リストに含め、kubectl get deployment -n rhdh-operator コマンドを使用してデプロイメント名を確認できます。以下に例を示します。

   kubectl -n rhdh-operator patch deployment \
       rhdh.fast --patch '{"spec":{"template":{"spec":{"imagePullSecrets":[{"name":"rhdh-pull-secret"}]}}}}' \
       --type=merge

8. 次の手順に従って Operator のデフォルト設定を更新し、Developer Hub リソースが GKE で正しく起動できるようにします。

   1. 次のコマンドを使用して、rhdh-operator namespace の backstage-default-config ConfigMap を編集します。

      kubectl -n rhdh-operator edit configmap backstage-default-config

   2. 次の例に示すように、db-statefulset.yaml 文字列を見つけて、その spec.template.spec.securityContext に fsGroup を追加します。

      db-statefulset.yaml フラグメント

        db-statefulset.yaml: |
          apiVersion: apps/v1
          kind: StatefulSet
      --- TRUNCATED ---
          spec:
          --- TRUNCATED ---
            restartPolicy: Always
            securityContext:
            # You can assign any random value as fsGroup
              fsGroup: 2000
            serviceAccount: default
            serviceAccountName: default
      --- TRUNCATED ---

   3. 次の例に示すように、deployment.yaml 文字列を見つけて、その仕様に fsGroup を追加します。

      deployment.yaml フラグメント

        deployment.yaml: |
          apiVersion: apps/v1
          kind: Deployment
      --- TRUNCATED ---
          spec:
            securityContext:
              # You can assign any random value as fsGroup
              fsGroup: 3000
            automountServiceAccountToken: false
      --- TRUNCATED ---

   4. 次のように、service.yaml 文字列を見つけて、type を NodePort に変更します。

      service.yaml フラグメント

        service.yaml: |
          apiVersion: v1
          kind: Service
          spec:
           # NodePort is required for the ALB to route to the Service
            type: NodePort
      --- TRUNCATED ---

   5. 保存して終了します。

      変更が Operator Pod に自動的に適用されるまで待ちます。