Dapr 拡張機能のインストール エラーのトラブルシューティング
この記事では、Microsoft Azure Kubernetes Service (AKS) または Arc for Kubernetes の Distributed Application Runtime (Dapr) 拡張機能をインストールまたは更新するときに表示される一般的なエラー メッセージについて説明します。
シナリオ 1: インストールが失敗してもエラー メッセージが表示されない
拡張機能を作成または更新するときにエラー メッセージが生成された場合は、 az k8s-extension list コマンドを実行して、作成に失敗した場所を調べることができます。
az k8s-extension list --resource-group <my-resource-group-name> \
--cluster-name <my-cluster-name> \
--cluster-type managedClusters
global.ha.enabled=falseではなくglobal.ha=falseなど、構成設定で間違ったキーが使用されている場合は、次の JSON 状態が返されます。 エラー メッセージは、 message プロパティにキャプチャされます。
"statuses": [
{
"code": "InstallationFailed",
"displayStatus": null,
"level": null,
"message": "Error: {failed to install chart from path [] for release [dapr-1]: err [template: dapr/charts/dapr_sidecar_injector/templates/dapr_sidecar_injector_poddisruptionbudget.yaml:1:17: executing \"dapr/charts/dapr_sidecar_injector/templates/dapr_sidecar_injector_poddisruptionbudget.yaml\" at <.Values.global.ha.enabled>: can't evaluate field enabled in type interface {}]} occurred while doing the operation : {Installing the extension} on the config",
"time": null
}
],
JSON エラー メッセージの別の例を次に示します。
"statuses": [
{
"code": "InstallationFailed",
"displayStatus": null,
"level": null,
"message": "The extension operation failed with the following error: unable to add the configuration with configId {extension:microsoft-dapr} due to error: {error while adding the CRD configuration: error {failed to get the immutable configMap from the elevated namespace with err: configmaps 'extension-immutable-values' not found }}. (Code: ExtensionOperationFailed)",
"time": null
}
]
解決策 1: クラスターを再起動するか、サービス プロバイダーを登録するか、Dapr を削除して再インストールする
この問題を解決するには、次の方法を試してください。
シナリオ 2: 対象の Dapr バージョンが存在しない
特定のバージョンをターゲット Dapr 拡張機能をインストールしようとすると Dapr のバージョンが存在しないことを示すエラー メッセージが表示されます。
(ExtensionOperationFailed)拡張機能の操作は、次のエラーで失敗しました:指定された値から拡張機能のバージョンを解決できませんでした。
コード: ExtensionOperationFailed
メッセージ: 拡張機能の操作が失敗し、次のエラーが発生しました:指定された値から拡張機能のバージョンを解決できませんでした。
解決策 2: サポートされている Dapr バージョン用にもう一度インストールする
拡張機能のインストールをもう一度試みます。 サポートされているバージョンの Dapr を使用していることを確認します。
シナリオ 3: 対象となる Dapr バージョンは存在しますが、指定されたリージョンには存在しません
一部のバージョンの Dapr はすべてのリージョンで使用できないため、次のエラー メッセージが表示されることがあります。
(ExtensionTypeRegistrationGetFailed)拡張機能の種類 microsoft.dapr はリージョン <regionname>に登録されていません。
コード: ExtensionTypeRegistrationGetFailed
メッセージ: 拡張機能の種類 microsoft.dapr がリージョン <regionname に登録されていません>
解決策 3: 別のリージョンにインストールする
Dapr バージョンがサポートされている リージョンにインストールします。
シナリオ 4: Dapr が既にインストールされている
AKS または Arc for Kubernetes 用の Dapr 拡張機能をインストールしようとすると、 dapr-system 名前空間が既に存在することを示すエラー メッセージが表示されます。 このエラー メッセージは、次のテキストのようになります。
(ExtensionOperationFailed)拡張機能の操作は次のエラーで失敗しました:エラー: {failed to install chart from path [] for release [dapr-ext]: err [rendered manifests contain a resource that already exists. インストールを続行できません:名前空間 "dapr-system" の ServiceAccount "dapr-operator" が存在し、現在のリリースにインポートできません:無効な所有権メタデータ。注釈検証エラー: キー "meta.helm.sh/release-name" は "dapr-ext" と等しい必要があります。現在の値は "dapr"]} です。{Installing the extension} on the config
解決策 4: Dapr OSS を最初にアンインストールする
Dapr 拡張機能をインストールする前に、Dapr OSS をアンインストールします。 詳細については、「 Dapr OSS から AKS の Dapr 拡張機能へのMigrateを参照してください。
シナリオ 5: 配置サーバー ポッドの状態が正しくありません
次のエラーが発生します。
0/4 ノードを使用できます。1 ノードが予定外で、3 ノードでボリューム ノードアフィニティの競合が発生しました。 プリエンプション: 0/4 ノードを使用できます。4 プリエンプションはスケジュールに役立ちません。
この問題は、配置サーバー ポッド自体とは異なるゾーンに作成された永続ボリュームを、配置サーバー ポッドが使用しようとしたときに発生する可能性があります。
解決策 5: 複数の可用性ゾーンに Dapr をインストールするか、配置サービスを特定の可用性ゾーンに制限する
この問題を解決するには、次の方法のいずれかを使用してください。
カスタム ストレージ クラスを作成し、それを配置サービスに使用して、配置サービスを特定の可用性ゾーンに制限し、次のコマンドを実行します。
az k8s-extension create --cluster-type managedClusters --cluster-name <clustername> --resource-group <resourcegroup> --name <name> --extension-type Microsoft.Dapr --auto-upgrade-minor-version <minorversion> --version <version> --configuration-settings "dapr_placement.volumeclaims.storageClassName=zone-restricted"カスタム ストレージ クラスを作成する例を次に示します。
kind: StorageClass apiVersion: storage.k8s.io/v1 metadata: name: zone-restricted provisioner: disk.csi.azure.com reclaimPolicy: Delete allowVolumeExpansion: true volumeBindingMode: WaitForFirstConsumer allowedTopologies: - matchLabelExpressions: - key: topology.kubernetes.io/zone values: - centralus-1 parameters: storageaccounttype: StandardSSD_LRS
次のステップ
まだインストールの問題が発生している場合は、 AKS のトラブルシューティング ガイド および Dapr OSS のトラブルシューティング ガイドを参照してください。
サードパーティの情報に関する免責事項
この資料に記載されているサードパーティ製品は、マイクロソフトと関連のない他社の製品です。 明示的か黙示的かにかかわらず、これらの製品のパフォーマンスや信頼性についてマイクロソフトはいかなる責任も負わないものとします。
お問い合わせはこちらから
質問がある場合やヘルプが必要な場合は、サポート要求を作成するか、Azure コミュニティ サポートにお問い合わせください。 Azure フィードバック コミュニティに製品フィードバックを送信することもできます。