アーティファクト キャッシュ機能で有効になっているレジストリの最も一般的な問題を解決する方法について、症状、原因、および考えられる解決策を特定する方法について説明します。
異常な資格情報
資格情報は、プライベート リポジトリのユーザー名とパスワードとして動作する Azure Key Vault シークレットのセットです。 異常な資格情報は、これらのシークレットが無効になった場合に生じる可能性があります。 Azure portal では、変更を編集して適用する資格情報を選択できます。
Azure Key Vault 内のシークレットが有効であること、および Azure Key Vault へのアクセスが割り当てられていることを確認します。
Azure Key Vault へのアクセスを割り当てるには、次のコマンドを実行します。
az keyvault set-policy --name myKeyVaultName --object-id myObjID --secret-permissions get
詳細については、「 Key Vault とAzure Key Vault へのアクセスの割り当て」を参照してください。
キャッシュ ルールを作成できない
キャッシュ ルールを作成できない場合は、キャッシュ ルールの制限に達しているか、ルールが既存のルールと競合している可能性があります。
キャッシュ ルールの制限に関する問題
1,000 個のキャッシュ ルールの制限を超えると、キャッシュ ルールの作成時に問題が発生する可能性があります。
この制限に達した場合は、不要になったキャッシュ ルールをすべて削除します。
ワイルドカードを使用してキャッシュ ルールを作成できない
作成しようとしているキャッシュ ルールが既存のルールと競合している場合は、指定したターゲット リポジトリのワイルドカードを含むキャッシュ ルールが既に存在することを示すエラー メッセージが表示されます。
この問題を解決するには、次の手順に従ってください。
- 競合の原因となっている既存のキャッシュ ルールを特定します。 ターゲット リポジトリにワイルドカード (*) を使用する既存のルールを探します。
- ソース リポジトリとワイルドカードと重複する競合するキャッシュ 規則を削除します。
- 目的のワイルドカードとターゲット リポジトリで新しいキャッシュ ルールを作成します。
- 新しいルールが正しく適用され、競合するルールが他にないよう、キャッシュ構成を再確認します。
ワイルドカードと潜在的な競合の詳細については、「 Azure Container Registry でのアーティファクト キャッシュのワイルドカードサポート」を参照してください。
サポートされているアップストリーム リポジトリ
アップストリーム リポジトリがサポートされていることを確認します。 詳細については、 アップストリームのサポートを参照してください。
次のステップ
- ワイルドカードを使用して 、 コンテナー イメージ レジストリ内の複数のパスを照合する方法について説明します。
- アーティファクト キャッシュの詳細を確認します。