Azure Stack Hub でのAzure Container Registryに関する問題のトラブルシューティング

この記事では、Azure Stack Hub 上の ACR に関する問題のトラブルシューティング方法に関するガイダンスを提供します。

診断収集の設定を有効にする

プラットフォーム メトリックとアクティビティ ログは自動的に収集および格納されますが、診断設定を使用して他の場所にルーティングすることもできます。

リソース ログは、診断設定を作成して 1 つ以上の場所にルーティングするまでは収集および格納されません。

Azure portal、CLI、または PowerShell を使用した診断設定の作成については、「Azure でプラットフォーム ログとメトリックを収集するための診断設定を作成する」を参照してください。 診断設定を作成するときは、収集するログのカテゴリを指定します。 ACR についてのカテゴリの一覧は、Azure Container Registry 監視データ リファレンスに関する記事に示されています。

Azure Stack Hub では、これらのログとメトリックの唯一の宛先は、Azure Stack Hub 上のローカル Azure Storage アカウントか、Azure Stack Hub 上の Event Hubs インスタンスです。 Log Analytics ワークスペースは、Azure Stack Hub でローカルに使用することはできません。 Azure Storage アカウントを使用する場合のログの形式の詳細については、「 Azure リソース ログ」を参照してください。

一般的な問題の検出

Azure Stack Hub で ACR を使用するときに、問題が発生することがあります。 たとえば、ローカル環境の Docker に問題があるために、コンテナー イメージをプルできない場合があります。 また、ネットワークの問題により、レジストリに接続できない場合もあります。

最初の診断手順として、 コマンドを az acr check-health 実行して環境の正常性に関する情報を取得し、必要に応じてターゲット レジストリにアクセスします。 このコマンドは、Azure CLI バージョン 2.28.0 以降でサポートされています。 CLI をインストールまたはアップグレードする必要がある場合は、「 Azure CLI のインストール」を参照してください。

このコマンドの実行の詳細については、「 レジストリの正常性を確認する」を参照してください。

特定の問題のトラブルシューティング

ログインの問題をトラブルシューティングするには、「 レジストリへのログインのトラブルシューティング」を参照してください。

潜在的なネットワークの問題をトラブルシューティングするには、「 レジストリに関するネットワークの問題のトラブルシューティング」を参照してください。

クォータ関連の問題をトラブルシューティングするには、Azure Stack Hub 上の ACR でクォータ関連の問題が発生する可能性がある 3 つのケースがあります。

• コンテナー レジストリの数が、Azure Stack Hub オペレーターによって設定されたクォータを超えた場合。
• コンテナー レジストリの 1 つ以上のサイズが、Azure Stack Hub オペレーター^*によって設定されたクォータを超えた場合。
• Azure Stack Hub スタンプのストレージ容量を超えた場合。

^*既定では、コンテナー レジストリの最大サイズは 100 GiB ですが、オペレーターはニーズに基づいてこれを変更している可能性があります。

これら 3 つのケースのいずれかで、クォータを超えたというエラー、または何らかの操作が許可されていないことを示すエラーが表示されます。 このエラーを解決するには、クォータを増やしたりスタンプを再構成したりできる Azure Stack Hub オペレーターにお問い合わせください。 オペレーターが Azure Stack Hub 上の ACR の容量とクォータを管理する方法の詳細については、「 コンテナー レジストリ クォータの管理」を参照してください。

サポートのためにレジスト リリソース ID を検索する

問題の解決に役立つコンテナー レジストリのリソース ID を使用することが必要な場合があります。 この ID は、クラウド オペレーターまたは Microsoft サポートに提供する必要がある場合があります。 リソース ID を取得するには、次の手順に従います。

1. Azure Stack Hub ユーザー ポータルを開きます。

2. お使いのコンテナー レジストリに移動します。

3. [JSON ビュー] を選択します。

4. リソース ID を見つけます。 [コピー] を選択します。

   

次の手順

コンテナー レジストリの概要