Ansible Automation Platform のトラブルシューティング

手順

1. クラスターにログインします。

   oc login <openshift_url>

   Copy to Clipboard Toggle word wrap

2. クラスター内のアクセスレベルに基づいて、次のいずれかのコマンドを実行します。

   • クラスター全体で must-gather を実行します。

     oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-25/aap-must-gather-rhel8 --dest-dir <dest_dir>

     Copy to Clipboard Toggle word wrap
     • --image はデータを収集するイメージを指定する
     • --dest-dir は出力先のディレクトリーを指定する

   • クラスター内の特定の namespace に対して must-gather を実行します。

     oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-25/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>

     Copy to Clipboard Toggle word wrap
     • – /usr/bin/ns-gather は、must-gather データ収集を指定された namespace に制限する

3. must-gather アーカイブをサポートケースに添付するには、以前に作成した must-gather ディレクトリーから圧縮ファイルを作成し、サポートケースに添付します。

   • たとえば、Linux オペレーティングシステムを使用するコンピューターでは、<must-gather-local.5421342344627712289/> を must-gather ディレクトリー名に置き換えて、次のコマンドを実行します。

     $ tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>

     Copy to Clipboard Toggle word wrap

手順

1. Private Automation Hub の /etc/pulp/settings.py ファイルを変更し、設定に応じて次のいずれかのパラメーターを追加します。

   • シングルコントローラー

     CONNECTED_ANSIBLE_CONTROLLERS = ['<https://my.controller.node>']

     Copy to Clipboard Toggle word wrap

   • ロードバランサーの背後に多数のコントローラー

     CONNECTED_ANSIBLE_CONTROLLERS = ['<https://my.controller.loadbalancer>']

     Copy to Clipboard Toggle word wrap

   • ロードバランサーのないコントローラーが多数

     CONNECTED_ANSIBLE_CONTROLLERS = ['<https://my.controller.node1>', '<https://my.controller2.node2>']

     Copy to Clipboard Toggle word wrap

2. すべての Private Automation Hub サービスを停止します。

   # systemctl stop pulpcore.service pulpcore-api.service pulpcore-content.service pulpcore-worker@1.service pulpcore-worker@2.service nginx.service redis.service

   Copy to Clipboard Toggle word wrap

3. すべての Private Automation Hub サービスを再起動します。

   # systemctl start pulpcore.service pulpcore-api.service pulpcore-content.service pulpcore-worker@1.service pulpcore-worker@2.service nginx.service redis.service

   Copy to Clipboard Toggle word wrap

   検証

   • Private Automation Hub で Use in Controller オプションが使用できるようになったことを確認します。

手順

1. プロジェクトリポジトリー内に collections フォルダーを作成します。

2. collections フォルダー内に requirements.yml ファイルを追加し、コレクションを追加します。

   collections:
   - <collection_name>

   Copy to Clipboard Toggle word wrap

1. Automation Controller に移動します。
2. ナビゲーションパネルから、Settings → Jobs settings を選択します。

3. Extra Environment Variables の下に以下を追加します。

   {
   "ANSIBLE_TIMEOUT": 60
   }

   Copy to Clipboard Toggle word wrap

手順

1. すべてのコントローラーノードとハイブリッドノードで、次のコマンドを実行して custom.py というファイルを作成します。

   # touch /etc/tower/conf.d/custom.py

   Copy to Clipboard Toggle word wrap

   # chmod 640 /etc/tower/conf.d/custom.py

   Copy to Clipboard Toggle word wrap

   # chown root:awx /etc/tower/conf.d/custom.py

   Copy to Clipboard Toggle word wrap

2. /etc/tower/conf.d/custom.py ファイルに以下を追加します。

   DEFAULT_CONTAINER_RUN_OPTIONS = ['--network', 'slirp4netns:enable_ipv6=true,cidr=192.168.1.0/24']

   Copy to Clipboard Toggle word wrap
   • この例では、新しい CIDR の値は 192.168.1.0/24 です。

3. すべてのコントローラーノードとハイブリッドノードで Automation Controller サービスを停止して開始します。

   # automation-controller-service stop

   Copy to Clipboard Toggle word wrap

   # automation-controller-service start

   Copy to Clipboard Toggle word wrap

   すべてのコンテナーは新しい CIDR で起動します。

手順

1. サーバーが SSL/TLS 経由でアクセスできるかどうかを確認します。

   1. 次のコマンドを実行して、サーバーが SSL/TLS 経由でアクセス可能かどうかを確認し、完全な証明書チェーンを表示します。

      # true | openssl s_client -showcerts -connect <fqdn_or_ip>:<port>

      Copy to Clipboard Toggle word wrap
   2. <fqdn_or_ip> と <port> は、適切な値に置き換えます。

2. 証明書の詳細を確認します。

   1. 次のコマンドを実行して証明書の詳細を表示します。

      # openssl x509 -in <path_to_certificate> -noout -text

      Copy to Clipboard Toggle word wrap

3. <path_to_certificate> は、調査する証明書ファイルへのパスに置き換えます。

   コマンドの結果には次のような情報が表示されます。

   • Subject - 証明書の発行先のエンティティー。
   • Issuer - 証明書を発行した CA。
   • Validity "Not Before" - 証明書が発行された日付。
   • Validity "Not After" - 証明書の有効期限が切れる日付。

4. 信頼された CA が証明書に署名したことを確認します。

   1. 次のコマンドを実行して、特定の証明書が有効であり、信頼された CA によって署名されていることを確認します。

      openssl verify -CAfile <path_to_ca_public_certificate> <path_to_server_certificate_file_to_verify>

      Copy to Clipboard Toggle word wrap
   2. コマンドが OK を返す場合、証明書ファイルは有効であり、信頼された CA によって署名されています。

1. 各コントローラーホストに対し、settings.py ファイルの CSRF_TRUSTED_ORIGIN 設定に、信頼済みソースとしてプラットフォームゲートウェイ URL を追加します。

   たとえば、プラットフォームゲートウェイの URL を https://www.example.com として設定した場合は、次に示すように、settings.py ファイルにもその URL を追加する必要があります。

   CSRF_TRUSTED_ORIGINS = ['https://appX.example.com:8443','https://www.example.com']

   Copy to Clipboard Toggle word wrap
2. URL の変更が実装されるように、automation-controller-service restart コマンドを使用して各コントローラーホストを再起動します。手順は、自動化実行の設定 の Automation Controller の起動、停止、再起動 を参照してください。