第1章 Automation Dashboard で主要な使用メトリクスを表示する

手順

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

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

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

   Copy to Clipboard Toggle word wrap

4. 次のコマンドを実行して、必要なソフトウェアがインストールされていることを確認します。

   cd ansible-automation-dashboard-containerized-setup
   sudo dnf install ansible-core
   ansible-galaxy collection install -r requirements.yml

   Copy to Clipboard Toggle word wrap

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

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

      1. Ansible 2.4 の場合:

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

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

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

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

         • Name: automation-dashboard-sso
         • Authorization grant type: authorization-code
         • Organization: Default
         • Redirect URIs: https://AUTOMATION_DASHBOARD_FQDN/auth-callback

         • Client type: Confidential

           注記

           Ansible Automation Platform の Name、Organization、および 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

   Copy to Clipboard Toggle word wrap
   注記
   • これは、Ansible Automation Platform 2.4、2.5、および 2.6 のデフォルト値を含むテスト済みのインベントリーの例です。

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

     • RHEL 9 ホストの出現箇所で、host.example.com からご自身の FQDN ホストに変更します。
     • すべての _admin_password または _pg_password 値内のパスワードと一致するように、TODO のフレーズを変更します。
   • 詳細は、このドキュメントの インベントリー変数 のセクションを参照してください。

   # 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.5
   # 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 synchronoize 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 data 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
   
   [all:vars]
   postgresql_admin_username=postgres
   postgresql_admin_password=TODO
   
   # AAP Dashboard - mandatory
   # --------------------------
   dashboard_pg_containerized=True
   dashboard_admin_password=TODO
   dashboard_pg_host=host.example.com
   dashboard_pg_username=aapdashboard
   dashboard_pg_password=TODO
   dashboard_pg_database=aapdashboard
   #
   bundle_install=true
   # <full path to the bundle directory>
   bundle_dir='{{ lookup("ansible.builtin.env", "PWD") }}/bundle'

   Copy to Clipboard Toggle word wrap

7. インストーラーを実行します。

   ansible-playbook -i inventory ansible.containerized_installer.dashboard_install

   Copy to Clipboard Toggle word wrap