Red Hat Summit Red Hat Summitサポートコンソール開発者トライアルの開始お問い合わせ

2.5. 必須設定

2.5.1. Ansible プラグイン設定の追加
リンクのコピー

  1. OpenShift Developer UI で、Helm developer-hub Actions Upgrade Yaml view に移動します。

  2. Helm チャート設定を更新して、Red Hat Developer Hub インスタンスに動的プラグインを追加します。YAML ファイルの plugins セクションで、有効にする動的プラグインを追加します。 

    global:
  ...
    plugins:
      - disabled: false
        integrity: <SHA512 Integrity key for ansible-plugin-backstage-rhaap-dynamic plugin>
        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 Integrity key for ansible-plugin-scaffolder-backend-module-backstage-rhaap-dynamic plugin>
        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 Integrity key for ansible-plugin-backstage-rhaap-backend-dynamic plugin>
        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
  3. パッケージ セクションで、プラグインファイル名の x.y.z を、Ansible プラグインの正しいバージョン番号に置き換えます。
  4. 各 Ansible プラグインの対応する .integrity ファイルの内容を使用して、インテグリティーの値を更新します。

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

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

検証

プラグインがインストールされたことを確認するには、install-dynamic-plugin コンテナーのログを開き、Ansible プラグインが Red Hat Developer Hub に表示されることを確認します。

  1. OpenShift Web コンソールで Red Hat Developer Hub アプリケーションの Developer パースペクティブを開きます。
  2. Topology ビューを選択します。
  3. Red Hat Developer Hub のデプロイメント Pod を選択して、情報ペインを開きます。
  4. 情報ペインの Resources タブを選択します。
  5. Pod セクションで、View logs をクリックして Pod details ページを開きます。
  6. Pod details ページで、Logs タブを選択します。
  7. コンテナーのドロップダウンリストから install-dynamic-plugins を選択して、コンテナーログを表示します。

  8. install-dynamic-plugin コンテナーログで、Ansible プラグインを検索します。

    ログから抜粋した次の例は、プラグインの 1 つが正常にインストールされたことを示しています。 

    => Successfully installed dynamic plugin http://plugin-registry-1:8080/ansible-plugin-backstage-rhaap-dynamic-1.1.0.tgz
    Copy to Clipboard Toggle word wrap

    次の画像は、Pod details ページのコンテナーログを示しています。バージョン番号とファイル名は異なる場合があります。

    install-dynamic-plugin のコンテナーログ
    View larger image
    install-dynamic-plugin のコンテナーログ

2.5.2. Ansible Development Tools サイドカーコンテナーの追加
リンクのコピー

プラグインがロードされたら、Red Hat Developer Hub Pod に Ansible Development Container (ansible-devtools-server) をサイドカーコンテナーとして追加します。

2.5.2.1. Red Hat Developer Hub Helm 設定へのプルシークレットの追加
リンクのコピー

前提条件

Ansible Development Container のダウンロードには、Red Hat カスタマーポータルアカウントおよび Red Hat Service Registry アカウントが必要です。

手順

  1. 必要に応じて、新しい Red Hat Registry Service アカウント を作成します。
  2. Account name 列の下にあるトークン名をクリックします。
  3. OpenShift Secret タブを選択し、指示に従ってプルシークレットを Red Hat Developer Hub OpenShift プロジェクトに追加します。

  4. 新しいシークレットを Red Hat Developer Hub の Helm 設定に追加し、<your-redhat-registry-pull-secret> を Red Hat Registry Service Account の Web サイトで生成したシークレットの名前に置き換えます。 

    upstream:
  backstage:
    ...
    image:
      ...
      pullSecrets:
        - <your-redhat-registry-pull-secret>
    ...
    Copy to Clipboard Toggle word wrap

詳細は、Red Hat Container Registry のドキュメント を参照してください。

2.5.2.2. Ansible Developer Tools コンテナーの追加
リンクのコピー

コンテナーを追加するには、Helm チャート設定を更新する必要があります。

手順

  1. OpenShift UI にログインします。
  2. Helm developer-hub Actions upgrade Yaml view に移動し、Helm チャートを開きます。

  3. YAML ファイルの 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
    ...
    Copy to Clipboard Toggle word wrap
    注記

    イメージプルポリシーは imagePullPolicy: IfNotPresent です。イメージは、そのイメージがノード上にない場合にのみプルされます。常に最新のイメージを使用する場合は、imagePullPolicy: Always に更新してください。

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

検証

コンテナーが実行中であることを確認するには、コンテナーログを確認します。

コンテナーログの表示
View larger image
コンテナーログの表示

2.5.3. カスタム ConfigMap の追加
リンクのコピー

OpenShift Container Platform ノード ガイドの config map の作成および使用 セクションの手順に従って、Red Hat Developer Hub ConfigMap を作成します。次の例では、app-config-rhdh という名前のカスタム ConfigMap を使用します。

カスタム ConfigMap を編集するには、OpenShift UI にログインし、Select Project ( developerHubProj ) ConfigMaps {developer-hub}-app-config EditConfigMaps app-config-rhdh に移動します。

2.5.4. Ansible Dev Tools Server の設定
リンクのコピー

Ansible プラグインが提供されるソフトウェアテンプレートを使用して新しいプロジェクトをプロビジョニングするには、creatorService URL が必要です。

手順

  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

2.5.5. Ansible Automation Platform の詳細の設定
リンクのコピー

Ansible プラグインはトークンを使用して、コントローラー API で Ansible Automation Platform サブスクリプションステータスをクエリーします。

注記

Ansible プラグインは、Ansible Automation Platform のサブスクリプションステータスに関係なく引き続き機能します。

手順

  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
注記

Red Hat Developer Hub インストールは、ユーザー自身で外部および不正アクセスから保護する必要があります。バックエンド認証キーを他のシークレットと同様に管理します。強力なパスワード要件を満たし、パスワードを設定ファイルで公開せず、環境変数としてのみ設定ファイルに挿入します。

2.5.6. showCaseLocation の設定
リンクのコピー

カスタム config map で showCaseLocation を設定する必要があります。

手順

  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:
      rhaap:
      ...
        showCaseLocation:
          type: file
          target: '/tmp/aap-showcases/'
...
    Copy to Clipboard Toggle word wrap

2.5.7. Ansible プラグインソフトウェアテンプレートの追加
リンクのコピー

Red Hat Ansible は、Ansible のベストプラクティスに基づいて新しい Playbook とコレクションプロジェクトをプロビジョニングする Red Hat Developer Hub のソフトウェアテンプレートを提供します。

手順

  1. カスタム Red Hat Developer Hub config map (例: app-config-rhdh) を編集します。
  2. 以下のコードを Red Hat Developer Hub の app-config-rhdh.yaml ファイルに追加します。 
data:
  app-config-rhdh.yaml: |
    catalog:
      ...
      locations:
        ...
        - type: url
          target: https://github.com/ansible/ansible-rhdh-templates/blob/main/all.yaml
          rules:
            - allow: [Template]
Copy to Clipboard Toggle word wrap

詳細は、Red Hat Developer Hub の管理ガイド の テンプレートの管理 セクションを参照してください。

2.5.8. ロールベースアクセス制御の設定
リンクのコピー

Red Hat Developer Hub は、ロールベースアクセス制御 (RBAC) 機能を提供します。その後、RBAC を Ansible プラグインコンテンツに適用できます。

次のロールを割り当てます。

  • admin:superUsers グループのメンバーは、Ansible プラグインの Create タブでテンプレートを選択して、Playbook およびコレクションプロジェクトを作成できます。
  • admin:users グループのメンバーは、Ansible プラグインの Create タブでテンプレートを表示できます。

次の例では、Red Hat Developer Hub に RBAC を追加します。 

data:
  app-config-rhdh.yaml: |
    plugins:
    ...
    permission:
      enabled: true
      rbac:
        admin:
          users:
            - name: user:default/<user-scm-ida>
          superUsers:
            - name: user:default/<user-admin-idb>
Copy to Clipboard Toggle word wrap

権限ポリシーと RBAC の管理の詳細は、Red Hat Developer Hub の 認可 ガイドを参照してください。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat