第1章 問題の診断


Ansible Automation Platform のトラブルシューティングを開始するには、OpenShift Container Platform の must-gather コマンドまたは仮想マシンベースのインストールの sos ユーティリティーを使用して、設定と診断情報を収集します。これらのユーティリティーの出力をサポートケースに添付できます。

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) がインストールされている。

手順

  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-24/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-24/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
トップに戻る
Red Hat logoGithubredditYoutubeTwitter

詳細情報

試用、購入および販売

コミュニティー

Red Hat ドキュメントについて

Red Hat をお使いのお客様が、信頼できるコンテンツが含まれている製品やサービスを活用することで、イノベーションを行い、目標を達成できるようにします。 最新の更新を見る.

多様性を受け入れるオープンソースの強化

Red Hat では、コード、ドキュメント、Web プロパティーにおける配慮に欠ける用語の置き換えに取り組んでいます。このような変更は、段階的に実施される予定です。詳細情報: Red Hat ブログ.

会社概要

Red Hat は、企業がコアとなるデータセンターからネットワークエッジに至るまで、各種プラットフォームや環境全体で作業を簡素化できるように、強化されたソリューションを提供しています。

Theme

© 2025 Red Hat