Ansible plug-ins for Red Hat Developer Hub のインストール

1. Red Hat Ansible Automation Platform 製品ソフトウェアのダウンロードページ から、プラグインの最新の .tar ファイルをダウンロードします。ファイル名の形式は ansible-backstage-rhaap-bundle-x.y.z.tar.gz です。Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

2. .tar ファイルを保存するディレクトリーをローカルマシンに作成します。

   $ mkdir /path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

3. ディレクトリーパスを表す環境変数 ($DYNAMIC_PLUGIN_ROOT_DIR) を設定します。

   $ export DYNAMIC_PLUGIN_ROOT_DIR=/path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

4. ansible-backstage-rhaap-bundle-<version-number>.tar.gz の内容を $DYNAMIC_PLUGIN_ROOT_DIR に展開します。

   $ tar --exclude='*code*' -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR

   Copy to Clipboard Toggle word wrap

   Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

手順

1. 認証情報を使用して OpenShift Container Platform インスタンスにログインし、新しいアプリケーションを作成します。

2. Red Hat Developer Hub OpenShift プロジェクトを開きます。

   $ oc project <YOUR_DEVELOPER_HUB_PROJECT>

   Copy to Clipboard Toggle word wrap

3. 以下のコマンドを実行して、OpenShift クラスターにプラグインレジストリービルドを作成します。

   $ oc new-build httpd --name=plugin-registry --binary
   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait
   $ oc new-app --image-stream=plugin-registry

   Copy to Clipboard Toggle word wrap

1. プラグインレジストリーをクリックしてログを表示します。

   

   View larger image

   

   (1) Developer Hub インスタンス

   (2) プラグインレジストリー

2. ターミナルのタブをクリックし、コンテナーにログインします。

3. ターミナルで ls を実行して、.tar ファイルがプラグインレジストリーにあることを確認します。

   ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz
   ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
   ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz

   Copy to Clipboard Toggle word wrap

   バージョン番号とファイル名は異なる場合があります。

1. OpenShift コンソールで、Topology ビューを選択します。
2. developer-hub のインスタンスで、More actions ⋮ をクリックし、Edit backstage を選択して、Backstage details ページを開きます。
3. YAML タブを選択します。

4. 編集ペインで、spec.deployment.patch.spec.template.spec ブロックに containers ブロックを追加します。

   apiVersion: rhdh.redhat.com/v1alpha3
   kind: Backstage
   metadata:
     name: developer-hub
   spec:
     deployment:
       patch:
         spec:
           template:
             spec:
               containers:
                 - command:
                     - adt
                     - server
                   image: registry.redhat.io/ansible-automation-platform-25/ansible-dev-tools-rhel8:latest
                   imagePullPolicy: always
                   ports:
                     - containerPort: 8000
                       protocol: TCP
                   terminationMessagePolicy: file

   Copy to Clipboard Toggle word wrap
5. Save をクリックします。

1. Red Hat Ansible Automation Platform 製品ソフトウェアのダウンロードページ から、プラグインの最新の .tar ファイルをダウンロードします。ファイル名の形式は ansible-backstage-rhaap-bundle-x.y.z.tar.gz です。Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

2. .tar ファイルを保存するディレクトリーをローカルマシンに作成します。

   $ mkdir /path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

3. ディレクトリーパスを表す環境変数 ($DYNAMIC_PLUGIN_ROOT_DIR) を設定します。

   $ export DYNAMIC_PLUGIN_ROOT_DIR=/path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

4. ansible-backstage-rhaap-bundle-<version-number>.tar.gz の内容を $DYNAMIC_PLUGIN_ROOT_DIR に展開します。

   $ tar --exclude='*code*' -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR

   Copy to Clipboard Toggle word wrap

   Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

手順

1. 認証情報を使用して OpenShift Container Platform インスタンスにログインし、新しいアプリケーションを作成します。

2. Red Hat Developer Hub OpenShift プロジェクトを開きます。

   $ oc project <YOUR_DEVELOPER_HUB_PROJECT>

   Copy to Clipboard Toggle word wrap

