第1章 問題の診断
Ansible Automation Platform のトラブルシューティングを開始するには、OpenShift Container Platform の must-gather
コマンドまたは仮想マシンベースのインストールの sos
ユーティリティーを使用して、設定と診断情報を収集します。これらのユーティリティーの出力をサポートケースに添付できます。
1.1. must-gather コマンドを使用した OpenShift Container Platform 上の Ansible Automation Platform のトラブルシューティング リンクのコピーリンクがクリップボードにコピーされました!
oc adm must-gather
コマンドラインインターフェイス (CLI) コマンドは、OpenShift Container Platform にデプロイされた Ansible Automation Platform インストールから情報を収集します。リソース定義やサービスログなど、問題のデバッグに必要となることが多い情報を収集します。
oc adm must-gather
CLI コマンドを実行すると、収集されたデータを含む新しいディレクトリーが作成され、トラブルシューティングやサポートケースへの添付に使用できます。
OpenShift 環境が registry.redhat.io
にアクセスできず、must-gather
コマンドを実行できない場合は、代わりに oc adm inspect
コマンドを実行します。
前提条件
-
OpenShift CLI (
oc
) がインストールされている。
手順
クラスターにログインします。
oc login <openshift_url>
oc login <openshift_url>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow クラスター内のアクセスレベルに基づいて、次のいずれかのコマンドを実行します。
クラスター全体で
must-gather
を実行します。oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir>
oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
--image
はデータを収集するイメージを指定する -
--dest-dir
は出力先のディレクトリーを指定する
-
クラスター内の特定の namespace に対して
must-gather
を実行します。oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>
oc adm must-gather --image=registry.redhat.io/ansible-automation-platform-24/aap-must-gather-rhel8 --dest-dir <dest_dir> – /usr/bin/ns-gather <namespace>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow -
– /usr/bin/ns-gather
は、must-gather
データ収集を指定された namespace に制限する
-
must-gather
アーカイブをサポートケースに添付するには、以前に作成したmust-gather
ディレクトリーから圧縮ファイルを作成し、サポートケースに添付します。たとえば、Linux オペレーティングシステムを使用するコンピューターでは、
<must-gather-local.5421342344627712289/>
をmust-gather
ディレクトリー名に置き換えて、次のコマンドを実行します。tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>
$ tar cvaf must-gather.tar.gz <must-gather.local.5421342344627712289/>
Copy to Clipboard Copied! Toggle word wrap Toggle overflow