1.2. コンテンツを同期するための Ansible Automation Hub リモートリポジトリーの設定
リモート設定を使用して、console.redhat.com でホストされている Ansible Certified Content Collections または Ansible Galaxy のコレクションと同期するように Private Automation Hub を設定します。
2.4 リリースでは、引き続きコンテンツを同期できますが、同期リストは非推奨となり、今後のバージョンで削除される予定です。
コンテンツを同期するために、rh-certified リモートから手動で作成した要件ファイルをアップロードできるようになりました。
リモートは、外部コレクションソースからカスタムリポジトリーにコンテンツを同期できる設定です。
Ansible Galaxy と Ansible Automation Hub の相違点
Ansible Galaxy に公開されたコレクションは、Ansible コミュニティーによって公開された最新のコンテンツです。これらのコレクションに対する共同でのサポート対応は行われていません。Ansible Galaxy は、コンテンツにアクセスする Ansible コミュニティーを対象とした、推奨されるフロントエンドのディレクトリーです。
Ansible Automation Hub に公開されたコレクションは、Red Hat と特定パートナーの共同のお客様を対象としたものです。Ansible Automation Hub のコレクションにアクセスしてダウンロードするには、Ansible サブスクリプションが必要です。認定コレクションとは、Red Hat とパートナーが適所に戦略的関係を築いており、共同してお客様をサポートする準備ができており、そのために追加のテストと検証が行われた可能性があることを意味します。
Ansible Galaxy で名前空間をリクエストする方法
Ansible Galaxy GitHub のイシューを通じて名前空間をリクエストするには、次の手順に従います。
- ansiblepartners@redhat.com にメールを送信します。
- Ansible Galaxy へのサインアップに使用した GitHub ユーザー名を記載します。
システムが検証できるように、少なくとも 1 回はログインする必要があります。
ユーザーが名前空間の管理者として追加されると、セルフサービスのプロセスを使用してさらに管理者を追加できます。
Ansible Galaxy 名前空間の命名制限
コレクションの名前空間は、Python モジュール名の規則に従う必要があります。つまり、コレクションにはすべて小文字の短い名前を付ける必要があります。読みやすさが向上する場合は、コレクション名にアンダースコアを使用できます。
1.2.1. リモート設定を作成する理由 リンクのコピーリンクがクリップボードにコピーされました!
1.2.2. Red Hat Certified Collection の同期 URL と API トークンの取得 リンクのコピーリンクがクリップボードにコピーされました!
組織によってキュレートされた Ansible Certified Content Collections を console.redhat.com から Private Automation Hub に同期できます。API トークンは、コンテンツを保護するために使用されるシークレットトークンです。
前提条件
- console.redhat.com で同期リストを作成するための組織管理者権限がある。
手順
-
組織管理者として
console.redhat.comにログインします。 -
に移動します。 - Offline token で、 をクリックします。
- をクリックし、API トークンをコピーします。
- API トークンをファイルに貼り付け、安全な場所に保存します。
1.2.3. rh-certified リモートリポジトリーの設定および Red Hat Ansible Certified Content Collection の同期 リンクのコピーリンクがクリップボードにコピーされました!
rh-certified リモートリポジトリーを編集して、console.redhat.com でホストされている Automation Hub から Private Automation Hub にコレクションを同期できます。デフォルトでは、Private Automation Hub rh-certified リポジトリーには、Ansible Certified Content Collections のグループ全体の URL が含まれています。
組織で指定されたコレクションのみを使用するには、Private Automation Hub 管理者は、手動で作成した要件ファイルを rh-certified リモートからアップロードできます。
要件ファイルの使用の詳細は、Using Ansible collections ガイドの Install multiple collections with a requirements file を参照してください。
要件ファイルに、A、B、および C コレクションがあり、使用する console.redhat.com に新しいコレクション X を追加する場合は、Private Automation Hub の要件ファイルに X を追加して同期する必要があります。
前提条件
- 有効な Ansible リポジトリーコンテンツの変更 権限を持っている。権限に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
- console.redhat.com で Automation Hub がホストするサービスから同期 URL および API トークンを取得している。
- ポート 443 へのアクセスを設定している。これは、認定されたコレクションを同期するために必要です。詳細は、「Red Hat Ansible Automation Platform 計画ガイド」の ネットワークポートとプロトコル の章にある Automation Hub の表を参照してください。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - rh-certified リモートリポジトリーで、 アイコン ⋮ をクリックし、 をクリックします。
- URL フィールドに、Sync URL を貼り付けます。
- Token フィールドに、console.redhat.com から取得したトークンを貼り付けます。
をクリックします。
console.redhat.com の組織の同期リストと Private Automation Hub の間でコレクションを同期できるようになりました。
- アイコン ⋮ をクリックし、Sync を選択します。
検証
Sync status 通知が更新され、Red Hat Certified Content Collections の同期が完了したことが通知されます。
- コレクションコンテンツのドロップダウンリストから Red Hat Certified を選択し、コレクションコンテンツが正常に同期されたことを確認します。
1.2.4. コミュニティーリモートリポジトリーの設定および Ansible Galaxy コレクションの同期 リンクのコピーリンクがクリップボードにコピーされました!
コミュニティー のリモートリポジトリーを編集して、選択したコレクションを Ansible Galaxy から Private Automation Hub に同期できます。デフォルトでは、Private Automation Hub コミュニティーリポジトリーは galaxy.ansible.com/api/ に送信されます。
前提条件
- Modify Ansible repo content 権限がある。権限に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
次の例のように、Ansible Galaxy から同期するコレクションを識別する
requirements.ymlファイルがある。requirements.yml の例
collections: # Install a collection from Ansible Galaxy. - name: community.aws version: 5.2.0 source: https://galaxy.ansible.comcollections: # Install a collection from Ansible Galaxy. - name: community.aws version: 5.2.0 source: https://galaxy.ansible.comCopy to Clipboard Copied! Toggle word wrap Toggle overflow
手順
- Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - Community リモートで、 アイコン ⋮ をクリックし、Edit を選択します。
-
YAML requirements フィールドで、 をクリックし、ローカルマシン上の
requirements.ymlファイルを見つけます。 をクリックします。
requirements.ymlファイルで識別されたコレクションを、Ansible Galaxy から Private Automation Hub に同期できるようになりました。- アイコン ⋮ をクリックし、Sync を選択して、Ansible Galaxy および Ansible Automation Hub からコレクションを同期します。
検証
同期ステータス 通知が更新され、Ansible Automation Hub への Ansible Galaxy コレクション同期の完了または失敗が通知されます。
- コレクションのコンテンツドロップダウンリストから Community を選択して、同期が成功したことを確認します。
1.2.5. プロキシー設定 リンクのコピーリンクがクリップボードにコピーされました!
Private Automation Hub がネットワークプロキシーの背後にある場合は、リモートでプロキシーを設定して、ローカルネットワーク外にあるコンテンツを同期できます。
前提条件
- 有効な Ansible リポジトリーコンテンツの変更 権限を持っている。権限に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
- ローカルネットワーク管理者からのプロキシー URL および認証情報を持っている。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - rh-certified または Community リモートのいずれかで、 アイコン ⋮ をクリックし、Edit を選択します。
- Show advanced options ドロップダウンメニューを展開します。
- プロキシー URL、プロキシーユーザー名、およびプロキシーパスワードを適切なフィールドに入力します。
- をクリックします。