3. 以下のコマンドを実行して、OpenShift クラスターにプラグインレジストリービルドを作成します。

   $ oc new-build httpd --name=plugin-registry --binary
   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait
   $ oc new-app --image-stream=plugin-registry

   Copy to Clipboard Toggle word wrap

1. プラグインレジストリーをクリックしてログを表示します。

   

   View larger image

   

   (1) Developer Hub インスタンス

   (2) プラグインレジストリー

2. ターミナルのタブをクリックし、コンテナーにログインします。

3. ターミナルで ls を実行して、.tar ファイルがプラグインレジストリーにあることを確認します。

   ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz
   ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
   ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz

   Copy to Clipboard Toggle word wrap

   バージョン番号とファイル名は異なる場合があります。

手順

1. OpenShift コンソールのナビゲーションペインで ConfigMaps を選択します。
2. リストから rhaap-dynamic-plugins-config ConfigMap を選択します。
3. YAML タブを選択して、rhaap-dynamic-plugins-config ConfigMap を編集します。

4. data.dynamic-plugins.yaml.plugins ブロックに、プラグインレジストリーからの 3 つの動的プラグインを追加します。

   • integrity のハッシュ値には、各プラグインに対応する $DYNAMIC_PLUGIN_ROOT_DIR ディレクトリー内の .integrity ファイルを使用します。たとえば、ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz プラグインの場合は、ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz.integrity を使用します。

   • xyz は、プラグインの正しいバージョンに置き換えます。

     kind: ConfigMap
     apiVersion: v1
     metadata:
      name: rhaap-dynamic-plugins-config
     data:
      dynamic-plugins.yaml: |
        ...
        plugins:
          - disabled: false
            package: 'http://plugin-registry:8080/ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz'
            integrity: <SHA512 value> # Use hash in ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz.integrity
            pluginConfig:
              dynamicPlugins:
                frontend:
                  ansible.plugin-backstage-rhaap:
                    appIcons:
                      - importName: AnsibleLogo
                        name: AnsibleLogo
                    dynamicRoutes:
                      - importName: AnsiblePage
                        menuItem:
                          icon: AnsibleLogo
                          text: Ansible
                        path: /ansible
          - disabled: false
            package: >-
              http://plugin-registry:8080/ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
            integrity: <SHA512 value> # Use hash in ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz.integrity
            pluginConfig:
              dynamicPlugins:
                backend:
                  ansible.plugin-backstage-rhaap-backend: null
          - disabled: false
            package: >-
              http://plugin-registry:8080/ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
            integrity: <SHA512 value> # Use hash in ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz.integrity
            pluginConfig:
              dynamicPlugins:
                backend:
                  ansible.plugin-scaffolder-backend-module-backstage-rhaap: null
          - ...<REDACTED>

     Copy to Clipboard Toggle word wrap
5. Save をクリックします。

6. ローリング再起動の進捗を表示するには、次の手順を実行します。

   1. Topology ビューで、デプロイメント Pod を選択し、View logs をクリックします。
   2. コンテナーのリストから install-dynamic-plugins を選択します。

検証

1. OpenShift コンソールで、Topology ビューを選択します。
2. デプロイメント Pod の Open URL アイコンをクリックして、ブラウザーウィンドウで Red Hat Developer Hub インスタンスを開きます。

手順

1. カスタム ConfigMap の追加 で作成したカスタム Red Hat Developer Hub の config map app-config-rhdh を編集します。

2. 以下のコードを Red Hat Developer Hub の app-config-rhdh.yaml ファイルに追加します。

   kind: ConfigMap
   apiVersion: v1
   metadata:
     name: app-config-rhdh
   ...
   data:
     app-config-rhdh.yaml: |-
       ansible:
         creatorService:
           baseUrl: 127.0.0.1
           port: '8000'
   ...

   Copy to Clipboard Toggle word wrap

手順

1. Automation Controller ユーザーガイド の アプリケーション セクションに従って、Automation Controller で「読み取り」スコープを持つ Personal Access Token (PAT) を作成します。
2. カスタム Red Hat Developer Hub config map (例: app-config-rhdh) を編集します。

