コンテナーインストール

手順

1. システムを Red Hat Subscription Management に登録します。

   $ sudo subscription-manager register --username <$INSERT_USERNAME_HERE> --password <$INSERT_PASSWORD_HERE>

   Copy to Clipboard Toggle word wrap

   Simple Content Access (SCA) を使用すると、Ansible Automation Platform コンテンツにアクセスするために必要な手順は登録のみです。

   注記

   従来のサブスクリプションプールを引き続き使用しているアカウントの場合は、トラブルシューティングセクションに示されているコマンドを使用して、サブスクリプションを手動でアタッチする必要がある場合があります。

検証

1. システム上のサブスクリプション情報を更新します。

   $ sudo subscription-manager refresh

   Copy to Clipboard Toggle word wrap

2. 登録を確認してください。

   $ sudo subscription-manager identity

   Copy to Clipboard Toggle word wrap

   このコマンドは、システムアイデンティティー、名前、組織名、組織 ID を表示し、登録が成功したことを確認します。

1. Ansible Automation Platform を起動するときに、Red Hat のユーザー名とパスワード、サービスアカウントの認証情報、または Satellite の認証情報を使用します。
2. Red Hat Ansible Automation Platform インターフェイスを使用するか、Ansible Playbook で手動でサブスクリプションマニフェストファイルをアップロードします。

1. グロース - (オールインワン) Ansible Automation Platform の使用を開始する組織を対象としています。このトポロジーを使用すると、小さなフットプリントでデプロイできます。
2. エンタープライズ - 大規模な自動化のために冗長性や大きな計算能力を備えた Ansible Automation Platform をデプロイする必要がある組織を対象としています。これは、将来を考慮し、スケールアウトに対応したアーキテクチャーです。

手順

1. 非 root ユーザーとして Red Hat Enterprise Linux ホストにログインします。

2. ホストのホスト名に完全修飾ドメイン名 (FQDN) が使用されていることを確認します。

   1. ホストのホスト名を確認するには、次のコマンドを実行します。

      hostname -f

      Copy to Clipboard Toggle word wrap

      出力例:

      aap.example.org

      Copy to Clipboard Toggle word wrap

   2. ホスト名が FQDN でない場合は、次のコマンドで設定できます。

      $ sudo hostnamectl set-hostname <your_hostname>

      Copy to Clipboard Toggle word wrap

3. Red Hat Enterprise Linux ホストを subscription-manager に登録します。

   $ sudo subscription-manager register

   Copy to Clipboard Toggle word wrap

4. ホスト上で BaseOS リポジトリーと AppStream リポジトリーのみが有効になっていることを確認します。

   $ sudo dnf repolist

   Copy to Clipboard Toggle word wrap

   RHEL 9 の出力例:

   Updating Subscription Management repositories.
   repo id                                                    repo name
   rhel-9-for-x86_64-appstream-rpms                           Red Hat Enterprise Linux 9 for x86_64 - AppStream (RPMs)
   rhel-9-for-x86_64-baseos-rpms                              Red Hat Enterprise Linux 9 for x86_64 - BaseOS (RPMs)

   Copy to Clipboard Toggle word wrap

   RHEL 10 の出力例:

   Updating Subscription Management repositories.
   repo id                                                    repo name
   rhel-10-for-x86_64-appstream-rpms                          Red Hat Enterprise Linux 10 for x86_64 - AppStream (RPMs)
   rhel-10-for-x86_64-baseos-rpms                             Red Hat Enterprise Linux 10 for x86_64 - BaseOS (RPMs)

   Copy to Clipboard Toggle word wrap
   • 非接続インストールの場合は、これらのリポジトリーにアクセスするための RPM ソースの依存関係の取得および設定 の手順に従います。
5. ホストが DNS を使用してホスト名と IP アドレスを解決できることを確認します。これは、サービスが相互に通信できるようにするために不可欠です。

6. ansible-core をインストールします。

   $ sudo dnf install -y ansible-core

   Copy to Clipboard Toggle word wrap

7. オプション: トラブルシューティングに役立つ追加のユーティリティー (wget、git-core、rsync、vim など) をインストールします。

   $ sudo dnf install -y wget git-core rsync vim

   Copy to Clipboard Toggle word wrap
8. オプション：インストールプログラムが自動的に Ansible Automation Platform サブスクリプションマニフェストライセンスを選択して適用するには、マニフェストファイルの取得 の手順に 従います。

手順

