Automation Dashboard の使用

手順

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

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. 次のコマンドを実行して、必要なソフトウェアのインストールを確認します。

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

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. 次の情報を追加します。

         • 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 information をインベントリーファイルに保存します。

   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 ホストの出現箇所で、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'

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

   ansible-playbook -i inventory ansible.containerized_installer.dashboard_install

手順

1. Red Hat Enterprise Linux ホストの https ポート 8447 で Automation Dashboard が実行されていることを確認します。

   注記
   • この検証には、Ansible Automation Platform のログインの詳細が必要です。
   • ポート 8447 はデフォルトで有効になっていますが、これは設定可能です。

2. 次の情報を使用して、Ansible Automation Platform インスタンスを clusters.yaml に追加します。

   • フロントエンドアクセス用の Ansible Automation Platform の URL/ポート
   • read アクセス用に事前設定された Ansible Automation Platform OAuth アクセストークンとリフレッシュトークン。

   • OAuth2 クライアントクレデンシャル

     注記

     Ansible Automation Platform にアクセスできない場合は、管理者にお問い合わせください。

3. Personal Access Token の設定詳細は、トークンベースの認証を使用した外部アプリケーションへのアクセスの設定 を参照してください。

4. アクセストークンを設定したら、次のコマンドを実行します。

   cp clusters.example.yaml clusters.yaml
   vi clusters.yaml

5. 以下の方法を使用して、データのプルと結合のために、1 つ以上の Ansible Automation Platform インスタンス (同じ Ansible Automation Platform バージョン) を Automation Dashboard 設定に追加できます。

   注記

   Ansible Automation Platform インスタンスが 1 つしかない場合は、2 番目のエントリーを削除します。

   ---
   clusters:
     - protocol: https			<--- Normally https
       address: my-aap.example.com  <--- Can use IP or FQDN without http(s)://
       port: 443				<--- Normally 443
       access_token: sampleToken	<--- Your preconfigured Ansible Automation Platform read access token
     Platform read access token
       refresh_token: myRefreshToken
       client_id: myClientID
       client_secret: myClientSecret
       verify_ssl: false		<--- Can be used when using self signed certs
       sync_schedules:
         - name: Every 5 minutes sync
           rrule: DTSTART;TZID=Europe/Ljubljana:20250630T070000 FREQ=MINUTELY;INTERVAL=5
           enabled: true
   
     - protocol: https
       address: aap2.example.com
       port: 443
       access_token: WRn2swiqg5spEwUndDkrJoCeg4Qwuw
       verify_ssl: true
       sync_schedules:
         - name: Every 5 minutes sync
           rrule: DTSTART;TZID=Europe/Ljubljana:20250630T070000 FREQ=MINUTELY;INTERVAL=5
           enabled: true

   注記

   access_token、refresh_token、および client_secret は Automation Dashboard データベースに保存されます。これらの値はセキュリティーのために暗号化されています。

6. 次のコマンドを実行して、Automation Dashboard の設定を読み込んでアクティブ化します。

   podman cp clusters.yaml automation-dashboard-web:/
   podman exec automation-dashboard-web /venv/bin/python ./manage.py setclusters /clusters.yaml

   注記

   Automation Dashboard は refresh_token、client_id、および client_secret を使用して、現在のトークンの期限が切れると、新しい access_token および refresh_token を自動的に取得します。このユーティリティーは、ping エンドポイントを使用して Ansible Automation Platform バージョンを検出し、正しいトークン更新エンドポイントを見つけます。

   例

   podman exec automation-dashboard-web /venv/bin/python ./manage.py setclusters /clusters.yaml
   Check if table exists.
   Reading YML file.
   Adding cluster: address=my-aap.example.com
   
   INFO 2025-05-20 09:55:00,926 connector 187 140208297051968 Checking if is AAP 2.4 at https://my-aap.example.com:443
   INFO 2025-05-20 09:55:00,926 connector 187 140208297051968 Pinging api https://my-aap.example.com:443/api/v2/ping/
   INFO 2025-05-20 09:55:00,926 connector 187 140208297051968 Executing GET request to https://my-aap.example.com:443/api/v2/ping/
   
   ERROR 2025-05-20 09:55:00,032 connector 301 140025281152832 GET request failed with status 404
   Successfully set up AAP clusters

   注記

   Automation Dashboard は、Ansible Automation Platform 2.4、2.5、および 2.6 インスタンスをチェックします。出力例に示されているように、これにより 404 エラーが発生する可能性があります。エラーの詳細は、この章の検証セクションを参照してください。

7. 手動でデータを取得して Automation Dashboard の設定をテストするには、次のコマンドを使用します。

   podman exec -it automation-dashboard-web /venv/bin/python ./manage.py syncdata --since=2025-04-01 --until=2025-06-01
   Successfully created Sync task for Cluster https://my-aap.example.com:443.

   注記

   テスト時間を短縮するには、日付間隔を短くすることを検討してください。形式は YYYY-MM-DD です。

   次に、journalctl を使用して進行状況を確認できます。

   sudo journalctl -fn10

8. ブラウザーを更新すると、Automation Dashboard 内で取得したデータが表示されます。

手順

1. エンジニアが手動でジョブを実行する場合の 1 分あたりの平均コストを入力するには、Average cost per minute to manually run the job フィールドを使用します。
2. Average cost per minute of running on Ansible Automation Platform フィールドに、Ansible Automation Platform を使用してジョブを実行する場合の 1 分あたりの平均コストを入力します。

3. Time taken to create automation into calculation を選択して、初期または継続的な自動化実行の作成に関連するコストを含めます。

   Automation Dashboard は以下のデータを提供します。

   • 手動自動化のコスト: この数値は、自動化されたすべてのタスクを手動で実行する場合の推定コストを表します。これは推定値であり、実際の支出ではありません。これは、自動化を行わない場合に組織が被る可能性のある費用を表します。計算は、各ジョブの手動実行にかかる時間に人件費率を掛けて行われます。
   • 自動実行のコスト: Ansible Automation Platform を使用した自動化実行のコストです。このコストには、サーバー時間、処理能力、自動化実行に関連するその他の運用コストなど、Ansible Automation Platform によって消費されるリソースが含まれます。これは、自動化の実行に実際に発生したコストを表します。
   • 総節約額/回避コスト: これは 手動による自動化のコスト と 自動実行のコスト との差です。これは、Ansible Automation Platform を使用することで達成可能な投資収益率を示す重要なメトリクスです。
   • 節約/回避された合計時間: この数値は、ホスト実行時間と自動化作成時間を加算し、実行時間 (分) を差し引いて計算されます。

   • 手動実行にかかる時間 (分): このメトリクスは、ユーザーがホスト上でタスクを手動で実行するのにかかる時間を表します。組織が自動化の手作業での設定などに要した時間をもとに、手動実行と自動実行の価値を比較するための入力情報です。

     注記

     コストと節約の分析データを CSV としてエクスポートできます。