3. Ansible Automation Platform の詳細を app-config-rhdh.yaml に追加します。

   1. Automation Controller URL で baseURL キーを設定します。
   2. 手順 1 で作成したトークン値を使用して token キーを設定します。

   3. checkSSL キーを true または false に設定します。

      checkSSL が true に設定されている場合、Ansible プラグインは SSL 証明書が有効であるかどうかを確認します。

      data:
        app-config-rhdh.yaml: |
          ...
          ansible:
          ...
            rhaap:
              baseUrl: '<https://MyControllerUrl>'
              token: '<AAP Personal Access Token>'
              checkSSL: true

      Copy to Clipboard Toggle word wrap

手順

1. カスタム Red Hat Developer Hub config map (例: app-config-rhdh) を編集します。
2. 以下のコードを Red Hat Developer Hub の app-config-rhdh.yaml ファイルに追加します。

1. Ansible Automation Platform に到達可能で、ConfigMap の rhaap セクションで正しく設定されていることを確認します。
2. ご使用の環境に対して checkSSL キーが正しく設定されていることを確認します。
3. 設定の詳細を修正したら、Red Hat Developer Hub Pod を再起動してサブスクリプションクエリーを開始します。

1. Ansible プラグインで設定された Automation Controller の Personal Access Token (PAT) が正しいことを確認します。詳細は、Automation Controller ユーザーガイド の アプリケーション セクションを参照してください。
2. 認証情報の修正後に、Red Hat Developer Hub Pod を再起動してサブスクリプションクエリーを開始します。

1. Ansible プラグイン ConfigMap の rhaap セクションが正しく設定されており、必要なすべてのエントリーが含まれていることを確認します。詳細は、Ansible Automation Platform の詳細の設定 を参照してください。
2. 設定の修正後に、Red Hat Developer Hub Pod を再起動してサブスクリプションクエリーを開始します。

1. 新しいサブスクリプションエンタイトルメントを取得するには、Red Hat Account チームにお問い合わせください。
2. アカウントコンプライアンス の詳細を確認してください。
3. サブスクリプションがコンプライアンスに準拠している場合は、Red Hat Developer Hub Pod を再起動して、新しいサブスクリプションクエリーを開始します。

1. 新しいサブスクリプションエンタイトルメントを取得するか、Ansible Automation Platform のトライアルを開始する には、Red Hat Account チームにお問い合わせください。
2. サブスクリプションを更新したら、Red Hat Developer Hub Pod を再起動して、新しいサブスクリプションクエリーを開始します。

1. Red Hat Ansible Automation Platform 製品ソフトウェアのダウンロードページ から、プラグインの最新の .tar ファイルをダウンロードします。ファイル名の形式は ansible-backstage-rhaap-bundle-x.y.z.tar.gz です。Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

2. .tar ファイルを保存するディレクトリーをローカルマシンに作成します。

   $ mkdir /path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

3. ディレクトリーパスを表す環境変数 ($DYNAMIC_PLUGIN_ROOT_DIR) を設定します。

   $ export DYNAMIC_PLUGIN_ROOT_DIR=/path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

4. ansible-backstage-rhaap-bundle-<version-number>.tar.gz の内容を $DYNAMIC_PLUGIN_ROOT_DIR に展開します。

   $ tar --exclude='*code*' -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR

   Copy to Clipboard Toggle word wrap

   Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

手順

1. 認証情報を使用して OpenShift Container Platform インスタンスにログインし、新しいアプリケーションを作成します。

2. Red Hat Developer Hub OpenShift プロジェクトを開きます。

   $ oc project <YOUR_DEVELOPER_HUB_PROJECT>

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、OpenShift クラスターのプラグインレジストリービルドを更新します。このコマンドは、$DYNAMIC_PLUGIN_ROOT_DIR が .tar ファイルのディレクトリーを表すことを前提としています。別の環境変数名を選択した場合は、コマンド内の環境変数名を置き換えてください。

   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait

   Copy to Clipboard Toggle word wrap

   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait

   Copy to Clipboard Toggle word wrap

4. レジストリーが起動すると、出力に次のメッセージが表示されます。

   Uploading directory "/path/to/dynamic_plugin_root" as binary input for the build …
   Uploading finished
   build.build.openshift.io/plugin-registry-1 started

   Copy to Clipboard Toggle word wrap

