自動化ハブの使用開始

Red Hat Ansible Automation Platform 2.1

Ansible コレクションコンテンツのデフォルトサーバーとしての Red Hat Automation Hub の設定

概要

本書では、Red Hat 自動化ハブを認定 Ansible コレクションコンテンツのデフォルトソースとして使用する際に必要な初期手順を説明します。
フィードバックの提供:
このドキュメントを改善するための提案がある場合、またはエラーを見つけた場合は、テクニカルサポート (https://access.redhat.com)に連絡し、Ansible Automation Platform Jira プロジェクトの Docs コンポーネントに Issue を作成します。

前書き

Red Hat Ansible オートメーションハブは、Red Hat および弊社のテクノロジーパートナーがサポートするコンテンツをすばやく見つけて使用する場所を提供し、最も要求の多い環境に対して追加の再評価を提供します。

Ansible Galaxy クライアント ansible-galaxy は、コマンドラインからロールおよびコレクションを管理します。ansible-galaxy クライアントが認定済みでサポートされている Ansible コレクションを使用するようにするには、ansible.cfg ファイルを更新して、Ansible コレクションの主なソースとして Red Hat 自動化ハブを使用する必要があります。

本書では、Red Hat 自動化ハブを認定 Ansible コレクションコンテンツのデフォルトソースとして使用するように ansible.cfg ファイルを設定するのに必要な手順を説明します。

第1章 Red Hat 自動化ハブ API トークンの作成

コレクションをアップロードまたはダウンロードして自動化ハブと対話する前に、API トークンを作成する必要があります。自動化ハブ API トークンは、ansible-galaxy クライアントを Red Hat 自動化ハブサーバーに対して認証します。

自動化ハブトークン 管理 を使用して API トークンを作成できます。

前提条件

  • Red Hat Ansible Automation Platform の有効なサブスクリプション認証情報。

手順

  1. https://cloud.redhat.com/ansible/automation-hub/token/ に移動します。
  2. Load Token をクリックします。
  3. copy アイコンをクリックして、API トークンをクリップボードにコピーします。
  4. API トークンをファイルに貼り付け、安全な場所に保存します。
重要

API トークンは、コンテンツを保護するために使用されるシークレットトークンです。API トークンを安全な場所に保存します。

API トークンは、自動化ハブをデフォルトのコレクションサーバーとして設定したり、ansible-galaxy コマンドラインツールを使用してコレクションをアップロードする際に使用できるようになりました。

第2章 コンテンツの主なソースとしての Red Hat 自動化ハブの設定

Red Hat 自動化ハブは、ansible.cfg 設定ファイルでコンテンツのデフォルトソースとして定義できます。

前提条件

  • 自動化ハブサーバーの API トークンを取得します。詳細は、「自動化ハブ API トークンの作成」を参照してください。

手順

  1. [galaxy] セクション配下に server_list オプションを追加し、1 つ以上のサーバー名を指定します。
  2. 各サーバー名に新しいセクションを作成します。

    [galaxy_server.<server_name>]
  3. 各サーバー名に url オプションを設定します。サーバー URL に api/galaxy/ サブディレクトリーを含める必要があります。

    https://<server_fully_qualified_domain_name>/api/galaxy/
  4. 必要に応じて auth_url オプションを設定します。コミュニティーの Ansible Galaxy には auth_url が必要ありません。
  5. 自動化ハブサーバーの API トークンを設定します。

以下の ansible.cfg の例は、優先順位の高い順序で複数のサーバーを設定する方法を示しています。自動化ハブはプライマリーソースとして、Ansible Galaxy サーバーをセカンダリーソースとして設定しています。

ansible.cfg

[galaxy]
server_list = automation_hub, my_org_hub

[galaxy_server.automation_hub]
url=https://cloud.redhat.com/api/automation-hub/api/galaxy/ 1 2
auth_url=https://sso.redhat.com/auth/realms/redhat-external/protocol/openid-connect/token

token=my_ah_token

[galaxy_server.my_org_hub]
url=https://automation.my_org/api/galaxy/ 3
username=my_user
password=my_pass

1
末尾のスラッシュ / はサーバーの URL に従う必要があります。
2
Galaxy サーバーの URL に /api/galaxy/ サブディレクトリーを追加します。
3
自動化ハブサーバーの URL に /api/galaxy/ サブディレクトリーを追加します。

これで自動化ハブをデフォルトのサーバーとして設定し、サポートされるコレクションのダウンロードおよびインストールを続行できるようになりました。

サーバーリストの設定オプションおよび Ansible Galaxy を Ansible コンテンツソースとして使用する方法の詳細は、Ansible Galaxy ユーザーガイド を参照してください。