第2章 Automation Hub でのコレクションの管理
コンテンツ作成者は、Automation Hub の名前空間を使用して、次の目的でコレクションをキュレートおよび管理できます。
- 名前空間をキュレートし、コレクションを Private Automation Hub にアップロードする権限を持つグループを作成する。
- コレクションのエンドユーザーの自動化タスクで役立つように、名前空間に情報とリソースを追加する。
- コレクションを名前空間にアップロードする。
- 名前空間のインポートログを確認して、コレクションのアップロードの成功または失敗と現在の承認ステータスを確認する。
コンテンツの作成方法については、Red Hat Ansible Automation Platform Creator ガイド を参照してください。
2.1. 名前空間を使用した Automation Hub でのコレクションの管理 リンクのコピーリンクがクリップボードにコピーされました!
名前空間とは、コンテンツコレクションをアップロードおよび公開できる Automation Hub 内の一意の場所です。Automation Hub の名前空間へのアクセスは、そこに表示されるコンテンツと関連情報を管理する権限を持つグループによって管理されます。
Automation Hub の名前空間を使用して、内部での配布と使用のために組織内で開発されたコレクションを整理できます。
名前空間を操作する場合は、コレクションを作成、編集し、名前空間にアップロードする権限を持つグループが必要です。名前空間にアップロードしたコレクションを公開して使用できるようにするには、管理者の承認が必要です。
2.1.1. コンテンツキュレーターのための新しいグループの作成 リンクのコピーリンクがクリップボードにコピーされました!
組織内のコンテンツのキュレーションを支援するために、Private Automation Hub に新しいグループを作成できます。このグループは、Private Automation Hub で公開するために内部で開発したコレクションに役立ちます。
コンテンツ開発者が名前空間を作成し、内部で開発したコレクションを Private Automation Hub にアップロードできるようにするには、先にグループを作成および編集し、必要な権限を割り当てる必要があります。
前提条件
- Private Automation Hub の管理者権限があり、グループを作成できる。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから
を選択し、 をクリックします。 - モーダルのグループの Name として Content Engineering を入力し、 をクリックします。新しいグループが作成され、Groups ページが開きます。
- Permissions タブで、 をクリックします。
- Namespaces で、Add Namespace、Upload to Namespace、および Change Namespace の権限を追加します。
をクリックします。
割り当てた権限を使用して新しいグループが作成されます。その後、グループにユーザーを追加できます。
- Groups ページの Users タブをクリックします。
- をクリックします。
- ユーザーを選択し、 をクリックします。
2.1.2. 名前空間の作成 リンクのコピーリンクがクリップボードにコピーされました!
名前空間を作成して、コンテンツ開発者が Automation Hub にアップロードするコレクションを整理できます。名前空間の作成時に、その名前空間の所有者として Automation Hub 内のグループを割り当てることができます。
前提条件
- Add Namespaces および Upload to Namespaces の権限がある。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - をクリックし、namespace name を入力します。
- Namespace owners のグループを割り当てます。
- をクリックします。
これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードして、所有者として割り当てられたグループ内のユーザーにコレクションのアップロードを許可できるようになりました。
2.1.3. 名前空間への情報およびリソースの追加 リンクのコピーリンクがクリップボードにコピーされました!
名前空間に含まれるコレクションに付随する情報を追加し、ユーザーにリソースを提供できます。ロゴおよび説明を追加し、ユーザーを GitHub リポジトリー、案件管理、またはその他のオンラインアセットにリンクします。Edit resources タブにマークダウンテキストを入力して、詳細情報を追加することもできます。これは、自動化タスクでコレクションを使用するユーザーに有用です。
前提条件
- Change Namespaces の権限がある。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - アイコン ⋮ をクリックし、Edit namespace を選択します。
- Edit details タブで、フィールドに情報を入力します。
- Edit resources タブをクリックして、テキストフィールドにマークダウンを入力します。
- をクリックします。
これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードしたり、所有者として割り当てられたグループ内のユーザーにコレクションのアップロードを許可したりできるようになりました。
名前空間を作成すると、名前空間にアップロードする権限を持つグループは、承認を受けるためにコレクションの追加を開始できます。名前空間内のコレクションは、承認されると Published リポジトリーに表示されます。
2.1.4. コレクションの名前空間へのアップロード リンクのコピーリンクがクリップボードにコピーされました!
内部で開発されたコレクションを tar.gz ファイル形式で Private Automation Hub 名前空間にアップロードし、Automation Hub 管理者によるレビューと承認を受けることができます。承認されると、コレクションは、Automation Hub ユーザーが表示およびダウンロードできる Published コンテンツリポジトリーに移動します。
コレクションファイル名は、<my_namespace-my_collection-1.0.0.tar.gz> という形式にしてください。
前提条件
- コレクションをアップロードできる名前空間がある。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択し、名前空間を選択します。 - をクリックします。
- New collection ダイアログから をクリックします。
- アップロードするコレクションを選択します。
- をクリックします。
My Imports 画面にはテストの概要が表示され、コレクションのアップロードが成功したか失敗したかが通知されます。
2.1.5. 名前空間インポートログの確認 リンクのコピーリンクがクリップボードにコピーされました!
名前空間にアップロードしたコレクションのステータスを確認して、プロセスの成功または失敗を確認できます。
インポートされたコレクション情報には以下が含まれます。
- Status
- 完了または失敗
- 承認ステータス
- 承認待ちまたは承認済み
- バージョン
- アップロードされたコレクションのバージョン
- インポートログ
- コレクションのインポート中に実行されたアクティビティー
前提条件
- コレクションをアップロードできる名前空間にアクセスできる。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - 名前空間を選択します。
- アイコン ⋮ をクリックし、My imports を選択します。
- 検索フィールドを使用するか、リストからインポートされたコレクションを見つけます。
- インポートされたコレクションをクリックします。
- コレクションのインポートの詳細を確認し、名前空間内のコレクションのステータスを確認します。
2.1.6. 名前空間の削除 リンクのコピーリンクがクリップボードにコピーされました!
不要な名前空間を削除して、Automation Hub サーバー上のストレージを管理できます。まず、依存関係のあるコレクションが名前空間に含まれていないことを確認する必要があります。
前提条件
- 削除する名前空間に、依存関係のあるコレクションがない。
- 名前空間の削除 権限がある。
手順
- Private Automation Hub にログインします。
-
ナビゲーションパネルから、
を選択します。 - 削除する名前空間をクリックします。
アイコン ⋮ をクリックしてから、 をクリックします。
注記ボタンが無効になっている場合、依存関係のあるコレクションが名前空間に含まれています。この名前空間内のコレクションを確認し、依存関係があれば削除します。詳細は、Automation Hub でのコレクションの削除 を参照してください。
削除した名前空間とその関連コレクションが削除され、名前空間のリストビューから削除されます。