1. OpenShift UI で、Topology をクリックします。
2. redhat-developer-hub アイコンをクリックして、プラグインレジストリーの Pod を表示します。
3. プラグインレジストリー Pod の View logs をクリックします。
4. Terminal タブを開き、ls を実行して plug-in registry 内の .tar ファイルを表示します。
5. 新しい .tar ファイルがアップロードされていることを確認します。

手順

1. OpenShift Container Platform インスタンスにログインします。
2. OpenShift Developer UI で、Helm → developer-hub → Actions → Upgrade → Yaml view に移動します。

3. Ansible プラグインのバージョン番号と関連する .integrity ファイル値を更新します。

   ...
   global:
   ...
       plugins:
         - disabled: false
           integrity: <SHA512 value>
           package: 'http://plugin-registry:8080/ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz'
           pluginConfig:
             dynamicPlugins:
               frontend:
                 ansible.plugin-backstage-rhaap:
                   appIcons:
                     - importName: AnsibleLogo
                       name: AnsibleLogo
                   dynamicRoutes:
                     - importName: AnsiblePage
                       menuItem:
                         icon: AnsibleLogo
                         text: Ansible
                       path: /ansible
         - disabled: false
           integrity: <SHA512 value>
           package: >-
             http://plugin-registry:8080/ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
           pluginConfig:
             dynamicPlugins:
               backend:
                 ansible.plugin-scaffolder-backend-module-backstage-rhaap: null
         - disabled: false
           integrity: <SHA512 value>
           package: >-
             http://plugin-registry:8080/ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
           pluginConfig:
             dynamicPlugins:
               backend:
                 ansible.plugin-backstage-rhaap-backend: null

   Copy to Clipboard Toggle word wrap

4. Upgrade をクリックします。

   開発者ハブ Pod が再起動し、プラグインがインストールされます。

検証

1. OpenShift UI で、Topology をクリックします。
2. Red Hat Developer Hub インスタンスが利用可能であることを確認します。

1. Red Hat Ansible Automation Platform 製品ソフトウェアのダウンロードページ から、プラグインの最新の .tar ファイルをダウンロードします。ファイル名の形式は ansible-backstage-rhaap-bundle-x.y.z.tar.gz です。Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

2. .tar ファイルを保存するディレクトリーをローカルマシンに作成します。

   $ mkdir /path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

3. ディレクトリーパスを表す環境変数 ($DYNAMIC_PLUGIN_ROOT_DIR) を設定します。

   $ export DYNAMIC_PLUGIN_ROOT_DIR=/path/to/<ansible-backstage-plugins-local-dir-changeme>

   Copy to Clipboard Toggle word wrap

4. ansible-backstage-rhaap-bundle-<version-number>.tar.gz の内容を $DYNAMIC_PLUGIN_ROOT_DIR に展開します。

   $ tar --exclude='*code*' -xzf ansible-backstage-rhaap-bundle-x.y.z.tar.gz -C $DYNAMIC_PLUGIN_ROOT_DIR

   Copy to Clipboard Toggle word wrap

   Ansible プラグインリリースバージョン (1.0.0 など) を、x.y.z に置き換えます。

手順

1. 認証情報を使用して OpenShift Container Platform インスタンスにログインし、新しいアプリケーションを作成します。

2. Red Hat Developer Hub OpenShift プロジェクトを開きます。

   $ oc project <YOUR_DEVELOPER_HUB_PROJECT>

   Copy to Clipboard Toggle word wrap

3. 次のコマンドを実行して、OpenShift クラスターのプラグインレジストリービルドを更新します。このコマンドは、$DYNAMIC_PLUGIN_ROOT_DIR が .tar ファイルのディレクトリーを表すことを前提としています。別の環境変数名を選択した場合は、コマンド内の環境変数名を置き換えてください。

   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait

   Copy to Clipboard Toggle word wrap

   $ oc start-build plugin-registry --from-dir=$DYNAMIC_PLUGIN_ROOT_DIR --wait

   Copy to Clipboard Toggle word wrap

