Microsoft Azure Kubernetes Service への Red Hat Developer Hub のインストール

手順

1. 次の例に示すように、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

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

   apiVersion: networking.k8s.io/v1
   kind: Ingress
   metadata:
     name: rhdh-ingress
     namespace: my-rhdh-project
   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

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

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

   Copy to Clipboard

4. 次の例を使用して、Developer Hub 設定ファイル app-config.yaml を含む my-rhdh-app-config config map を作成します。

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

   Copy to Clipboard

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

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

   1

   
   stringData:
     BACKEND_SECRET: "xxx"

   Copy to Clipboard

   1

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

6. 次のように、<your-rhdh-cr> という名前の Backstage カスタムリソース (CR) マニフェストファイルを作成し、以前に作成した rhdh-pull-secret を含めます。

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

   1

   Copy to Clipboard

   1

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

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

   kubectl -n my-rhdh-project apply -f rhdh.yaml

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

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

   kubectl -n my-rhdh-project delete -f rhdh.yaml

   Copy to Clipboard

手順

1. 次のコマンドを実行して AKS にログインします。

   az login [--tenant=<optional_directory_name>]

   Copy to Clipboard

2. 次のコマンドを実行してリソースグループを作成します。

   az group create --name <resource_group_name> --location <location>

   Copy to Clipboard
   ヒント

   次のコマンドを実行すると、利用可能なリージョンをリスト表示できます。

   az account list-locations -o table

   Copy to Clipboard

3. 次のコマンドを実行して AKS クラスターを作成します。

   az aks create \
   --resource-group <resource_group_name> \
   --name <cluster_name> \
   --enable-managed-identity \
   --generate-ssh-keys

   Copy to Clipboard

   追加オプションは --help を参照してください。

4. 次のコマンドを実行してクラスターに接続します。

   az aks get-credentials --resource-group <resource_group_name> --name <cluster_name>

   Copy to Clipboard

   上記のコマンドは、Kubernetes クライアントを設定し、AKS クラスターを指すように kubeconfig の現在のコンテキストを設定します。

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

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

   Copy to Clipboard

6. <my-rhdh-project> namespace を作成してアクティブ化します。

   DEPLOYMENT_NAME=<redhat-developer-hub>
   NAMESPACE=<rhdh>
   kubectl create namespace ${NAMESPACE}
   kubectl config set-context --current --namespace=${NAMESPACE}

   Copy to Clipboard

7. 次のコマンドを実行して、Red Hat Ecosystem から Developer Hub イメージをプルするために使用するプルシークレットを作成します。

   kubectl -n $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

8. 次のテンプレートを使用して、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

9. 次のコマンドを実行して、Helm チャートを使用して Developer Hub をインストールします。

   helm -n $NAMESPACE install -f values.yaml $DEPLOYMENT_NAME openshift-helm-charts/redhat-developer-hub --version 1.5.3

   Copy to Clipboard

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

    kubectl get deploy $DEPLOYMENT_NAME -n $NAMESPACE

    Copy to Clipboard

11. クラスターの Developer Hub データベースパスワードとルーターベース URL の値を使用して、Developer Hub Helm チャートのインスタンスを設定します。

    PASSWORD=$(kubectl get secret redhat-developer-hub-postgresql -o jsonpath="{.data.password}" | base64 -d)
    CLUSTER_ROUTER_BASE=$(kubectl get route console -n openshift-console -o=jsonpath='{.spec.host}' | sed 's/^[^.]*\.//')
    helm upgrade $DEPLOYMENT_NAME -i "https://github.com/openshift-helm-charts/charts/releases/download/redhat-redhat-developer-hub-1.5.3/redhat-developer-hub-1.5.3.tgz" \
        --set global.clusterRouterBase="$CLUSTER_ROUTER_BASE" \
        --set global.postgresql.auth.password="$PASSWORD"

    Copy to Clipboard

12. 次のコマンドを実行して、実行中の Developer Hub インスタンスの URL を表示します。

    echo "https://$DEPLOYMENT_NAME-$NAMESPACE.$CLUSTER_ROUTER_BASE"

    Copy to Clipboard