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 としてマークされたすべてのリポジトリーに自動的にプロモートされます。
承認が必要

自動承認が無効になっている場合、管理者は承認ダッシュボードを表示して、ステージングリポジトリーのいずれかにアップロードされたコレクションを確認できます。Approve をクリックすると、承認されたリポジトリーのリストが表示されます。管理者は、このリストから、コンテンツをプロモートする先の 1 つ以上のリポジトリーを選択できます。

承認されたリポジトリーが 1 つしかない場合は、コレクションが自動的にそのリポジトリーにプロモートされ、管理者はリポジトリーを選択するように求められません。

拒否
拒否されたコレクションは、事前にインストールされている拒否されたリポジトリーに自動的に配置されます。

2.3.3. カスタムリポジトリーへのアクセスを制限するロールベースのアクセス制御

ロールベースのアクセス制御 (RBAC) を使用して、ユーザーのロールに基づいてアクセス権を定義し、カスタムリポジトリーへのユーザーアクセスを制限します。デフォルトでは、ユーザーは Automation Hub 内のすべてのパブリックリポジトリーを表示できますが、ロールで変更アクセス権が許可されていない限り、リポジトリーを変更することはできません。同じロジックがリポジトリー上の他の操作にも適用されます。たとえば、ユーザーのロールの権限を変更することで、カスタムリポジトリーからコンテンツをダウンロードするユーザーの機能を削除できます。Automation Hub でのユーザーアクセスの管理に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。

2.3.4. Automation Hub でのカスタムリポジトリーの作成

Red Hat Ansible Automation Platform を使用してリポジトリーを作成するときに、リポジトリーをプライベートに設定したり、検索結果から非表示にしたりできます。

手順

  1. Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Repositories を選択します。
  3. Add repository をクリックします。
  4. Repository name を入力します。
  5. Description フィールドに、リポジトリーの目的を記述します。
  6. 変更を加えるたびにリポジトリーの以前のバージョンを保持するには、Retained number of versions を選択します。保持されるバージョンの数は、0 から無制限までの範囲で指定できます。すべてのバージョンを保存するには、これを null に設定したままにします。

    注記

    カスタムリポジトリーへの変更で問題が発生した場合は、保持している 別のリポジトリーバージョンに戻す ことができます。

  7. Pipeline フィールドで、リポジトリーのパイプラインを選択します。このオプションでは、コレクションをリポジトリーに公開できるユーザーを定義します。

    Staging
    誰でも自動化コンテンツをリポジトリーに公開できます。
    Approved
    このリポジトリーに追加されたコレクションは、ステージングリポジトリーを介して承認プロセスを通過する必要があります。自動承認が有効になっていると、ステージングリポジトリーにアップロードされたコレクションは、承認されたすべてのリポジトリーに自動的にプロモートされます。
    None
    リポジトリーに対する権限を持つすべてのユーザーがリポジトリーに直接公開できます。このリポジトリーは承認パイプラインには含まれません。
  8. オプション: 検索結果からリポジトリーを非表示にするには、Hide from search を選択します。このオプションはデフォルトで選択されます。
  9. オプション: リポジトリーをプライベートにするには、Make private を選択します。これにより、リポジトリーを表示する権限を持たない人に対してリポジトリーが非表示になります。
  10. リモートリポジトリーのコンテンツをこのリポジトリーに同期するには、Remote を選択し、カスタムリポジトリーに含めるコレクションを含むリモートを選択します。詳細は、リポジトリーの同期 を参照してください。
  11. Save をクリックします。

2.3.5. カスタム Automation Hub リポジトリーへのアクセスの提供

デフォルトでは、プライベートリポジトリーと自動化コンテンツコレクションは、システム内のすべてのユーザーに対して非表示になります。パブリックリポジトリーはすべてのユーザーが表示できますが、変更することはできません。この手順を使用して、カスタムリポジトリーへのアクセスを提供します。

