2.3. Automation Hub によるリポジトリー管理
Automation Hub 管理者は、自動化コンテンツコレクションを作成、編集、削除し、リポジトリー間で移動できます。
2.3.1. Automation Hub のリポジトリーの種類 リンクのコピーリンクがクリップボードにコピーされました!
Automation Hub では、コレクションを検証するかどうかに応じて、次の 2 種類のリポジトリーにコレクションを公開できます。
- ステージングリポジトリー
-
名前空間にアップロードする権限を持つユーザーは、これらのリポジトリーにコレクションを公開できます。これらのリポジトリー内のコレクションは、検索ページでは使用できません。代わりに、管理者が確認できるように承認ダッシュボードに表示されます。ステージングリポジトリーは、
pipeline=stagingラベルでマークされます。 - カスタムリポジトリー
- リポジトリーに対する書き込み権限を持つユーザーは、これらのリポジトリーにコレクションを公開できます。カスタムリポジトリーは、すべてのユーザーが表示できるパブリックリポジトリーにすることも、表示権限を持つユーザーのみが表示できるプライベートリポジトリーにすることもできます。これらのリポジトリーは承認ダッシュボードには表示されません。リポジトリー所有者が検索を有効にしている場合、コレクションは検索結果に表示されます。
デフォルトでは、Automation Hub には 1 つのステージングリポジトリーが付属しており、コレクションのアップロードにリポジトリーが指定されていない場合に自動的に使用されます。ユーザーは、リポジトリーの作成 時に新しいステージングリポジトリーを作成できます。
2.3.2. Automation Hub のカスタムリポジトリーの承認パイプライン リンクのコピーリンクがクリップボードにコピーされました!
Automation Hub では、コレクションを承認して、pipeline=approved ラベルが付いている任意のリポジトリーにプロモートできます。デフォルトでは、Automation Hub には承認済みコンテンツ用のリポジトリーが 1 つありますが、リポジトリー作成画面からさらにリポジトリーを追加するオプションもあります。pipeline=approved ラベルが付いているリポジトリーに直接公開することはできません。コレクションは、'pipleline=approved' リポジトリーに公開される前に、まずステージングリポジトリーを通過して承認される必要があります。
- 自動承認
-
自動承認が有効になっている場合は、ステージングリポジトリーにアップロードしたコレクションが
pipeline=approvedとしてマークされたすべてのリポジトリーに自動的にプロモートされます。 - 承認が必要
自動承認が無効になっている場合、管理者は承認ダッシュボードを表示して、ステージングリポジトリーのいずれかにアップロードされたコレクションを確認できます。 をクリックすると、承認されたリポジトリーのリストが表示されます。管理者は、このリストから、コンテンツをプロモートする先の 1 つ以上のリポジトリーを選択できます。
承認されたリポジトリーが 1 つしかない場合は、コレクションが自動的にそのリポジトリーにプロモートされ、管理者はリポジトリーを選択するように求められません。
- 拒否
- 拒否されたコレクションは、事前にインストールされている拒否されたリポジトリーに自動的に配置されます。
2.3.3. カスタムリポジトリーへのアクセスを制限するロールベースのアクセス制御 リンクのコピーリンクがクリップボードにコピーされました!
ロールベースのアクセス制御 (RBAC) を使用して、ユーザーのロールに基づいてアクセス権を定義し、カスタムリポジトリーへのユーザーアクセスを制限します。デフォルトでは、ユーザーは Automation Hub 内のすべてのパブリックリポジトリーを表示できますが、ロールで変更アクセス権が許可されていない限り、リポジトリーを変更することはできません。同じロジックがリポジトリー上の他の操作にも適用されます。たとえば、ユーザーのロールの権限を変更することで、カスタムリポジトリーからコンテンツをダウンロードするユーザーの機能を削除できます。Automation Hub でのユーザーアクセスの管理に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
2.3.4. Automation Hub でのカスタムリポジトリーの作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Ansible Automation Platform を使用してリポジトリーを作成するときに、リポジトリーをプライベートに設定したり、検索結果から非表示にしたりできます。
手順
- Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - をクリックします。
- Repository name を入力します。
- Description フィールドに、リポジトリーの目的を記述します。
変更を加えるたびにリポジトリーの以前のバージョンを保持するには、Retained number of versions を選択します。保持されるバージョンの数は、0 から無制限までの範囲で指定できます。すべてのバージョンを保存するには、これを null に設定したままにします。
注記カスタムリポジトリーへの変更で問題が発生した場合は、保持している 別のリポジトリーバージョンに戻す ことができます。
Pipeline フィールドで、リポジトリーのパイプラインを選択します。このオプションでは、コレクションをリポジトリーに公開できるユーザーを定義します。
- Staging
- 誰でも自動化コンテンツをリポジトリーに公開できます。
- Approved
- このリポジトリーに追加されたコレクションは、ステージングリポジトリーを介して承認プロセスを通過する必要があります。自動承認が有効になっていると、ステージングリポジトリーにアップロードされたコレクションは、承認されたすべてのリポジトリーに自動的にプロモートされます。
- None
- リポジトリーに対する権限を持つすべてのユーザーがリポジトリーに直接公開できます。このリポジトリーは承認パイプラインには含まれません。
- オプション: 検索結果からリポジトリーを非表示にするには、Hide from search を選択します。このオプションはデフォルトで選択されます。
- オプション: リポジトリーをプライベートにするには、Make private を選択します。これにより、リポジトリーを表示する権限を持たない人に対してリポジトリーが非表示になります。
- リモートリポジトリーのコンテンツをこのリポジトリーに同期するには、Remote を選択し、カスタムリポジトリーに含めるコレクションを含むリモートを選択します。詳細は、リポジトリーの同期 を参照してください。
- をクリックします。
2.3.5. カスタム Automation Hub リポジトリーへのアクセスの提供 リンクのコピーリンクがクリップボードにコピーされました!
デフォルトでは、プライベートリポジトリーと自動化コンテンツコレクションは、システム内のすべてのユーザーに対して非表示になります。パブリックリポジトリーはすべてのユーザーが表示できますが、変更することはできません。この手順を使用して、カスタムリポジトリーへのアクセスを提供します。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - リスト内でリポジトリーを見つけて、 アイコン ⋮ をクリックし、Edit を選択します。
- Access タブを選択します。
Repository owners のグループを選択します。
ユーザーアクセスの実装に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
- 選択したグループに割り当てるロールを選択します。
- をクリックします。
2.3.6. Automation Hub リポジトリーへのコレクションの追加 リンクのコピーリンクがクリップボードにコピーされました!
リポジトリーを作成したら、自動化コンテンツコレクションの追加を開始できます。
手順
-
ナビゲーションパネルから、
を選択します。 - リスト内でリポジトリーを見つけて、 アイコン ⋮ をクリックし、Edit を選択します。
- Collections version タブを選択します。
- をクリックし、リポジトリーに追加するコレクションを選択します。
- をクリックします。
2.3.7. 別の Automation Hub リポジトリーバージョンに戻す リンクのコピーリンクがクリップボードにコピーされました!
自動化コンテンツコレクションをリポジトリーに追加またはリポジトリーから削除すると、新しいバージョンが作成されます。リポジトリーへの変更によって問題が発生した場合は、以前のバージョンに戻すことができます。元に戻すことは安全な操作です。元に戻しても、コレクションはシステムから削除されず、リポジトリーに関連付けられたコンテンツが変更されます。保存するバージョンの数は、リポジトリーの作成 時に、Retained number of versions 設定で定義します。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - リスト内でリポジトリーを見つけて、 アイコン ⋮ をクリックし、Edit を選択します。
- 元に戻すバージョンを見つけて、 アイコン ⋮ をクリックし、Revert to this version を選択します。
- をクリックします。
2.3.8. Automation Hub でのリモート設定の管理 リンクのコピーリンクがクリップボードにコピーされました!
Automation Hub を実行している任意のサーバーにリモート設定をセットアップできます。リモート設定を使用すると、外部コレクションソースからカスタムリポジトリーにコンテンツを同期できます。
2.3.8.1. Automation Hub でのリモート設定の作成 リンクのコピーリンクがクリップボードにコピーされました!
Red Hat Ansible Automation Platform を使用して、外部のコレクションソースへのリモート設定を作成できます。その後、そのコレクションのコンテンツをカスタムリポジトリーに同期できます。
手順
- Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - をクリックします。
- リモート設定の Name を入力します。
特定のリポジトリーのパスを含む、リモートサーバーの URL を入力します。
注記リモートサーバー URL とリポジトリーパスを見つけるには、
に移動し、リポジトリーを選択して、 をクリックします。 - 署名されたコレクションのみを同期するには、Signed collections only チェックボックスにチェックを入れます。
- 依存関係を同期するには、Sync all dependencies チェックボックスをオンにします。依存関係の同期をオフにするには、このボックスのチェックを外したままにします。
外部コレクションへのアクセスに必要な Token または Username と Password を入力して、リモートサーバーへの認証情報を設定します。
注記ナビゲーションパネルからトークンを生成するには、
を選択し、 をクリックして、ロードされたトークンをコピーします。 - console.redhat.com からコレクションにアクセスするには、SSO URL を入力してアイデンティティプロバイダー (IdP) にサインインします。
YAML 要件 ファイルを選択または作成して、カスタムリポジトリーと同期するコレクションとバージョン範囲を特定します。たとえば、kubernetes と AWS コレクションのバージョン 5.0.0 以降のみをダウンロードする場合、要件ファイルは次のようになります。
Collections: - name: community.kubernetes - name: community.aws version:”>=5.0.0”
Collections: - name: community.kubernetes - name: community.aws version:”>=5.0.0”Copy to Clipboard Copied! Toggle word wrap Toggle overflow オプション: リモートをさらに設定するには、Advanced configuration で利用可能なオプションを使用します。
- 組織に企業プロキシーが設定されている場合は、Proxy URL、Proxy Username、および Proxy Password を入力します。
- TLS validation チェックボックスを使用して、トランスポート層セキュリティーを有効または無効にします。
- 認証にデジタル証明書が必要な場合は、Client key と Client certificate を入力します。
- サーバーに自己署名 SSL 証明書を使用している場合は、認証に使用される PEM エンコードされたクライアント証明書を CA certificate フィールドに入力します。
- このリモートのコレクションをダウンロードできる速度を高速化するには、Download concurrency フィールドで同時にダウンロードできるコレクションの数を指定します。
このリモートで 1 秒あたりのクエリー数を制限するには、Rate Limit を指定します。
注記一部のサーバーには特定の流量制御が設定されている場合があり、制限を超えると同期が失敗します。
2.3.8.2. リモート設定へのアクセスの提供 リンクのコピーリンクがクリップボードにコピーされました!
リモート設定を作成した後、それを使用できるようにするには、その設定へのアクセスを提供する必要があります。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - リスト内でリポジトリーを見つけ、 アイコン ⋮ をクリックして、Edit を選択します。
- Access タブを選択します。
- Repository owners のグループを選択します。ユーザーアクセスの実装に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
- 選択したグループに適切なロールを選択します。
- をクリックします。
2.3.9. Automation Hub でのリポジトリーの同期 リンクのコピーリンクがクリップボードにコピーされました!
ある Automation Hub から別のオートメーションハブにリポジトリーを同期することで、関連する自動化コレクションコンテンツをユーザーに配布できます。最新のコレクション更新を確実に入手するには、カスタムリポジトリーをリモートと定期的に同期してください。
手順
- Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 リスト内でリポジトリーを見つけて、Sync をクリックします。
設定されたリモート内のすべてのコレクションがカスタムリポジトリーにダウンロードされます。コレクションの同期のステータスを確認するには、Navigation パネルから を選択します。
注記リポジトリーの同期をリモート内の特定のコレクションに制限するには、requirements.yml ファイルを使用してプルする特定のコレクションを指定します。詳細は、Create a remote を参照してください。
2.3.10. Automation Hub でのコレクションのエクスポートとインポート リンクのコピーリンクがクリップボードにコピーされました!
Ansible Automation Hub は、自動化コンテンツコレクションをリポジトリー内に保存します。これらのコレクションは、自動化コンテンツ作成者によってバージョン管理されます。同じコレクションの多くのバージョンが、同じまたは異なるリポジトリーに同時に存在することがあります。
コレクションは、インポートおよびエクスポートできる .tar ファイルとして保存されます。この保存形式により、以前に作成してエクスポートしたコレクションと同じものを、新しいリポジトリーに確実にインポートできます。
2.3.10.1. Automation Hub での自動化コンテンツコレクションのエクスポート リンクのコピーリンクがクリップボードにコピーされました!
コレクションが完成したら、組織全体の他のユーザーに配布できる場所にコレクションをインポートできます。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。Collections ページには、すべてのリポジトリーにわたるすべてのコレクションが表示されます。特定のコレクションを検索できます。 - エクスポートするコレクションを選択します。コレクションの詳細ページが開きます。
- Install タブから、Download tarball を選択します。.tar ファイルがデフォルトのブラウザーのダウンロードフォルダーにダウンロードされます。これで、選択した場所にインポートできるようになります。
2.3.10.2. Automation Hub での自動化コンテンツコレクションのインポート リンクのコピーリンクがクリップボードにコピーされました!
自動化コンテンツ作成者は、カスタムリポジトリーで使用するためにコレクションをインポートできます。カスタムリポジトリーでコレクションを使用するには、まずコレクションを名前空間にインポートして、Automation Hub 管理者が承認できるようにする必要があります。
手順
- Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。Namespaces ページには、使用可能なすべての名前空間が表示されます。 - をクリックします。
- をクリックします。
- コレクションの tarball ファイルに移動し、ファイルを選択して、 をクリックします。
をクリックします。
My Imports 画面にはテストの概要が表示され、コレクションのアップロードが成功したか失敗したかが通知されます。
注記コレクションが承認されていない場合は、コレクションが公開リポジトリーに表示されません。