第2章 Automation Hub でのコレクションの管理
コンテンツ作成者は、Automation Hub の名前空間を使用してコレクションをキュレートおよび管理できます。たとえば、以下を行うことができます。
- 名前空間をキュレートする権限やコレクションを Private Automation Hub にアップロードする権限を持つチームを作成する。
- コレクションのエンドユーザーの自動化タスクで役立つように、名前空間に情報とリソースを追加する。
- コレクションを名前空間にアップロードする。
- 名前空間のインポートログを確認して、コレクションのアップロードの成功または失敗と現在の承認ステータスを確認する。
コンテンツの作成方法については、自動化コンテンツの開発 を参照してください。
2.1. 名前空間を使用した Automation Hub でのコレクションの管理
名前空間とは、コンテンツコレクションをアップロードおよび公開できる Automation Hub 内の一意の場所です。Automation Hub の名前空間へのアクセスは、そこに表示されるコンテンツと関連情報を管理する権限を持つチームによって管理されます。
Automation Hub の名前空間を使用して、内部での配布と使用のために組織内で開発されたコレクションを整理できます。
名前空間を操作する場合は、コレクションを作成、編集し、名前空間にアップロードする権限を持つチームが必要です。名前空間にアップロードしたコレクションを公開して使用できるようにするには、管理者の承認が必要です。
2.1.1. コンテンツキュレーター用の新しいチームの作成
組織内のコンテンツのキュレーションを支援するために、Ansible Automation Platform に新しいチームを作成できます。このチームは、Private Automation Hub で公開するために内部で開発したコレクションに役立ちます。
コンテンツ開発者が名前空間を作成し、内部で開発したコレクションを Private Automation Hub にアップロードできるようにするには、先にチームを作成および編集し、必要な権限を割り当てる必要があります。
前提条件
- Ansible Automation Platform の管理者権限を持っており、チームを作成できる。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから
を選択し、 をクリックします。 - チームの Name として Content Engineering と入力します。
- チームの Organization を選択します。
- をクリックします。新しいチームが作成され、チームの詳細ページが開きます。
- Roles タブを選択し、Automation Content タブを選択します。
- をクリックします。
- Resource type リストから Namespace を選択し、 をクリックします。
- 新しいロールを付与する名前空間を選択し、 をクリックします。
- 選択した名前空間に適用するロールを選択し、 をクリックします。
- 選択内容を確認して、 をクリックします。
割り当てた権限で新しいチームが作成されます。その後、チームにユーザーを追加できます。
- Teams ページの Users タブをクリックします。
- をクリックします。
- ユーザーを選択し、 をクリックします。
チームによるアクセス管理の詳細な手順については、「アクセス管理と認証」ガイドの チーム を参照してください。
2.1.2. 名前空間の作成
名前空間を作成して、コンテンツ開発者が Automation Hub にアップロードするコレクションを整理できます。名前空間を作成するときに、Automation Hub 内のチームをその名前空間の所有者として割り当てることができます。
前提条件
- Add Namespaces および Upload to Namespaces の権限がある。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから、
を選択します。 - Name を入力します。 をクリックし、名前空間の
- オプション: 適切なフィールドに説明、会社、ロゴの URL、リソース、または便利なリンクを入力します。
- をクリックします。
- Team Access タブを選択し、 をクリックして名前空間にロールを割り当てます。
- ロールを付与するチームを選択し、 をクリックします。
- 選択したチームに適用するロールを選択し、 をクリックします。
- 選択内容を確認して、 をクリックします。
- をクリックしてプロセスを完了します。
これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードして、所有者として割り当てられたチーム内のユーザーにコレクションのアップロードを許可できるようになりました。
2.1.3. 名前空間への情報およびリソースの追加
名前空間に含まれるコレクションに付随する情報を追加し、ユーザーにリソースを提供できます。たとえば、ロゴや説明を追加したり、ユーザーを GitHub リポジトリー、問題トラッカー、その他のオンラインアセットにリンクしたりできます。また、Resources フィールドにマークダウンテキストを入力して、詳細情報を追加することもできます。これは、自動化タスクでコレクションを使用するユーザーに有用です。
前提条件
- Change Namespaces の権限がある。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから、
を選択します。 - 編集する名前空間を選択します。
- をクリックします。
- フィールドに適切な情報を入力します。
- オプション: Resources フィールドにマークダウン情報を入力します。
- をクリックします。
これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードしたり、所有者として割り当てられたチーム内のユーザーにコレクションのアップロードを許可したりできるようになりました。
名前空間を作成すると、名前空間にアップロードする権限を持つチームは、承認を受けるためにコレクションの追加を開始できます。名前空間内のコレクションは、承認されると Published リポジトリーに表示されます。
2.1.4. 名前空間へのコレクションのアップロード
内部で開発されたコレクションを tar.gz
ファイル形式で Private Automation Hub 名前空間にアップロードし、Automation Hub 管理者によるレビューと承認を受けることができます。承認されると、コレクションは、Automation Hub ユーザーが表示およびダウンロードできる Published コンテンツリポジトリーに移動します。
コレクションファイル名は、<my_namespace-my_collection-1.0.0.tar.gz> という形式にしてください。
前提条件
- コレクションをアップロードできる名前空間がある。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから、
を選択し、名前空間を選択します。 - Collections タブを選択します。
- をクリックします。
- Collection file フィールドの横にある をクリックします。
- アップロードするコレクションを選択します。
以下のオプションのいずれかを選択します。
- Staging repos
- Repositories without pipeline
- をクリックします。
検証
コレクションが正常にアップロードされたか、失敗したかを確認するには、
2.1.5. 名前空間インポートログの確認
名前空間にアップロードしたコレクションのステータスを確認して、プロセスの成功または失敗を確認できます。
インポートされたコレクション情報には以下が含まれます。
- Status
- 完了または失敗
- 承認ステータス
- 承認待ちまたは承認済み
- バージョン
- アップロードされたコレクションのバージョン
- インポートログ
- コレクションのインポート中に実行されたアクティビティー
前提条件
- コレクションをアップロードできる名前空間にアクセスできる。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから、
を選択します。 - 名前空間を選択します。
- ⋮ をクリックし、Imports を選択します。 アイコン
- 検索フィールドを使用するか、リストからインポートされたコレクションを見つけます。
- インポートされたコレクションをクリックします。
- コレクションのインポートの詳細を確認し、名前空間内のコレクションのステータスを確認します。
2.1.6. 名前空間の削除
不要な名前空間を削除して、Automation Hub サーバー上のストレージを管理できます。まず、依存関係のあるコレクションが、削除する名前空間に含まれていないことを確認する必要があります。
前提条件
- 削除する名前空間に、依存関係のあるコレクションがない。
- 名前空間の削除 権限がある。
手順
- Ansible Automation Platform にログインします。
-
ナビゲーションパネルから、
を選択します。 - 削除する名前空間をクリックします。
⋮ をクリックしてから、 をクリックします。
アイコン注記
削除した名前空間とその関連コレクションが削除され、名前空間のリストビューから削除されます。