手順

  1. Private Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Repositories を選択します。
  3. リスト内でリポジトリーを見つけて、More Actions アイコン をクリックし、Edit を選択します。
  4. Access タブを選択します。
  5. Repository owners のグループを選択します。

    ユーザーアクセスの実装に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。

  6. 選択したグループに割り当てるロールを選択します。
  7. Save をクリックします。

2.3.6. Automation Hub リポジトリーへのコレクションの追加

リポジトリーを作成したら、自動化コンテンツコレクションの追加を開始できます。

手順

  1. ナビゲーションパネルから、Collections Repositories を選択します。
  2. リスト内でリポジトリーを見つけて、More Actions アイコン をクリックし、Edit を選択します。
  3. Collections version タブを選択します。
  4. Add Collection をクリックし、リポジトリーに追加するコレクションを選択します。
  5. Select をクリックします。

2.3.7. 別の Automation Hub リポジトリーバージョンに戻す

自動化コンテンツコレクションをリポジトリーに追加またはリポジトリーから削除すると、新しいバージョンが作成されます。リポジトリーへの変更によって問題が発生した場合は、以前のバージョンに戻すことができます。元に戻すことは安全な操作です。元に戻しても、コレクションはシステムから削除されず、リポジトリーに関連付けられたコンテンツが変更されます。保存するバージョンの数は、リポジトリーの作成 時に、Retained number of versions 設定で定義します。

手順

  1. Private Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Repositories を選択します。
  3. リスト内でリポジトリーを見つけて、More Actions アイコン をクリックし、Edit を選択します。
  4. 元に戻すバージョンを見つけて、More Actions アイコン をクリックし、Revert to this version を選択します。
  5. Revert をクリックします。

2.3.8. Automation Hub でのリモート設定の管理

Automation Hub を実行している任意のサーバーにリモート設定をセットアップできます。リモート設定を使用すると、外部コレクションソースからカスタムリポジトリーにコンテンツを同期できます。

2.3.8.1. Automation Hub でのリモート設定の作成

Red Hat Ansible Automation Platform を使用して、外部のコレクションソースへのリモート設定を作成できます。その後、そのコレクションのコンテンツをカスタムリポジトリーに同期できます。

手順

  1. Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Remotes を選択します。
  3. Add Remote をクリックします。
  4. リモート設定の Name を入力します。
  5. 特定のリポジトリーのパスを含む、リモートサーバーの URL を入力します。

    注記

    リモートサーバー URL とリポジトリーパスを見つけるには、Collection Repositories に移動し、リポジトリーを選択して、Copy CLI configuration をクリックします。

  6. 署名されたコレクションのみを同期するには、Signed collections only チェックボックスにチェックを入れます。
  7. 依存関係を同期するには、Sync all dependencies チェックボックスをオンにします。依存関係の同期をオフにするには、このボックスのチェックを外したままにします。
  8. 外部コレクションへのアクセスに必要な Token または UsernamePassword を入力して、リモートサーバーへの認証情報を設定します。

    注記

    ナビゲーションパネルからトークンを生成するには、Collections API token を選択し、Load token をクリックして、ロードされたトークンをコピーします。

  9. console.redhat.com からコレクションにアクセスするには、SSO URL を入力してアイデンティティプロバイダー (IdP) にサインインします。
  10. YAML 要件 ファイルを選択または作成して、カスタムリポジトリーと同期するコレクションとバージョン範囲を特定します。たとえば、kubernetes と AWS コレクションのバージョン 5.0.0 以降のみをダウンロードする場合、要件ファイルは次のようになります。

    Collections:
     	  - name: community.kubernetes
    	  - name: community.aws
     		version:”>=5.0.0”
    Copy to Clipboard Toggle word wrap
  11. オプション: リモートをさらに設定するには、Advanced configuration で利用可能なオプションを使用します。

    1. 組織に企業プロキシーが設定されている場合は、Proxy URLProxy Username、および Proxy Password を入力します。
    2. TLS validation チェックボックスを使用して、トランスポート層セキュリティーを有効または無効にします。
    3. 認証にデジタル証明書が必要な場合は、Client keyClient certificate を入力します。
    4. サーバーに自己署名 SSL 証明書を使用している場合は、認証に使用される PEM エンコードされたクライアント証明書を CA certificate フィールドに入力します。
    5. このリモートのコレクションをダウンロードできる速度を高速化するには、Download concurrency フィールドで同時にダウンロードできるコレクションの数を指定します。
    6. このリモートで 1 秒あたりのクエリー数を制限するには、Rate Limit を指定します。

      注記

      一部のサーバーには特定の流量制御が設定されている場合があり、制限を超えると同期が失敗します。

