第2章 Automation Hub でのコレクションの管理


コンテンツ作成者は、Automation Hub の名前空間を使用してコレクションをキュレートおよび管理できます。たとえば、以下を行うことができます。

  • 名前空間をキュレートする権限やコレクションを Private Automation Hub にアップロードする権限を持つチームを作成する。
  • コレクションのエンドユーザーの自動化タスクで役立つように、名前空間に情報とリソースを追加する。
  • コレクションを名前空間にアップロードする。
  • 名前空間のインポートログを確認して、コレクションのアップロードの成功または失敗と現在の承認ステータスを確認する。

コンテンツの作成方法は、自動化コンテンツの開発 を参照してください。

2.1. namespace の管理

名前空間とは、コンテンツコレクションをアップロードおよび公開できる Automation Hub 内の一意の場所です。namespace アクセスは、そこに表示されるコンテンツと関連情報を管理する権限を持つチームによって管理されます。

Automation Hub の名前空間を使用して、内部での配布と使用のために組織内で開発されたコレクションを整理できます。

名前空間を操作する場合は、コレクションを作成、編集し、名前空間にアップロードする権限を持つチームが必要です。名前空間にアップロードしたコレクションを公開して使用できるようにするには、管理者の承認が必要です。

2.1.1. コンテンツ開発チームの作成

Ansible Automation Platform で新しいチームを作成して、組織内のコンテンツキュレーションと開発をサポートします。このチームは、Private Automation Hub で公開するために内部で開発したコレクションに役立ちます。

コンテンツ開発者が namespace を作成し、内部で開発したコレクションを Private Automation Hub にアップロードするには、最初にチームを作成して必要なパーミッションを割り当てる必要があります。

前提条件

  • Ansible Automation Platform の管理者権限を持っており、チームを作成できる。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから Access Management Teams を選択し、Create team をクリックします。
  3. チームの Name として Content Engineering と入力します。
  4. チームの Organization を選択します。
  5. Create team をクリックします。チームの詳細 ページが開きます。
  6. Roles タブを選択し、Automation Content タブを選択します。
  7. Add roles をクリックします。
  8. Resource type リストから Namespace を選択し、Next をクリックします。
  9. 新しいロールを付与する名前空間を選択し、Next をクリックします。
  10. 選択した名前空間に適用するロールを選択し、Next をクリックします。
  11. 選択内容を確認して、Finish をクリックします。
  12. Close をクリックしてプロセスを完了します。

次のステップ

割り当てた権限で新しいチームが作成されます。Users タブのチームにユーザーを追加できるようになりました。追加の手順につい ては、チームへのユーザーの割り当て を参照してください。

関連情報

2.1.2. 名前空間の作成

名前空間を作成して、コンテンツ開発者が Automation Hub にアップロードするコレクションを整理できます。名前空間を作成するときに、Automation Hub 内のチームをその名前空間の所有者として割り当てることができます。

ヒント

デフォルトでは、Ansible Galaxy で使用される名前空間は、Ansible パートナーチームによって Automation Hub でも使用されます。質問については、ansiblepartners@redhat.com にお問い合わせください。

前提条件

  • Add Namespaces および Upload to Namespaces の権限がある。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Namespaces を選択します。
  3. Create namespace をクリックし、名前空間の Name を入力します。
  4. オプション: 適切なフィールドに説明、会社、ロゴの URL、リソース、または便利なリンクを入力します。
  5. Create namespace をクリックします。
  6. Team Access タブを選択し、Add roles をクリックして名前空間にロールを割り当てます。
  7. ロールを付与するチームを選択し、Next をクリックします。
  8. 選択したチームに適用するロールを選択し、Next をクリックします。
  9. 選択内容を確認して、Finish をクリックします。
  10. Close をクリックしてプロセスを完了します。

次のステップ

コンテンツ開発者は、コレクションを新しい namespace にアップロードできます。さらに、namespace にアップロードするパーミッションを持つチームは、コレクションの承認用の追加を開始できます。名前空間内のコレクションは、承認されると Published リポジトリーに表示されます。

2.1.3. namespace リソースの編集

namespace に関連付けられた情報を編集し、namespace に含まれるコレクションに付随するユーザーにリソースを提供できます。たとえば、ロゴや説明を追加したり、ユーザーを GitHub リポジトリー、問題トラッカー、その他のオンラインアセットにリンクしたりできます。また、Resources フィールドにマークダウンテキストを入力して、詳細情報を追加することもできます。これは、自動化タスクでコレクションを使用するユーザーに有用です。

前提条件

  • Change Namespaces の権限がある。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Namespaces を選択します。
  3. 編集する名前空間を選択します。
  4. Edit namespace をクリックします。
  5. フィールドに適切な情報を入力します。
  6. オプション: Resources フィールドにマークダウン情報を入力します。
  7. Save namespace をクリックします。

2.1.4. コレクションの namespace へのアップロード

