Automation Hub での Red Hat 認定コレクションおよび Ansible Galaxy コレクションの管理

手順

1. console.redhat.com にログインします。
2. Automation Hub → Collections に移動します。
3. 各コレクションで切り替えスイッチを使用して、同期リストから除外するかどうかを判断します。
4. 同期リストのコレクションの管理が終了したら、Automation Hub → Repo Management に移動して、Private Automation Hub へのリモートリポジトリーの同期を開始します。
5. オプション: リモートリポジトリーがすでに設定されている場合は、Red Hat Ansible Certified Content Collections を Private Automation Hub に手動で同期して、ローカルユーザーが利用できるようにしたコレクションのコンテンツを更新できます。

手順

1. 組織管理者として console.redhat.com にログインします。
2. Automation Hub → Repo Management に移動します。
3. Sync URL を探して、Copy to clipboard アイコン ( ) をクリックします。rh-certified リモートの設定時に使用するファイルに Sync URL を貼り付けます。
4. More actions アイコン をクリックし、Get token をクリックします。
5. Token management ページで Load token をクリックします。
6. Copy to clipboard をクリックし、API トークンをコピーします。
7. API トークンをファイルに貼り付け、安全な場所に保存します。

手順

1. Private Automation Hub にログインします。
2. Repo Management に移動します。
3. Remotes タブをクリックします。
4. rh-certified リモートリポジトリーで をクリックし、Edit をクリックします。
5. モーダルで、console.redhat.com. から取得した 同期 URL およびトークンを貼り付けます。

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

   モーダルが閉じて、Repo Management ページに戻ります。console.redhat.com の組織の同期リストと Private Automation Hub の間でコレクションを同期できるようになりました。

7. Sync をクリックしてコレクションを同期します。

手順

1. Ansible Automation Hub にログインします。
2. Repo Management に移動します。
3. Remotes タブをクリックします。
4. Community リモートで、More Actions アイコン をクリックし、Edit をクリックします。
5. モーダルで Browse をクリックし、ローカルマシンで requirements.yml ファイルを見つけます。

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

   モーダルが閉じて、Repo Management ページに戻ります。requirements.yml ファイルで識別されたコレクションを、Ansible Galaxy から Private Automation Hub に同期できるようになりました。

7. Sync をクリックして、Ansible Galaxy および Ansible automation hub からコレクションを同期します。

手順

1. /var/lib/pulp ディレクトリーを作成します。

   # mkdir /var/lib/pulp

   Copy to Clipboard Toggle word wrap

2. 共有ファイルシステムをマウントします (このリファレンス環境では NFS 共有を使用します)。

   # mount -t nfs4 <nfs_share_ip_address>:/ /var/lib/pulp

   Copy to Clipboard Toggle word wrap

3. 共有ファイルシステムが正常にマウントされていることを確認します。

   $ df -h

   Copy to Clipboard Toggle word wrap

1. 次の firewalld サービス (nfs、mountd、rpc-bind) が有効になっていることを確認します。

   # firewall-cmd --zone=public --add-service=nfs
   # firewall-cmd --zone=public --add-service=mountd
   # firewall-cmd --zone=public --add-service=rpc-bind

   Copy to Clipboard Toggle word wrap

2. 変更を有効にするには、firewalld をリロードします。

   # firewall-cmd --reload

   Copy to Clipboard Toggle word wrap

3. firewalld サービスが有効になっていることを確認します。

   # firewall-cmd --get-services

   Copy to Clipboard Toggle word wrap

手順