1. root ユーザーとしてホストにログインします。

2. 新しいユーザーを作成します。<username> を aap などの希望するユーザー名に置き換えます。

   $ sudo adduser <username>

   Copy to Clipboard Toggle word wrap

3. 新しいユーザーのパスワードを設定します。<username> を作成したユーザー名に置き換えます。

   $ sudo passwd <username>

   Copy to Clipboard Toggle word wrap

4. sudo コマンドを実行するようにユーザーを設定します。

   セキュアで保守性の高いインストールを実現するには、/etc/sudoers.d/ ディレクトリー内の専用ファイルでインストールユーザーの sudo 特権を設定します。

   1. そのユーザー専用の sudoers ファイルを作成します。

      $ sudo visudo -f /etc/sudoers.d/<username>

      Copy to Clipboard Toggle word wrap

   2. ファイルに次の行を追加します (<username> を作成したユーザー名に置き換えます)。

      <username> ALL=(ALL) NOPASSWD: ALL

      Copy to Clipboard Toggle word wrap
   3. ファイルを保存し、終了します。

手順

1. Ansible Automation Platform ダウンロードページ からコンテナー化された Ansible Automation Platform の最新バージョンをダウンロードします。

   1. オンラインインストールの場合: Ansible Automation Platform 2.5 Containerized Setup
   2. オフラインまたはバンドルインストールの場合: Ansible Automation Platform 2.5 Containerized Setup Bundle

2. インストールプログラムの .tar.gz ファイルと、必要に応じてマニフェスト .zip ファイルを Red Hat Enterprise Linux ホストにコピーします。

   scp コマンドを使用して、ファイルをセキュアにコピーします。scp の基本構文は次のとおりです。

   scp [options] <path_to_source_file> <path_to_destination>

   Copy to Clipboard Toggle word wrap

   たとえば、次の scp コマンドを使用して、インストールプログラムの .tar.gz ファイルを秘密鍵を使用して AWS EC2 インスタンスにコピーします (プレースホルダーの <> 値は実際の情報に置き換えます)。

   scp -i <path_to_private_key> ansible-automation-platform-containerized-setup-<version_number>.tar.gz ec2-user@<remote_host_ip_or_hostname>:<path_to_destination>

   Copy to Clipboard Toggle word wrap

3. インストールプログラムをファイルシステム上のどこに配置するか決定します。そこがインストールディレクトリーになります。

   1. インストールにより、この場所にインストール関連のファイルが作成されます。初回インストールには、少なくとも 15 GB の容量が必要です。

4. インストールプログラムの .tar.gz ファイルをインストールディレクトリーに展開し、展開したディレクトリーに移動します。

   1. オンラインインストーラーを展開するには、次のコマンドを実行します。

      $ tar xfvz ansible-automation-platform-containerized-setup-<version_number>.tar.gz

      Copy to Clipboard Toggle word wrap

   2. オフラインまたはバンドルインストーラーを展開するには次のコマンドを実行します。

      $ tar xfvz ansible-automation-platform-containerized-setup-bundle-<version_number>-<arch_name>.tar.gz

      Copy to Clipboard Toggle word wrap

手順

1. https://access.redhat.com/terms-based-registry/accounts に移動します。
2. Registry Service Account ページで、New Service Account をクリックします。
3. 許可される文字のみを使用して、アカウントの名前を入力します。
4. 必要に応じて、アカウントの説明を入力します。
5. Create をクリックします。
6. 検索フィールドで名前を検索し、作成したアカウントをリストで確認します。
7. 作成したアカウントの名前をクリックします。

8. または、トークンの名前がわかっている場合は、URL を入力してページに直接移動することもできます。

   https://access.redhat.com/terms-based-registry/token/<name-of-your-token>

   Copy to Clipboard Toggle word wrap

9. token ページが開き、生成されたユーザー名 (アカウント名とは異なる) とトークンが表示されます。

   1. トークンが表示されない場合は、Regenerate Token をクリックします。これをクリックして、新しいユーザー名とトークンを生成することもできます。
10. ユーザー名 (例: "1234567|testuser") をコピーし、これを使用して変数 registry_username を設定します。
11. トークンをコピーし、これを使用して変数 registry_password を設定します。

手順

1. 安全なプラグイン変数のディレクトリーを作成します。

   mkdir -p ./group_vars/automationeda

   Copy to Clipboard Toggle word wrap
2. そのディレクトリー内に新しい設定用のファイルを作成します (例: touch ./group_vars/automationeda/custom.yml)。