tar.gz ファイル形式で内部で開発されたコレクションを Private Automation Hub namespace にアップロードし、Automation Hub 管理者によるレビューおよび承認を受けます。承認されると、コレクションは、Automation Hub ユーザーが表示およびダウンロードできる Published コンテンツリポジトリーに移動します。

注記

コレクションファイル名は、<my_namespace-my_collection-1.0.0.tar.gz> という形式にしてください。

前提条件

  • コレクションをアップロードできる名前空間がある。
重要

非常に大きなコレクションをアップロードしようとすると、エラーが発生します。

Ansible Galaxy または console.redhat.com にアップロードする場合、コレクションのサイズを 20 mb に制限します。Private Automation Hub の場合、200 MB 以上のサイズのコレクションをアップロードしないでください。

複数のコレクションと依存関係を含む完全な環境が必要なシナリオでは、実行環境を使用します。詳細は Automation Hub で使用する実行環境の取得 を参照してください。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Namespaces を選択し、名前空間を選択します。
  3. Collections タブを選択します。
  4. Upload collection をクリックします。
  5. Collection file フィールドの横にある Browse をクリックします。
  6. アップロードするコレクションを選択します。
  7. 以下のオプションのいずれかを選択します。

    • Staging repos
    • Repositories without pipeline
  8. Upload collection をクリックします。

検証

コレクションが正常にアップロードされたか、失敗したかを確認するには、Automation Content Namespaces に移動し、More Actions アイコン をクリックして、Imports を選択します。インポートが成功したかどうかを示すテストの概要が表示されます。

2.1.5. 名前空間インポートログの確認

名前空間にアップロードしたコレクションのステータスを確認して、プロセスの成功または失敗を確認できます。

インポートされたコレクション情報には以下が含まれます。

Status
完了または失敗
承認ステータス
承認待ちまたは承認済み
バージョン
アップロードされたコレクションのバージョン
インポートログ
コレクションのインポート中に実行されたアクティビティー

前提条件

  • コレクションをアップロードできる名前空間にアクセスできる。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Namespaces を選択します。
  3. 名前空間を選択します。
  4. More Actions アイコン をクリックし、Imports を選択します。
  5. 検索フィールドを使用するか、リストからインポートされたコレクションを見つけます。
  6. インポートされたコレクションをクリックします。
  7. コレクションのインポートの詳細を確認し、名前空間内のコレクションのステータスを確認します。

2.1.6. コレクションの削除

コレクションが他のコレクションに依存しない場合は、不要なコレクションを削除すると、コレクションをさらに管理できます。コレクションの Dependencies タブには、現在のコレクションを使用する他のコレクションのリストが表示されます。

前提条件

  • 削除するコレクションに、他のコレクションとの依存関係がない。
  • Delete Collections パーミッションがある。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Collections を選択します。
  3. コレクションを削除する前に、それに依存するコレクションがあるかどうかを確認します。

    • そのコレクションの Dependencies タブをクリックします。空白の場合は、コレクションを削除できます。Dependencies タブが空白でない場合は、コレクションを削除する前にその依存関係を削除する必要があります。
  4. 削除するコレクションをクリックします。
  5. More Actions アイコン をクリックし、オプションを選択します。

    1. Delete version from system を選択すると、すべてのリポジトリーと名前空間を含むインスタンス全体から、コレクションの特定のバージョンが削除されます。
    2. Delete version from repository を選択すると、コレクションのアップロード先リポジトリーから、コレクションの特定のバージョンが削除されます。これは、他のリポジトリーまたは名前空間のコレクションには影響しません。
    3. Delete entire collection from repository を選択すると、コレクションのアップロード先リポジトリーから、コレクション全体のすべてのバージョンが削除されます。これは、他のリポジトリーや名前空間には影響しません。
    4. Delete entire collection from system を選択すると、すべてのリポジトリーと名前空間を含むインスタンスから、コレクション全体のすべてのバージョンが削除されます。
  6. 確認ウィンドウが開いたら、コレクションまたはバージョン番号が正しいことを確認し、Delete を選択します。

2.1.7. 名前空間の削除

不要な名前空間を削除して、Automation Hub サーバー上のストレージを管理できます。まず、依存関係のあるコレクションが、削除する名前空間に含まれていないことを確認する必要があります。

前提条件

  • 削除する名前空間に、依存関係のあるコレクションがない。
  • 名前空間の削除 権限がある。

手順

  1. Ansible Automation Platform にログインします。
  2. ナビゲーションパネルから、Automation Content Namespaces を選択します。
  3. 削除する名前空間をクリックします。
  4. More Actions アイコン をクリックしてから、Delete namespace をクリックします。

    注記

    Delete namespace ボタンが無効になっている場合、依存関係のあるコレクションが名前空間に含まれています。この名前空間内のコレクションを確認し、依存関係があれば削除します。

結果

削除した名前空間とその関連コレクションが削除され、名前空間のリストビューから削除されます。

トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat