1.2. 自動化ダッシュボードのインストール

手順

1. access.redhat.com から最新のインストーラー tar ファイルをダウンロードします。Downloads > Red Hat Ansible Automation Platform Product Software に移動します。
2. インストールソースファイルを RHEL 9 または RHEL 10 ホストにコピーしてください。

3. インストールソースを展開します。これには約 500MB のディスク容量が必要になります。この例では、ec2-user ホームディレクトリー /home/<username> を使用します。

   tar -xzvf ansible-automation-dashboard-containerized-setup-bundle-0.1-x86_64.tar.gz
   cd ansible-automation-dashboard-containerized-setup/

4. 必要な ansible-core パッケージをインストールしてください。

   cd ansible-automation-dashboard-containerized-setup
   sudo dnf install ansible-core

5. Ansible Automation Platform インスタンスに、アプリケーションの client_id/client_secret を作成します。

   1. 次の手順に従って OAuth2 アプリケーションを作成します。

      1. Ansible 2.4 の場合:

         • https://AAP_CONTROLLER_FQDN/#/applications に移動します。

      2. Ansible 2.5 および 2.6 の場合:

         • https://AAP_GATEWAY_FQDN/access/applications に移動します。

      3. 次の情報を追加します。

         • 名前: automation-dashboard-sso
         • 認可付与タイプ: 認可コード
         • 組織: デフォルト
         • リダイレクト URI: https://AUTOMATION_DASHBOARD_FQDN/auth-callback

         • 顧客タイプ: 機密

           注記

           Ansible Automation Platform の 名前、組織、および HTTPS ポート番号の値は設定可能です。このドキュメントで示されている例では、ポート 443 の使用を前提としています。

   2. client_id と client_secret の情報 をインベントリーファイルに保存してください。

   3. Ansible Automation Platform アクセストークンを作成します。

      1. https://AAP_GATEWAY_FQDN/#/users/<id>/tokens に移動し、次の情報を使用してトークンを作成します。

         • OAuth application: automation-dashboard-sso
         • Scope: read
      2. アクセストークンとリフレッシュトークンの値を保存します。clusters.yaml は これらのトークンを使用します。

6. サンプルインベントリーをコピーし、インストールプログラムを実行する前にこれを変更します。

   cp -i inventory.example inventory
   vi inventory

   重要
   • これは、Ansible Automation Platform 2.4、2.5、および 2.6 のデフォルト値を含むテスト済みのインベントリーの例です。

   • ご使用の環境でこのインベントリー設定を使用するには、次の値を変更する必要があります。

     • RHEL 9 または RHEL 10 のホスト出現箇所を host.example.com から FQDN ホストに変更してください。
     • _admin_password または _pg_password の すべての値に含まれる TODO という フレーズを、ご自身のパスワードに合わせて変更してください。
     • dashboard_pg_host の 値を、データベースサーバーの IP アドレスまたは DNS 名に変更してください。
     • オートメーションダッシュボードのイメージがコアコンポーネントとは異なるレジストリーにホストされている場合は、registry_<VARIABLE_NAME>_aap_automation_dashboard 変数を使用して、個別のログイン認証情報を提供する必要があります。
   • 詳細は、このドキュメントの インベントリー変数 のセクションを参照してください。

   # This is our automation dashboard front-end application
   [automationdashboard]
   host.example.com ansible_connection=local
   
   # These are required vars for the installation and should not be removed
   [automationdashboard:vars]
   # Configure AAP OAuth2 authentication.
   # aap_auth_provider_name - name as shown on login page.
   aap_auth_provider_name=Ansible Automation Platform
   # aap_auth_provider_protocol - http or https
   aap_auth_provider_protocol=https
   # AAP version - 2.4, 2.5 or 2.6
   aap_auth_provider_aap_version=2.6
   # aap_auth_provider_host - AAP IP or DNS name, with optional port
   aap_auth_provider_host=my-aap.example.com
   # aap_auth_provider_check_ssl - enforce TLS check or not.
   aap_auth_provider_check_ssl=true
   # aap_auth_provider_client_id and aap_auth_provider_client_secret -
   # they are obtained from AAP when OAuth2 application is created in AAP.
   aap_auth_provider_client_id=TODO
   aap_auth_provider_client_secret=TODO
   
   
   # Specify amount of old data to synchronize after installation.
   # The initial_sync_days=N requests N days of old data, counting from "today".
   # The initial_sync_since requests data from the specified date until "today".
   # If both are specified, the initial_sync_since will be used.
   initial_sync_days=1
   # initial_sync_since=2025-08-08
   
   # Hide warnings when insecure https request are made.
   # Use this if your AAP uses self-signed TLS certificate.
   # show_urllib3_insecure_request_warning=False
   
   # Force clean install-like
   # dashboard_update_secret=true
   
   # HTTP/HTTPS settings
   # nginx_disable_https=true
   # Change nginx_http_port or nginx_https_port if you want to access dashboard on a different TCP port.
   # nginx_http_port=8083
   # nginx_https_port=8447
   # TLS certificate configuration
   # The dashboard_tls_cert needs:
   #   - contain server certificate, intermediate CA certificates and root CA certificate.
   #   - the server certificate must be the first one in the file.
   # dashboard_tls_cert=/path/to/tls/dashboard.crt
   # dashboard_tls_key=/path/to/tls/dashboard.key
   
   # Enable Django DEBUG.
   # django_debug=True
   
   [database]
   host.example.com ansible_connection=local
   [redis]
   host.example.com ansible_connection=local
   
   [all:vars]
   redis_mode=standalone
   
   [all:vars]
   postgresql_admin_username=postgres
   postgresql_admin_password=TODO
   
   # Standard registry settings
   # registry_username=
   # registry_password=
   
   # Dashboard Registry - optional (use if dashboard images are in a different registry)
   # registry_url_aap_automation_dashboard=quay.io
   # registry_ns_aap_automation_dashboard=aap
   # registry_username_aap_automation_dashboard=TODO
   # registry_password_aap_automation_dashboard=TODO
   # registry_tls_verify_aap_automation_dashboard=True
   
   # AAP Dashboard - mandatory
   # --------------------------
   dashboard_pg_containerized=True
   dashboard_admin_password=TODO
   # The value of dashboard_pg_host needs to resolve to an IP address of the database.
   # It cannot be localhost or 127.0.0.1.
   # It can be IP address of the server.
   
   dashboard_pg_host=host.example.com
   dashboard_pg_username=aapdashboard
   dashboard_pg_password=TODO
   dashboard_pg_database=aapdashboard
   
   bundle_install=true
   #
   # Relevant if bundle_install=false
   # Set container_image_update to True to fetch most recent container images from registry.
   # container_image_update=True
   #
   # Relevant if bundle_install=true
   # <full path to the bundle directory>
   bundle_dir='{{ lookup("ansible.builtin.env", "PWD") }}/bundle'
   # AAP Dashboard - optional
   # --------------------------
   # Set to True to expose Django admin page.
   # nginx_dashboard_admin_exposed=False

7. 必要な Ansible コレクションをインストールします。インストール中にモジュール解決エラーが発生しないようにするには、この手順を完了する必要があります。

   ansible-galaxy collection install -r requirements.yml

8. インストールプログラムを実行します。

   ansible-playbook -i inventory ansible.containerized_installer.dashboard_install --ask-become-pass