第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 の管理者権限を持っており、チームを作成できる。

手順

  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 をクリックしてプロセスを完了します。

    割り当てた権限で新しいチームが作成されます。その後、チームにユーザーを追加できます。

  13. Teams ページの Users タブをクリックします。
  14. Add users をクリックします。
  15. ユーザーを選択し、Add users をクリックします。

チームによるアクセス管理の詳細な手順については、「アクセス管理と認証」ガイドの チーム を参照してください。

2.1.2. 名前空間の作成

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

前提条件

  • 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 をクリックしてプロセスを完了します。

これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードして、所有者として割り当てられたチーム内のユーザーにコレクションのアップロードを許可できるようになりました。

2.1.3. 名前空間への情報およびリソースの追加

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

前提条件

  • Change Namespaces の権限がある。

手順

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

これで、コンテンツ開発者が新しい名前空間にコレクションをアップロードしたり、所有者として割り当てられたチーム内のユーザーにコレクションのアップロードを許可したりできるようになりました。

名前空間を作成すると、名前空間にアップロードする権限を持つチームは、承認を受けるためにコレクションの追加を開始できます。名前空間内のコレクションは、承認されると Published リポジトリーに表示されます。

2.1.4. 名前空間へのコレクションのアップロード

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

注記

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

前提条件

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

手順

  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. 名前空間の削除

不要な名前空間を削除して、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 は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

© 2024 Red Hat, Inc.