1. ファイル名のみを受け入れる署名スクリプトを作成します。

   注記

   このスクリプトは署名サービスとして機能し、PULP_SIGNING_KEY_FINGERPRINT 環境変数で指定されたキーを使用して、そのファイルの ascii-armored 分離 gpg 署名を生成する必要があります。

   次に、スクリプトは、以下の形式で JSON 構造を出力します。

   {"file": "filename", "signature": "filename.asc"}

   Copy to Clipboard Toggle word wrap

   すべてのファイル名は、現在の作業ディレクトリー内の相対パスです。ファイル名は、以下に示すようにデタッチされた署名と同じである必要があります。

   以下の例は、コンテンツの署名を生成するスクリプトを示しています。

   #!/usr/bin/env bash
   
   FILE_PATH=$1
   SIGNATURE_PATH="$1.asc"
   
   ADMIN_ID="$PULP_SIGNING_KEY_FINGERPRINT"
   PASSWORD="password"
   
   # Create a detached signature
   gpg --quiet --batch --pinentry-mode loopback --yes --passphrase \
      $PASSWORD --homedir ~/.gnupg/ --detach-sign --default-key $ADMIN_ID \
      --armor --output $SIGNATURE_PATH $FILE_PATH
   
   # Check the exit status
   STATUS=$?
   if [ $STATUS -eq 0 ]; then
      echo {\"file\": \"$FILE_PATH\", \"signature\": \"$SIGNATURE_PATH\"}
   else
      exit $STATUS
   fi

   Copy to Clipboard Toggle word wrap

   署名が有効なプライベート Automation Hub を Ansible Automation Platform クラスターにデプロイした後、コレクションを操作すると、新しい UI が追加されたことが表示されます。

2. automationhub_* で始まるオプションについては、Ansible Automation Platform インストーラーのインベントリーファイルを確認してください。

   [all:vars]
   .
   .
   .
   automationhub_create_default_collection_signing_service = True
   automationhub_auto_sign_collections = True
   automationhub_require_content_approval = True
   automationhub_collection_signing_service_key = /abs/path/to/galaxy_signing_service.gpg
   automationhub_collection_signing_service_script = /abs/path/to/collection_signing.sh

   Copy to Clipboard Toggle word wrap

   2 つの新しいキー (automationhub_auto_sign_collections および automationhub_require_content_approval) は、コレクションに署名する必要があり、Private Automation Hub へのアップロード後に承認が必要であることを示しています。

手順

1. Automation Hub UI でPrivate Automation Hub インスタンスにログインします。
2. 左側のナビゲーションで、コレクション → 承認 をクリックします。Approval ダッシュボードがコレクションのリストと共に表示されます。
3. 署名するコレクションごとに、Sign and approve をクリックします。
4. 署名および手動で承認されたコレクションが Collections タブに表示されていることを確認します。

手順

1. Automation Hub UI でPrivate Automation Hub インスタンスにログインします。

2. ナビゲーションペインで、Signature Keys を選択します。署名キーダッシュボードには、複数のキー (コレクションとコンテナーイメージ) のリストが表示されます。

   • コレクションを確認するには、collections- で始まるキーをダウンロードします。
   • コンテナーイメージを確認するには、container- で始まるキーをダウンロードします。

3. 次のいずれかの方法を選択して、公開鍵をダウンロードします。

   • メニューアイコンを選択し、Download Key をクリックして公開キーをダウンロードします。
   • リストから公開鍵を選択し、Copy to clipboard アイコンをクリックします。
   • Public Key タブの下のドロップダウンメニューをクリックし、公開鍵ブロック全体をコピーします。

手順

1. ansible-galaxy で使用するデフォルト以外のキーリングに公開鍵をインポートするには、以下のコマンドを実行します。

   gpg --import --no-default-keyring --keyring ~/.ansible/pubring.kbx my-public-key.asc

   Copy to Clipboard Toggle word wrap
   注記

   Automation Hub が提供する署名のほかに、署名ソースは要件ファイルとコマンドラインで指定することもできます。署名ソースは URI である必要があります。

2. --signature オプションを使用して、CLI で提供されたコレクション名を追加の署名で検証します。

   ansible-galaxy collection install namespace.collection
   --signature https://examplehost.com/detached_signature.asc
   --signature file:///path/to/local/detached_signature.asc --keyring ~/.ansible/pubring.kbx

   Copy to Clipboard Toggle word wrap

   このオプションを複数回使用して、複数の署名を指定できます。

3. 以下の例のように、要件ファイルのコレクションに、コレクションの署名キーの後に追加の署名ソースが表示されていることを確認します。

   # requirements.yml
   collections:
     - name: ns.coll
       version: 1.0.0
       signatures:
         - https://examplehost.com/detached_signature.asc
         - file:///path/to/local/detached_signature.asc
   
   ansible-galaxy collection verify -r requirements.yml --keyring ~/.ansible/pubring.kbx

   Copy to Clipboard Toggle word wrap

   Automation Hub からコレクションをインストールすると、サーバーが提供する署名はインストールされたコレクションと共に保存され、コレクションの信頼性を検証します。

4. (オプション) Ansible Galaxy サーバーにクエリーを実行せずにコレクションの内部整合性を再度確認する必要がある場合は、--offline オプションを使用して、以前に使用したのと同じコマンドを実行します。