3. 有効にするプラグインのリストを含む変数 eda_safe_plugins を追加します。以下に例を示します。

   eda_safe_plugins: ['ansible.eda.webhook', 'ansible.eda.alertmanager']

   Copy to Clipboard Toggle word wrap

手順

1. RHEL9 サーバーで次のコマンドを実行して、コレクション署名用の新しい鍵ペアを作成します。

   gpg --gen-key

   Copy to Clipboard Toggle word wrap

2. "Real name" と "Email address" に、ユーザー自身の情報を入力します。

   出力例:

   gpg --gen-key
   gpg (GnuPG) 2.3.3; Copyright (C) 2021 Free Software Foundation, Inc.
   This is free software: you are free to change and redistribute it.
   There is NO WARRANTY, to the extent permitted by law.
   
   Note: Use "gpg --full-generate-key" for a full featured key generation dialog.
   
   GnuPG needs to construct a user ID to identify your key.
   
   Real name: Joe Bloggs
   Email address: jbloggs@example.com
   You selected this USER-ID:
       "Joe Bloggs <jbloggs@example.com>"
   
   Change (N)ame, (E)mail, or (O)kay/(Q)uit? O

   Copy to Clipboard Toggle word wrap
   • これが失敗した場合、使用している環境に GPG に必要な前提条件パッケージがインストールされていません。続行するには必要なパッケージをインストールしてください。
   • ダイアログボックスが表示され、パスフレーズの入力を求められます。これはオプションですが、推奨されます。

   • 鍵が生成され、次のような出力が生成されます。

     We need to generate a lot of random bytes. It is a good idea to perform
     some other action (type on the keyboard, move the mouse, utilize the
     disks) during the prime generation; this gives the random number
     generator a better chance to gain enough entropy.
     gpg: key 022E4FBFB650F1C4 marked as ultimately trusted
     gpg: revocation certificate stored as '/home/aapuser/.gnupg/openpgp-revocs.d/F001B037976969DD3E17A829022E4FBFB650F1C4.rev'
     public and secret key created and signed.
     
     pub   rsa3072 2024-10-25 [SC] [expires: 2026-10-25]
           F001B037976969DD3E17A829022E4FBFB650F1C4
     uid                      Joe Bloggs <jbloggs@example.com>
     sub   rsa3072 2024-10-25 [E] [expires: 2026-10-25]

     Copy to Clipboard Toggle word wrap
   • 有効期限は、会社の標準とニーズに基づき慎重に設定してください。

3. 次のコマンドを実行すると、すべての GPG 鍵を表示できます。

   gpg --list-secret-keys --keyid-format=long

   Copy to Clipboard Toggle word wrap

4. 公開鍵をエクスポートするには、次のコマンドを実行します。

   gpg --export -a --output collection-signing-key.pub <email_address_used_to_generate_key>

   Copy to Clipboard Toggle word wrap

5. 秘密鍵をエクスポートするには、次のコマンドを実行します。

   gpg -a --export-secret-keys <email_address_used_to_generate_key> > collection-signing-key.priv

   Copy to Clipboard Toggle word wrap
   • プロンプトが表示されたらパスフレーズを入力します。

6. 秘密鍵ファイルの内容を表示するには、次のコマンドを実行します。

   cat collection-signing-key.priv

   Copy to Clipboard Toggle word wrap

   出力例:

   -----BEGIN PGP PRIVATE KEY BLOCK-----
   
   lQWFBGcbN14BDADTg5BsZGbSGMHypUJMuzmIffzzz4LULrZA8L/I616lzpBHJvEs
   sSN6KuKY1TcIwIDCCa/U5Obm46kurpP2Y+vNA1YSEtMJoSeHeamWMDd99f49ItBp
   
   <snippet>
   
   j920hRy/3wJGRDBMFa4mlQg=
   =uYEF
   -----END PGP PRIVATE KEY BLOCK-----

   Copy to Clipboard Toggle word wrap
7. 手順 1 - 7 を繰り返して、コンテナー署名用の鍵ペアを作成します。

8. 次の変数をインベントリーファイルに追加し、インストールを実行して署名サービスを作成します。

   # Collection signing
   hub_collection_signing=true
   hub_collection_signing_key=/home/aapuser/aap/ansible-automation-platform-containerized-setup-<version_number>/collection-signing-key.priv
   # This variable is required if the key is protected by a passphrase
   hub_collection_signing_pass=<password>
   
   # Container signing
   hub_container_signing=true
   hub_container_signing_key=/home/aapuser/aap/ansible-automation-platform-containerized-setup-<version_number>/container-signing-key.priv
   # This variable is required if the key is protected by a passphrase
   hub_container_signing_pass=<password>

   Copy to Clipboard Toggle word wrap

1. PostgreSQL 管理者認証情報がある外部データベース
2. PostgreSQL 管理者認証情報がない外部データベース

1. Ansible Automation Platform によって生成される証明書 (デフォルト)
2. ユーザーによって提供される証明書

手順

1. 専用の非 root ユーザーとして Red Hat Enterprise Linux ホストにログインします。
2. Ansible Automation Platform のダウンロード の手順に従って、コンテナー化された Ansible Automation Platform の最新バージョンをダウンロードします。
3. ダウンロードしたインストールプログラムを Red Hat Enterprise Linux ホストにコピーします。
4. inventory ファイルを必要な設定に一致するように編集します。既存の Ansible Automation Platform デプロイメントと同じパラメーターを維持することも、環境の変更に合わせてパラメーターを変更することもできます。

5. install Playbook を実行します。

   $ ansible-playbook -i inventory ansible.containerized_installer.install

   Copy to Clipboard Toggle word wrap
   • 権限昇格にパスワードの入力が必要な場合は、コマンドに -K を追加します。その場合は、BECOME パスワードの入力を求められます。
   • インストールプロセスの詳細を表示するには、最大 4 つの v (-vvvv) を使用して詳細度を上げます。ただし、これによりインストール時間が大幅に長くなる可能性があることに注意してください。そのため、必要な場合、または Red Hat サポートから要求された場合にのみ使用することを推奨します。
6. 更新が開始されます。

手順

1. Red Hat Enterprise Linux ホスト上の Red Hat Ansible Automation Platform インストールディレクトリーに移動します。

2. バックアップ操作を実行しているホストにバックアップアーティファクトを送信する前に、アーティファクトの圧縮を制御するには、インベントリーファイルで次の変数を使用できます。

   1. ファイルシステム関連のバックアップファイルの圧縮を制御するには、以下を使用します。

      # Global control of compression for filesystem backup files
      use_archive_compression=true
      
      # Component-level control of compression for filesystem backup files
      #controller_use_archive_compression=true
      #eda_use_archive_compression=true
      #gateway_use_archive_compression=true
      #hub_use_archive_compression=true
      #pcp_use_archive_compression=true
      #postgresql_use_archive_compression=true
      #receptor_use_archive_compression=true
      #redis_use_archive_compression=true

      Copy to Clipboard Toggle word wrap

   2. データベース関連のバックアップファイルの圧縮を制御するには、以下を使用します。

      # Global control of compression for database backup files
      use_db_compression=true
      
      # Component-level control of compression for database backup files
      #controller_use_db_compression=true
      #eda_use_db_compression=true
      #hub_use_db_compression=true
      #gateway_use_db_compression=true

      Copy to Clipboard Toggle word wrap

3. backup Playbook を実行します。

   $ ansible-playbook -i <path_to_inventory> ansible.containerized_installer.backup

   Copy to Clipboard Toggle word wrap

   バックアッププロセスでは、次のデータのアーカイブが作成されます。

   • PostgreSQL データベース
   • 設定ファイル
   • データファイル

手順

1. Red Hat Enterprise Linux ホストのインストールディレクトリーに移動します。

