次の方法で共有

Azure アプリ構成拡張機能のインストール エラーのトラブルシューティング

  • [アーティクル]

この記事では、Microsoft Azure Kubernetes Service (AKS) のAzure アプリ構成拡張機能をインストールまたは更新するときに発生する可能性がある一般的なエラー シナリオについて説明します。

Note

Azure アプリ構成拡張機能が正常にインストールされたが、使用中に問題が発生した場合は、Azure アプリ構成 Kubernetes Provider のトラブルシューティング ガイドを参照してください。

シナリオ 1: Azure アプリ構成 Kubernetes プロバイダーが既にインストールされている

AKS のAzure アプリ構成拡張機能をインストールしようとすると、helm install コマンドを使用して Azure アプリ 構成 Kubernetes プロバイダーが既にインストールされていることを示すエラー メッセージが表示されます。 エラー メッセージは、次のいずれかのエラー メッセージのようになります。

メッセージ 1

(ExtensionOperationFailed)拡張機能の操作は、次のエラーで失敗しました: [InnerError: [Helm のインストールに失敗しました: クラスターに既に存在するリソース : 推奨事項: クラスターに現在存在するリソースを手動で削除し、インストールを再試行してください。 これらのリソースを削除するには、次のコマンドを実行します。 kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [レンダリングされたマニフェストには、既に存在するリソースが含まれています。 インストールを続行できません:名前空間 "" の CustomResourceDefinition "azureappconfigurationproviders.azconfig.io" が存在し、現在のリリースにインポートできません:所有権メタデータが無効です。注釈検証エラー: キー "meta.helm.sh/release-name" は "azureappconfig" と等しい必要があります。現在の値は "azureappconfiguration.kubernetesprovider" です。注釈検証エラー: キー "meta.helm.sh/release-namespace" は "kube-system" と等しい必要があります。現在の値は "azappconfig-system"]] という操作の実行中に発生しました: [作成] on the config, for general troubleshooting visit: https://aka.ms/k8s-extensions-TSG.

メッセージ 2

(ExtensionOperationFailed)拡張機能の操作は、次のエラーで失敗しました: [InnerError: [Helm のインストールに失敗しました: クラスターに既に存在するリソース : 推奨事項: クラスターに現在存在するリソースを手動で削除し、インストールを再試行してください。 これらのリソースを削除するには、次のコマンドを実行します。 kubectl delete {resource type} -n {resource namespace} {resource name} : InnerError [レンダリングされたマニフェストには、既に存在するリソースが含まれています。 インストールを続行できません:名前空間 "azappconfig-system" の ServiceAccount "az-appconfig-k8s-provider" が存在し、現在のリリースにインポートできません:所有権メタデータが無効です。注釈検証エラー: キー "meta.helm.sh/release-name" は "azureappconfig" と等しい必要があります。現在の値は "azureappconfiguration.kubernetesprovider"]] 操作の実行中に発生しました: [作成] on the config, for general troubleshooting visit: https://aka.ms/k8s-extensions-TSG.

解決策 1: 最初Azure アプリ構成 Kubernetes プロバイダーをアンインストールする

Azure アプリ構成拡張機能をインストールする前に、Azure アプリ Configuration Kubernetes Provider をアンインストールします。 詳細については、「リソースをクリーンアップする」を参照してください。

シナリオ 2: ターゲット Azure アプリ構成拡張機能のバージョンが存在しない

特定のバージョンをターゲットにAzure アプリ構成拡張機能をインストールしようとするとAzure アプリ構成バージョンが存在しないことを示すエラー メッセージが表示されます。

(ExtensionOperationFailed)拡張機能の操作は、次のエラーで失敗しました: 指定された値から拡張機能のバージョンを解決できませんでした。 インストールに適したバージョンを見つけるには、 https://aka.ms/k8s-extension-type-versions を参照してください。一般的なトラブルシューティングについては、 https://aka.ms/k8s-extensions-TSGを参照してください。

コード: ExtensionOperationFailed

メッセージ: 拡張機能の操作が失敗し、次のエラーが発生しました: 指定された値から拡張機能のバージョンを解決できませんでした。 インストールに適したバージョンを見つけるには、 https://aka.ms/k8s-extension-type-versions を参照してください。一般的なトラブルシューティングについては、 https://aka.ms/k8s-extensions-TSGを参照してください。

解決策 2: サポートされている Azure アプリ Configuration 拡張機能のバージョンに対してもう一度インストールする

拡張機能のインストールをもう一度試みます。 Azure アプリ構成拡張機能のサポートされているバージョンを使用していることを確認。

シナリオ 3: 対象のAzure アプリ構成拡張機能のバージョンは存在しますが、指定されたリージョンには存在しません

Azure アプリ構成拡張機能はすべての AKS リージョンで使用できないため、次のエラー メッセージが表示されることがあります。

(ExtensionTypeRegistrationGetFailed)拡張機能の種類 microsoft.appconfiguration は、リージョン <region-name> に登録されていません。

コード: ExtensionTypeRegistrationGetFailed

メッセージ: 拡張機能の種類 microsoft.appconfiguration がリージョン <region-name に登録されていません>

解決策 3: 別のリージョンにインストールする

クラスター拡張機能がサポートする リージョン でインストールを実行します。

次のステップ

それでもインストールの問題が発生する場合は、 AKS のトラブルシューティング ガイドを参照してください。

お問い合わせはこちらから

質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティ サポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。