次の方法で共有

Azure App Configuration 拡張機能 (プレビュー) のインストール エラーのトラブルシューティング

  • [アーティクル]

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

注:

シナリオ 1: Azure App Configuration Kubernetes Provider が既にインストールされている

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

メッセージ 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 App Configuration Kubernetes プロバイダーを最初にアンインストールする

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

シナリオ 2: 対象となる Azure App Configuration 拡張機能のバージョンが存在しない

特定のバージョンを対象として Azure App Configuration 拡張機能をインストールしようとすると、Azure App Configuration バージョンが存在しないことを示すエラー メッセージが表示されます。

(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 App Configuration 拡張機能バージョンに対してもう一度インストールする

拡張機能をインストールするには、もう一度お試しください。 サポートされているバージョンの Azure App Configuration 拡張機能を使用していることを確認します。

シナリオ 3: 対象となる Azure App Configuration 拡張機能のバージョンは存在しますが、指定されたリージョンには存在しません

一部のバージョンの Azure App Configuration 拡張機能はすべてのリージョンで使用できないため、次のエラー メッセージが表示される場合があります。

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

コード: ExtensionTypeRegistrationGetFailed

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

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

Azure App Configuration 拡張機能がサポートされているリージョンでインストールを実行します。

次の手順

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

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

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