2.3.8.2. リモート設定へのアクセスの提供

リモート設定を作成した後、それを使用できるようにするには、その設定へのアクセスを提供する必要があります。

手順

  1. Private Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Remotes を選択します。
  3. リスト内でリポジトリーを見つけ、More Actions アイコン をクリックして、Edit を選択します。
  4. Access タブを選択します。
  5. Repository owners のグループを選択します。ユーザーアクセスの実装に関する詳細は、Private Automation Hub のユーザーアクセスの設定 を参照してください。
  6. 選択したグループに適切なロールを選択します。
  7. Save をクリックします。

2.3.9. Automation Hub でのリポジトリーの同期

ある Automation Hub から別のオートメーションハブにリポジトリーを同期することで、関連する自動化コレクションコンテンツをユーザーに配布できます。最新のコレクション更新を確実に入手するには、カスタムリポジトリーをリモートと定期的に同期してください。

手順

  1. Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Repositories を選択します。
  3. リスト内でリポジトリーを見つけて、Sync をクリックします。

    設定されたリモート内のすべてのコレクションがカスタムリポジトリーにダウンロードされます。コレクションの同期のステータスを確認するには、Navigation パネルから Task Management を選択します。

    注記

    リポジトリーの同期をリモート内の特定のコレクションに制限するには、requirements.yml ファイルを使用してプルする特定のコレクションを指定します。詳細は、Create a remote を参照してください。

2.3.10. Automation Hub でのコレクションのエクスポートとインポート

Ansible Automation Hub は、自動化コンテンツコレクションをリポジトリー内に保存します。これらのコレクションは、自動化コンテンツ作成者によってバージョン管理されます。同じコレクションの多くのバージョンが、同じまたは異なるリポジトリーに同時に存在することがあります。

コレクションは、インポートおよびエクスポートできる .tar ファイルとして保存されます。この保存形式により、以前に作成してエクスポートしたコレクションと同じものを、新しいリポジトリーに確実にインポートできます。

2.3.10.1. Automation Hub での自動化コンテンツコレクションのエクスポート

コレクションが完成したら、組織全体の他のユーザーに配布できる場所にコレクションをインポートできます。

手順

  1. Private Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Collections を選択します。Collections ページには、すべてのリポジトリーにわたるすべてのコレクションが表示されます。特定のコレクションを検索できます。
  3. エクスポートするコレクションを選択します。コレクションの詳細ページが開きます。
  4. Install タブから、Download tarball を選択します。.tar ファイルがデフォルトのブラウザーのダウンロードフォルダーにダウンロードされます。これで、選択した場所にインポートできるようになります。

2.3.10.2. Automation Hub での自動化コンテンツコレクションのインポート

自動化コンテンツ作成者は、カスタムリポジトリーで使用するためにコレクションをインポートできます。カスタムリポジトリーでコレクションを使用するには、まずコレクションを名前空間にインポートして、Automation Hub 管理者が承認できるようにする必要があります。

手順

  1. Automation Hub にログインします。
  2. ナビゲーションパネルから、Collections Namespaces を選択します。Namespaces ページには、使用可能なすべての名前空間が表示されます。
  3. View Collections をクリックします。
  4. Upload Collection をクリックします。
  5. コレクションの tarball ファイルに移動し、ファイルを選択して、Open をクリックします。
  6. Upload をクリックします。

    My Imports 画面にはテストの概要が表示され、コレクションのアップロードが成功したか失敗したかが通知されます。

    注記

    コレクションが承認されていない場合は、コレクションが公開リポジトリーに表示されません。

Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

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

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

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

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

会社概要

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

Theme

© 2026 Red Hat
トップに戻る