4. レジストリーが起動すると、出力に次のメッセージが表示されます。

   Uploading directory "/path/to/dynamic_plugin_root" as binary input for the build …
   Uploading finished
   build.build.openshift.io/plugin-registry-1 started

   Copy to Clipboard Toggle word wrap

1. OpenShift UI で、Topology をクリックします。
2. redhat-developer-hub アイコンをクリックして、プラグインレジストリーの Pod を表示します。
3. プラグインレジストリー Pod の View logs をクリックします。
4. Terminal タブを開き、ls を実行して plug-in registry 内の .tar ファイルを表示します。
5. 新しい .tar ファイルがアップロードされていることを確認します。

手順

1. OpenShift Container Platform インスタンスにログインします。
2. OpenShift UI で、インストール時に Ansible プラグインを追加した ConfigMap を開きます。この例では、rhaap-dynamic-plugins-config という ConfigMap ファイルを使用します。
3. xyz を、更新された Ansible プラグインのバージョン番号で更新します。

4. 各プラグインの integrity 値を、対応する展開された Ansible プラグインの .tar ファイルの .integrity 値で更新します。

   kind: ConfigMap
   apiVersion: v1
   metadata:
    name: rhaap-dynamic-plugins-config
   data:
    dynamic-plugins.yaml: |
      ...
      plugins: # Update the Ansible plug-in entries below with the updated plugin versions
        - disabled: false
          package: 'http://plugin-registry:8080/ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz'
          integrity: <SHA512 value> # Use hash in ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz.integrity
   	 ...
        - disabled: false
          package: >-
            http://plugin-registry:8080/ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
          integrity: <SHA512 value> # Use hash in ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz.integrity
          ...
        - disabled: false
          package: >-
            http://plugin-registry:8080/ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
          integrity: <SHA512 value> # Use hash in ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz.integrity
   	 ...

   Copy to Clipboard Toggle word wrap

5. Save をクリックします。

   開発者ハブ Pod が再起動し、プラグインがインストールされます。

検証

1. OpenShift UI で、Topology をクリックします。
2. Red Hat Developer Hub インスタンスが利用可能であることを確認します。

手順

1. Red Hat Developer Hub で、ansible:content:create アクションを使用するソフトウェアテンプレートを削除します。
2. OpenShift Developer UI で、Helm → developer-hub → Actions → Upgrade → Yaml view に移動します。

3. plugins セクションで Ansible プラグイン設定を削除します。

   ...
   global:
   ...
       plugins:
         - disabled: false
           integrity: <SHA512 value>
           package: 'http://plugin-registry:8080/ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz'
           pluginConfig:
             dynamicPlugins:
               frontend:
                 ansible.plugin-backstage-rhaap:
                   appIcons:
                     - importName: AnsibleLogo
                       name: AnsibleLogo
                   dynamicRoutes:
                     - importName: AnsiblePage
                       menuItem:
                         icon: AnsibleLogo
                         text: Ansible
                       path: /ansible
         - disabled: false
           integrity: <SHA512 value>
           package: >-
             http://plugin-registry:8080/ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
           pluginConfig:
             dynamicPlugins:
               backend:
                 ansible.plugin-scaffolder-backend-module-backstage-rhaap: null
         - disabled: false
           integrity: <SHA512 value>
           package: >-
             http://plugin-registry:8080/ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
           pluginConfig:
             dynamicPlugins:
               backend:
                 ansible.plugin-backstage-rhaap-backend: null

   Copy to Clipboard Toggle word wrap

4. extraContainers セクションを削除します。

   upstream:
     backstage: |
       ...
       extraContainers:
         - command:
             - adt
             - server
           image: >-
             registry.redhat.io/ansible-automation-platform-25/ansible-dev-tools-rhel8:latest
           imagePullPolicy: IfNotPresent
           name: ansible-devtools-server
           ports:
             - containerPort: 8000
       image:
         pullPolicy: Always
         pullSecrets:
           - ...
           - rhdh-secret-registry
       ...

   Copy to Clipboard Toggle word wrap
5. Upgrade をクリックします。
6. カスタム Red Hat Developer Hub config map (例: app-config-rhdh) を編集します。