2. 適切な復元手順を実行します。

   • 同じホスト名を持つ同じ環境に復元する場合は、restore Playbook を実行します。

     $ ansible-playbook -i <path_to_inventory> ansible.containerized_installer.restore

     Copy to Clipboard Toggle word wrap

     これにより、コンテナーインストーラーによってデプロイされた次のような重要なデータが復元されます。

     • PostgreSQL データベース
     • 設定ファイル

     • データファイル

       デフォルトでは、バックアップディレクトリーは ./backups に設定されています。このディレクトリーは、inventory ファイルの backup_dir 変数を使用して変更できます。

   • 異なるホスト名を持つ別の環境に復元する場合は、restore Playbook を実行する前に次の追加手順を実行します。

     重要

     異なるホスト名を持つ別の環境に復元することは推奨されません。あくまで回避策として意図されたものです。

     1. 各コンポーネントについて、PostgreSQL のダンプファイルが含まれている、ソース環境からのバックアップファイルを特定します。

        以下に例を示します。

        $ cd ansible-automation-platform-containerized-setup-<version_number>/backups

        Copy to Clipboard Toggle word wrap

        $ tar tvf gateway_env1-gateway-node1.tar.gz | grep db
        
        -rw-r--r-- ansible/ansible 4850774 2025-06-30 11:05 aap/backups/awx.db

        Copy to Clipboard Toggle word wrap
     2. バックアップファイルをソース環境からターゲット環境にコピーします。

     3. 新しいノード名を反映するように、ターゲット環境のバックアップファイルの名前を変更します。

        以下に例を示します。

        $ cd ansible-automation-platform-containerized-setup-<version_number>/backups

        Copy to Clipboard Toggle word wrap

        $ mv gateway_env1-gateway-node1.tar.gz gateway_env2-gateway-node1.tar.gz

        Copy to Clipboard Toggle word wrap

     4. エンタープライズトポロジーの場合、component.db ファイルを含むコンポーネントのバックアップファイルが、インベントリーファイル内のグループの最初にリストされていることを確認します。

        以下に例を示します。

        $ cd ansible-automation-platform-containerized-setup-<version_number>

        Copy to Clipboard Toggle word wrap

        $ ls backups/gateway*
        
        gateway_env2-gateway-node1.tar.gz
        gateway_env2-gateway-node2.tar.gz

        Copy to Clipboard Toggle word wrap

        $ tar tvf backups/gateway_env2-gateway-node1.tar.gz | grep db
        
        -rw-r--r-- ansible/ansible 416687 2025-06-30 11:05 aap/backups/gateway.db

        Copy to Clipboard Toggle word wrap

        $ tar tvf backups/gateway_env2-gateway-node2.tar.gz | grep db

        Copy to Clipboard Toggle word wrap

        $ vi inventory
        
        [automationgateway]
        env2-gateway-node1
        env2-gateway-node2

        Copy to Clipboard Toggle word wrap

手順

1. Ansible Automation Platform を再インストールし、保存されたデータベースを使用する場合は、既存のシークレットキーを収集する必要があります。

   1. まず、利用可能なシークレットをリスト表示します。

      $ podman secret list

      Copy to Clipboard Toggle word wrap

   2. 次に、以下のコマンドを実行してシークレットキーを収集します。

      $ podman secret inspect --showsecret <secret_key_variable> | jq -r .[].SecretData

      Copy to Clipboard Toggle word wrap

      以下に例を示します。

      $ podman secret inspect --showsecret controller_secret_key | jq -r .[].SecretData

      Copy to Clipboard Toggle word wrap

2. uninstall Playbook を実行します。

   $ ansible-playbook -i inventory ansible.containerized_installer.uninstall

   Copy to Clipboard Toggle word wrap

   • これにより、すべての systemd ユニットとコンテナーが停止し、コンテナーインストーラーによって使用される次のようなリソースがすべて削除されます。

     • 設定、データディレクトリーおよびファイル
     • systemd ユニットファイル
     • Podman のコンテナーとイメージ
     • RPM パッケージ

   • コンテナーイメージを保持するには、container_keep_images パラメーターを true に設定します。

     $ ansible-playbook -i inventory ansible.containerized_installer.uninstall -e container_keep_images=true

     Copy to Clipboard Toggle word wrap

   • PostgreSQL データベースを保持するには、postgresql_keep_databases パラメーターを true に設定します。

     $ ansible-playbook -i inventory ansible.containerized_installer.uninstall -e postgresql_keep_databases=true

     Copy to Clipboard Toggle word wrap

手順

1. 非 root ユーザーとして Red Hat Enterprise Linux ホストにログインします。

2. インベントリーファイル の設定 の手順に従って、インベントリーファイルを 更新します。

   注記

   非接続インストールの場合は、registry_username または registry_password をインベントリーファイルに含めないでください。これらの変数は、オンラインインストールにのみ必要です。すべてのコンテナーイメージがセットアップバンドルに事前にパッケージ化されています。

3. インベントリーファイルの [all:vars] グループの下に、以下の変数を必ず含めてください。

   bundle_install=true
   # The bundle directory must include /bundle in the path
   bundle_dir='{{ lookup("ansible.builtin.env", "PWD") }}/bundle'

   Copy to Clipboard Toggle word wrap
4. コンテナー化された Ansible Automation Platform のインストール の手順に従って、コンテナー化された Ansible Automation Platform をインストールし、インストールを確認します。