Problemen met de installatie van de Dapr-extensie oplossen

Artikel
04/12/2024

In dit artikel worden enkele veelvoorkomende foutberichten besproken die u kunt ontvangen wanneer u de Distributed Application Runtime-extensie (Dapr) voor Microsoft Azure Kubernetes Service (AKS) of Arc voor Kubernetes installeert of bijwerkt.

Scenario 1: Installatie mislukt, maar er wordt geen foutbericht weergegeven

Als de extensie een foutbericht genereert wanneer u deze maakt of bijwerkt, kunt u controleren waar het maken is mislukt door de opdracht az k8s-extension list uit te voeren:

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

Als er een verkeerde sleutel wordt gebruikt in de configuratie-instellingen, zoals global.ha=false in plaats van global.ha.enabled=false, wordt de volgende JSON-status geretourneerd. Het foutbericht wordt vastgelegd in de message eigenschap.

"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 volgt nog een voorbeeld van een JSON-foutbericht:

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

Oplossing 1: Start het cluster opnieuw, registreer de serviceprovider of verwijder dapr en installeer deze opnieuw

Probeer de volgende methoden om dit probleem op te lossen:

Scenario 2: Doel-Dapr-versie bestaat niet

Wanneer u de Dapr-extensie probeert te installeren voor een specifieke versie, ontvangt u een foutbericht met de melding dat de Dapr-versie niet bestaat:

(ExtensionOperationFailed) De extensiebewerking is mislukt met de volgende fout: Kan de extensieversie van de opgegeven waarden niet oplossen.

Code: ExtensionOperationFailed

Bericht: De extensiebewerking is mislukt met de volgende fout: Kan de extensieversie van de opgegeven waarden niet oplossen.

Oplossing 2: Installeer opnieuw voor een ondersteunde Dapr-versie

Probeer de extensie opnieuw te installeren. Zorg ervoor dat u een ondersteunde versie van Dapr gebruikt.

Scenario 3: De beoogde Dapr-versie bestaat, maar niet in de opgegeven regio

Omdat sommige versies van Dapr niet in alle regio's beschikbaar zijn, wordt mogelijk het volgende foutbericht weergegeven:

(ExtensionTypeRegistrationGetFailed) Extensietype microsoft.dapr is niet geregistreerd in region <regionname>.

Code: ExtensionTypeRegistrationGetFailed

Bericht: Extensietype microsoft.dapr is niet geregistreerd in region <regionname>

Oplossing 3: Installeren in een andere regio

Installeer in een regio waarin uw Dapr-versie wordt ondersteund.

Scenario 4: Dapr is al geïnstalleerd

U probeert de Dapr-extensie voor AKS of Arc voor Kubernetes te installeren, maar u ontvangt een foutbericht dat aangeeft dat de dapr-system naamruimte al bestaat. Dit foutbericht lijkt op de volgende tekst:

(ExtensionOperationFailed) De extensiebewerking is mislukt met de volgende fout: Fout: {kan grafiek niet installeren vanaf pad [] voor release [dapr-ext]: fout [weergegeven manifesten bevatten een resource die al bestaat. Kan niet doorgaan met installeren: ServiceAccount "dapr-operator" in naamruimte "dapr-system" bestaat en kan niet worden geïmporteerd in de huidige release: ongeldige metagegevens van eigendom; fout bij aantekeningsvalidatie: sleutel 'meta.helm.sh/release-name' moet gelijk zijn aan 'dapr-ext': huidige waarde is 'dapr']} opgetreden tijdens het uitvoeren van de bewerking: {De extensie installeren} op de configuratie

Oplossing 4: Dapr OSS eerst verwijderen

Verwijder de Dapr OSS voordat u de Dapr-extensie installeert. Zie Migreren van Dapr OSS naar de Dapr-extensie voor AKS voor meer informatie.

Scenario 5: De pod van de plaatsingsserver heeft een slechte status

De volgende fout wordt weergegeven:

0/4 knooppunten zijn beschikbaar: 1 knooppunt(en) waren niet gepland, 3 knooppunten hadden een volume-knooppuntaffiniteitsconflict. voorrang: 0/4 knooppunten zijn beschikbaar: 4 Voorrang is niet nuttig voor het plannen.

Dit probleem kan optreden wanneer de plaatsingsserverpod probeert het permanente volume te gebruiken dat is gemaakt in een andere zone dan de plaatsingsserverpod zelf.

Oplossing 5: Dapr installeren in meerdere beschikbaarheidszones of de plaatsingsservice beperken tot een bepaalde beschikbaarheidszone

U kunt dit probleem op een van de volgende manieren oplossen:

Volg de aanbevolen aanpak in Dapr installeren in meerdere beschikbaarheidszones in de hoge-beschikbaarheidsmodus.

Beperk de plaatsingsservice tot een bepaalde beschikbaarheidszone door een aangepaste opslagklasse te maken en deze te gebruiken voor de plaatsingsservice en voer vervolgens de volgende opdracht uit:

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 volgt een voorbeeld van het maken van een aangepaste opslagklasse:

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

Volgende stappen

Als u nog steeds installatieproblemen ondervindt, raadpleegt u de handleiding voor probleemoplossing van AKS en de handleiding voor het oplossen van problemen met Dapr OSS.

Disclaimerinformatie van derden

De producten van derden die in dit artikel worden vermeld, worden vervaardigd door bedrijven die onafhankelijk zijn van Microsoft. Microsoft verleent dan ook geen enkele garantie, impliciet noch anderszins, omtrent de prestaties of de betrouwbaarheid van deze producten.

Contacteer ons voor hulp

Als u vragen hebt of hulp nodig hebt, maak een ondersteuningsaanvraag of vraag de Azure-communityondersteuning. U kunt ook productfeedback verzenden naar de Feedback-community van Azure.

Delen via