7. ansible セクションを削除します。

   data:
     app-config-rhdh.yaml: |
       ...
       ansible:
         analytics:
           enabled: true
         devSpaces:
           baseUrl: '<https://MyOwnDevSpacesUrl/>'
         creatorService:
           baseUrl: '127.0.0.1'
           port: '8000'
         rhaap:
           baseUrl: '<https://MyAapSubcriptionUrl>'
           token: '<TopSecretAAPToken>'
           checkSSL: true
         automationHub:
           baseUrl: '<https://MyOwnPAHUrl/>'

   Copy to Clipboard Toggle word wrap
8. Red Hat Developer Hub のデプロイメントを再起動します。

9. plugin-registry OpenShift アプリケーションを削除します。

   oc delete all -l app=plugin-registry

   Copy to Clipboard Toggle word wrap

手順

1. Ansible プラグインを参照するカスタム ConfigMap を開きます。この例では、ConfigMap 名は rhaap-dynamic-plugins-config です。

2. plugins: ブロックで動的プラグインを見つけます。

   • プラグインを無効にするには、3 つのプラグインの disabled 属性を true に更新します。

   • プラグインを削除するには、plugins: ブロックからプラグインを参照する行を削除します。

     kind: ConfigMap
     apiVersion: v1
     metadata:
      name: rhaap-dynamic-plugins-config
     data:
      dynamic-plugins.yaml: |
        ...
        plugins: # Remove the Ansible plug-ins entries below the ‘plugins’ YAML key
          - disabled: false
            package: 'http://plugin-registry:8080/ansible-plugin-backstage-rhaap-dynamic-x.y.z.tgz'
            integrity: <SHA512 value>
     	 ...
          - disabled: false
            package: >-
              http://plugin-registry:8080/ansible-plugin-backstage-rhaap-backend-dynamic-x.y.z.tgz
            integrity: <SHA512 value>
            ...
          - disabled: false
            package: >-
              http://plugin-registry:8080/ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic-x.y.z.tgz
            integrity: <SHA512 value>
     	 ...

     Copy to Clipboard Toggle word wrap
3. Save をクリックします。

手順

1. テンプレートの設定と Ansible Automation Platform および Dev Spaces への接続設定を追加した Red Hat Developer Hub のカスタム ConfigMap を開きます。この例では、Red Hat Developer Hub の ConfigMap 名は app-config-rhdh です。

   kind: ConfigMap
   apiVersion: v1
   metadata:
    name: rhdh-app-config
   data:
    app-config-custom.yaml: |
      ...
      catalog:
        ...
        locations: # Remove the YAML entry below the 'locations' YAML key
          - type: url
            target: https://github.com/ansible/ansible-rhdh-templates/blob/main/all.yaml
            rules:
              - allow: [Template]
        ...
      # Remove the entire 'ansible' YAML key and all sub-entries
      ansible:
        devSpaces:
          baseUrl: '<https://YOUR_DEV_SPACES_URL>'
        creatorService:
          baseUrl: '127.0.0.1'
          port: '8000'
        rhaap:
          baseUrl: '<https://YOUR_AAP_URL>'
          token: <REDACTED>
          checkSSL: false

   Copy to Clipboard Toggle word wrap
2. locations: ブロック内の URL を削除して、RHDH インスタンスからテンプレートを削除します。
3. ansible: ブロックを削除して、Ansible 固有の設定を削除します。
4. Save をクリックします。

手順

1. OpenShift コンソールで、Topology ビューを選択します。
2. developer-hub のインスタンスで、More actions ⋮ をクリックし、Edit backstage を選択してベース ConfigMap を編集します。
3. YAML タブを選択します。

4. 編集ペインで、spec.deployment.patch.spec.template.spec ブロックからサイドカーコンテナーの containers ブロックを削除します。

   ...
   spec:
     deployment:
       patch:
         spec:
           template:
             spec:
               containers:
                 - command:
                     - adt
                     - server
                   image: ghcr.io/ansible/community-ansible-dev-tools:latest
                   imagePullPolicy: always
                   ports:
                     - containerPort: 8000
                       protocol: TCP
                   terminationMessagePolicy: file

   Copy to Clipboard Toggle word wrap
5. Save をクリックします。