Problembehandlung für Fehler bei der Installation der Dapr-Erweiterung

Artikel
11/20/2024

In diesem Artikel werden einige häufige Fehlermeldungen erläutert, die Sie möglicherweise erhalten, wenn Sie die Erweiterung Distributed Application Runtime (Dapr) für Microsoft Azure Kubernetes Service (AKS) oder Arc für Kubernetes installieren oder aktualisieren.

Szenario 1: Bei der Installation tritt ein Fehler auf, aber es wird keine Fehlermeldung angezeigt.

Wenn die Erweiterung beim Erstellen oder Aktualisieren eine Fehlermeldung generiert, können Sie prüfen, wo die Erstellung fehlgeschlagen ist, indem Sie den Befehl "az k8s-extension list" ausführen:

az k8s-extension list --resource-group <my-resource-group-name> \
    --cluster-name <my-cluster-name> \
    --cluster-type managedClusters

Wenn in den Konfigurationseinstellungen ein falscher Schlüssel verwendet wird, z global.ha=false . B. anstelle, global.ha.enabled=falsewird der folgende JSON-Status zurückgegeben. Die Fehlermeldung wird in der message Eigenschaft erfasst.

"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
  }
],

Hier ist ein weiteres Beispiel für eine JSON-Fehlermeldung:

"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
  }
]

Lösung 1: Starten Sie den Cluster neu, registrieren Sie den Dienstanbieter, oder löschen Sie Dapr, und installieren Sie es erneut.

Probieren Sie die folgenden Methoden aus, um dieses Problem zu beheben:

Starten Sie Ihren AKS- oder Arc für Kubernetes-Cluster neu.
Registrieren Sie den KubernetesConfiguration-Dienstanbieter.
Erzwingen Sie das Löschen der Dapr-Erweiterung und installieren Sie die Dapr-Erweiterung erneut.

Szenario 2: Die zielorientierte Dapr-Version ist nicht vorhanden.

Wenn Sie versuchen, die Dapr-Erweiterung für eine bestimmte Version zu installieren, erhalten Sie eine Fehlermeldung, die besagt, dass die Dapr-Version nicht vorhanden ist:

(ExtensionOperationFailed) Fehler beim Erweiterungsvorgang: Fehler beim Beheben der Erweiterungsversion aus den angegebenen Werten.

Code: ExtensionOperationFailed

Meldung: Fehler beim Erweiterungsvorgang mit dem folgenden Fehler: Fehler beim Beheben der Erweiterungsversion aus den angegebenen Werten.

Lösung 2: Erneutes Installieren für eine unterstützte Dapr-Version

Versuchen Sie erneut, die Erweiterung zu installieren. Stellen Sie sicher, dass Sie eine unterstützte Version von Dapr verwenden.

Szenario 3: Die zielorientierte Dapr-Version ist vorhanden, aber nicht in der angegebenen Region.

Da einige Versionen von Dapr in allen Regionen nicht verfügbar sind, wird möglicherweise die folgende Fehlermeldung angezeigt:

(ExtensionTypeRegistrationGetFailed) Der Erweiterungstyp "microsoft.dapr" ist nicht im Regionsregionsnamen <>registriert.

Code: ExtensionTypeRegistrationGetFailed

Nachricht: Der Erweiterungstyp "microsoft.dapr" ist nicht im Regionsbereichsnamen <registriert.>

Lösung 3: Installieren in einer anderen Region

Installieren Sie in einer Region, in der Ihre Dapr-Version unterstützt wird.

Szenario 4: Dapr ist bereits installiert

Sie versuchen, die Dapr-Erweiterung für AKS oder Arc für Kubernetes zu installieren, aber Sie erhalten eine Fehlermeldung, die angibt, dass der dapr-system Namespace bereits vorhanden ist. Diese Fehlermeldung ähnelt dem folgenden Text:

(ExtensionOperationFailed) Fehler beim Erweiterungsvorgang: Fehler: {Fehler beim Installieren des Diagramms aus dem Pfad [] für version [dapr-ext]: err [gerenderte Manifeste enthalten eine Ressource, die bereits vorhanden ist. Die Installation kann nicht fortgesetzt werden: ServiceAccount "dapr-operator" im Namespace "dapr-system" ist vorhanden und kann nicht in die aktuelle Version importiert werden: ungültige Besitzermetadaten; Fehler bei der Anmerkungsüberprüfung: Schlüssel "meta.helm.sh/release-name" muss gleich "dapr-ext" sein: Der aktuelle Wert ist "dapr"]} ist beim Ausführen des Vorgangs aufgetreten: {Installieren der Erweiterung} in der Konfiguration

Lösung 4: Deinstallieren Von Dapr OSS zuerst

Deinstallieren Sie das Dapr OSS, bevor Sie die Dapr-Erweiterung installieren. Weitere Informationen finden Sie unter Migrieren von Dapr OSS zur Dapr-Erweiterung für AKS.

Szenario 5: Der Platzierungsserver-Pod befindet sich in einem ungültigen Zustand.

Der folgende Fehler tritt auf:

0/4 Knoten sind verfügbar: 1 Knoten waren ungeplant, 3 Knoten hatten einen Volumeknotenaffinitätskonflikt. Preemption: 0/4 Knoten sind verfügbar: 4 Preemption ist für die Planung nicht hilfreich.

Dieses Problem kann auftreten, wenn der Platzierungsserver-Pod versucht, das persistente Volume zu verwenden, das in einer anderen Zone als der Platzierungsserver-Pod selbst erstellt wird.

Lösung 5: Installieren von Dapr in mehreren Verfügbarkeitszonen oder Beschränken des Platzierungsdiensts auf eine bestimmte Verfügbarkeitszone

Sie können dieses Problem mit einer der folgenden Methoden beheben:

Befolgen Sie den empfohlenen Ansatz in "Dapr installieren" in mehreren Verfügbarkeitszonen im HA-Modus.

Beschränken Sie den Platzierungsdienst auf eine bestimmte Verfügbarkeitszone, indem Sie eine benutzerdefinierte Speicherklasse erstellen und für den Platzierungsdienst verwenden, und führen Sie dann den folgenden Befehl aus:

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"

Hier ist ein Beispiel für das Erstellen einer benutzerdefinierten Speicherklasse:

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

Nächste Schritte

Wenn weiterhin Installationsprobleme auftreten, erkunden Sie das Handbuch zur Problembehandlung von AKS und das Dapr OSS-Handbuch zur Problembehandlung.

Informationen zum Haftungsausschluss von Drittanbietern

Die in diesem Artikel genannten Drittanbieterprodukte stammen von Herstellern, die von Microsoft unabhängig sind. Microsoft gewährt keine implizite oder sonstige Garantie in Bezug auf die Leistung oder Zuverlässigkeit dieser Produkte.

Kontaktieren Sie uns für Hilfe

Wenn Sie Fragen haben oder Hilfe mit Ihren Azure-Gutschriften benötigen, dann erstellen Sie beim Azure-Support eine Support-Anforderung oder fragen Sie den Azure Community-Support. Sie können auch Produktfeedback an die Azure Feedback Community senden.

Freigeben über