De Dapr-extensie voor Azure Kubernetes Service (AKS) en Kubernetes met Arc installeren

Dapr vereenvoudigt het bouwen van veerkrachtige, staatloze en stateful applicaties die gedraaid worden in de cloud en edge en de diversiteit van programmeertalen en ontwikkelaarsframeworks omarmen. Met de sidecar-architectuur van Dapr kunt u uw codeplatform agnostisch houden terwijl u uitdagingen aanpakt voor het bouwen van microservices, zoals:

Andere services betrouwbaar en veilig aanroepen
Gebeurtenisgestuurde apps bouwen met pub/sub
Toepassingen bouwen die overdraagbaar zijn over meerdere cloudservices en hosts (bijvoorbeeld Kubernetes versus een virtuele machine)

Notitie

Als u van plan bent om Dapr te installeren in een Kubernetes-productieomgeving, raadpleegt u de pagina met Dapr-richtlijnen voor productiegebruik.

Hoe het werkt

De Dapr-extensie maakt gebruik van de Azure CLI of een Bicep-sjabloon om het Dapr-besturingsvlak in te richten op uw AKS- of Kubernetes-cluster met Arc, waarmee de volgende Dapr-services worden gemaakt:

Daprservice	Beschrijving
`dapr-operator`	Beheert onderdeelupdates en Kubernetes-service-eindpunten voor Dapr (statusopslagplaatsen, pub/subs, enzovoort)
`dapr-sidecar-injector`	Injecteert Dapr in geannoteerde implementatiepods en voegt de omgevingsvariabelen `DAPR_HTTP_PORT` toe en `DAPR_GRPC_PORT` stelt door de gebruiker gedefinieerde toepassingen in staat om eenvoudig te communiceren met Dapr zonder vaste dapr-poortwaarden.
`dapr-placement`	Alleen gebruikt voor acteurs. Hiermee maakt u toewijzingstabellen die actorinstanties aan pods koppelen.
`dapr-sentry`	Beheert mTLS tussen services en fungeert als certificeringsinstantie. Lees het beveiligingsoverzicht voor meer informatie.

Zodra Dapr op uw cluster is geïnstalleerd, kunt u beginnen met ontwikkelen met behulp van de Api's voor dapr-bouwstenen door enkele aantekeningen toe te voegen aan uw implementaties. Zie het overzicht van dapr-bouwstenen voor een uitgebreider overzicht van de bouwstenen-API's en hoe u deze het beste kunt gebruiken.

Waarschuwing

Als u Dapr installeert via de Kubernetes-extensie met AKS of Arc, is het raadzaam om de extensie te blijven gebruiken voor toekomstig beheer van Dapr in plaats van de Dapr CLI. Het combineren van de twee hulpprogramma's kan conflicten veroorzaken en leiden tot ongewenst gedrag.

Vereisten

Een Azure-abonnement. Heb je er geen? Maak een gratis account.
De nieuwste versie van de Azure CLI.
Een bestaand AKS-cluster of een verbonden Kubernetes-cluster met Arc.
Een rol voor beheer van op rollen gebaseerd toegangsbeheer voor Azure Kubernetes Service

Selecteer hoe u de Dapr-extensie wilt installeren, implementeren en configureren.

Azure-CLI
Biceps

Voordat u begint

De Azure CLI-extensie voor clusterextensies toevoegen

Installeer de k8s-extension Azure CLI-extensie door de volgende opdrachten uit te voeren:

az extension add --name k8s-extension

Als de extensie al is geïnstalleerd, kunt u deze k8s-extension bijwerken naar de nieuwste versie met behulp van de volgende opdracht:

az extension update --name k8s-extension

`KubernetesConfiguration` De resourceprovider registreren

Als u nog geen clusterextensies gebruikt, moet u mogelijk de resourceprovider registreren bij uw abonnement. U kunt de status van de providerregistratie controleren met behulp van de opdracht az provider list , zoals wordt weergegeven in het volgende voorbeeld:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

De Microsoft.KubernetesConfiguration-provider moet als Geregistreerd rapporteren, zoals wordt weergegeven in de volgende voorbeelduitvoer:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Als de provider wordt weergegeven als NotRegistered, registreert u de provider met behulp van het az-providerregister , zoals wordt weergegeven in het volgende voorbeeld:

az provider register --namespace Microsoft.KubernetesConfiguration

`ExtensionTypes` De functie registreren bij uw Azure-abonnement

De ExtensionTypes functie moet worden geregistreerd bij uw Azure-abonnement. Controleer in de terminal of u het juiste abonnement hebt:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Registreer de ExtensionTypes functie.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Het registreren van functies kan enige tijd duren. Controleer na enkele minuten de registratiestatus met behulp van de volgende opdracht:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

De extensie maken en Dapr installeren op uw AKS- of Kubernetes-cluster met Arc

Wanneer u de Dapr-extensie installeert, gebruikt u de vlagwaarde die overeenkomt met uw clustertype:

AKS-cluster: --cluster-type managedClusters.
Arc-ingeschakelde Kubernetes-cluster: --cluster-type connectedClusters.

Notitie

Als u Dapr OSS op uw AKS-cluster gebruikt en de Dapr-extensie voor AKS wilt installeren, leest u meer over het migreren naar de Dapr-extensie.

Maak de Dapr-extensie, waarmee Dapr wordt geïnstalleerd op uw AKS- of Kubernetes-cluster met Arc.

Installeer bijvoorbeeld de nieuwste versie van Dapr via de Dapr-extensie op uw AKS-cluster:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false

Uw beheerde AKS-cluster bijgewerkt houden naar de nieuwste versie

Op basis van uw omgeving (dev, test of productie) kunt u up-to-date blijven met de nieuwste stabiele Dapr-versies.

Een releasetrein kiezen

Wanneer u de extensie configureert, kunt u Ervoor kiezen om Dapr te installeren vanuit een bepaalde releasetrein. Geef één van de twee release-treinwaarden op:

Waarde	Beschrijving
`stable`	Standaard.
`dev`	Vroege releases die experimentele functies kunnen bevatten. Niet geschikt voor productie.

Voorbeeld:

--release-train stable

Automatische updates configureren voor het Dapr-besturingsvlak

Waarschuwing

Automatische upgrade is niet geschikt voor productieomgevingen. Schakel automatische updates alleen in voor het Dapr-besturingsvlak in ontwikkel- of testomgevingen. Meer informatie over het handmatig upgraden naar de nieuwste Dapr-versie voor productieomgevingen.

Als u Dapr installeert zonder een versie op te geven, --auto-upgrade-minor-versionwordt automatisch ingeschakeld, waarbij het Dapr-controlevlak wordt geconfigureerd om automatisch zijn minor-versie bij te werken bij nieuwe releases.

U kunt automatisch bijwerken uitschakelen door de --auto-upgrade-minor-version parameter op te geven en de waarde in te stellen op false.

Dapr-versiebeheer heeft MAJOR.MINOR.PATCH formaat, wat betekent 1.11.01.12.0 dat het een kleine versie-upgrade is.

--auto-upgrade-minor-version true

Bekijk de nieuwste stabiele Dapr-versies die beschikbaar zijn

Als u een upgrade wilt uitvoeren naar de nieuwste Dapr-versie in een productieomgeving, moet u handmatig een upgrade uitvoeren. Bekijk eerst een lijst met de stabiele Dapr-versies die beschikbaar zijn voor uw beheerde AKS-cluster. Voer de volgende opdracht uit:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr --release-train stable

Voer de volgende opdracht uit om de meest recente stabiele Dapr-versie te zien die beschikbaar is voor uw beheerde AKS-cluster:

az k8s-extension extension-types list-versions-by-cluster --resource-group <myResourceGroup> --cluster-name <myCluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

Een lijst weergeven met de stabiele Dapr-versies die beschikbaar zijn op locatie:

Zorg ervoor dat u de ExtensionTypes functie hebt geregistreerd bij uw Azure-abonnement.
Voer de volgende opdracht uit.

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Werk vervolgens Dapr handmatig bij naar de nieuwste stabiele versie.

Richten op een specifieke Dapr-versie

Notitie

Dapr wordt ondersteund met een rollend venster, waarbij alleen de huidige en vorige versies zijn inbegrepen. Het is uw operationele verantwoordelijkheid om up-to-date te blijven met deze ondersteunde versies. Als u een oudere versie van Dapr hebt, moet u mogelijk tussenliggende upgrades uitvoeren om naar een ondersteunde versie te gaan.

Hetzelfde opdrachtregelargument wordt gebruikt voor het installeren van een specifieke versie van Dapr of het terugdraaien naar een eerdere versie. Stel --auto-upgrade-minor-version in op false en --version op de versie van Dapr die u wilt installeren. Als de version parameter wordt weggelaten, installeert de extensie de nieuwste versie van Dapr. Met de volgende voorbeeldopdracht wordt de Dapr-versie 1.14.4-msft.10 op uw AKS-cluster geïnstalleerd:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <myAKSCluster> \
--resource-group <myResourceGroup> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.14.4-msft.10

Voordat u begint

`KubernetesConfiguration` De resourceprovider registreren

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

De Microsoft.KubernetesConfiguration-provider moet als Geregistreerd rapporteren, zoals wordt weergegeven in de volgende voorbeelduitvoer:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Als de provider wordt weergegeven als NotRegistered, registreert u de provider met behulp van het az-providerregister , zoals wordt weergegeven in het volgende voorbeeld:

az provider register --namespace Microsoft.KubernetesConfiguration

`ExtensionTypes` De functie registreren bij uw Azure-abonnement

De ExtensionTypes functie moet worden geregistreerd bij uw Azure-abonnement. Controleer in de terminal of u het juiste abonnement hebt:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Registreer de ExtenstionTypes functie.

az feature registration create --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Het registreren van functies kan enige tijd duren. Controleer na enkele minuten de registratiestatus met behulp van de volgende opdracht:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

De Dapr-extensie implementeren op uw Kubernetes-cluster met AKS of Arc

Maak een Bicep-sjabloon die vergelijkbaar is met het volgende voorbeeld en implementeer de Dapr-extensie in uw bestaande cluster.

@description('The name of the Managed Cluster resource.')
param clusterName string

resource existingManagedClusters 'Microsoft.ContainerService/managedClusters@2023-05-02-preview' existing = {
  name: clusterName
}

resource daprExtension 'Microsoft.KubernetesConfiguration/extensions@2022-11-01' = {
  name: 'dapr'
  scope: existingManagedClusters
  identity: {
    type: 'SystemAssigned'
  }
  properties: {
    autoUpgradeMinorVersion: true
    configurationProtectedSettings: {}
    configurationSettings: {
      'global.clusterType': 'managedclusters'
    }
    extensionType: 'microsoft.dapr'
    releaseTrain: 'stable'
    scope: {
      cluster: {
        releaseNamespace: 'dapr-system'
      }
    }
    version: '1.11.2'
  }
}

Stel de variabelen hieronder in door de waarden te wijzigen naar de werkelijke namen van uw resourcegroep en cluster.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Implementeer de Bicep-sjabloon met behulp van de az deployment group opdracht.

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Automatische updates configureren voor het Dapr-besturingsvlak

Waarschuwing

U kunt automatische updates voor het Dapr-besturingsvlak alleen in ontwikkel- of testomgevingen inschakelen. Automatische upgrade is niet geschikt voor productieomgevingen.

Als u Dapr implementeert zonder een versie op te geven, autoUpgradeMinorVersionwordt deze automatisch ingeschakeld en configureert u het Dapr-besturingsvlak om de secundaire versie automatisch bij te werken in nieuwe releases.

U kunt automatisch bijwerken uitschakelen door de autoUpgradeMinorVersion parameter op te geven en de waarde in te stellen op false.

Dapr-versiebeheer heeft MAJOR.MINOR.PATCH formaat, wat betekent 1.11.01.12.0 dat het een kleine versie-upgrade is.

properties {
  autoUpgradeMinorVersion: true
}

Richten op een specifieke Dapr-versie

Notitie

Stel autoUpgradeMinorVersion in op false en version op de versie van Dapr die u wilt installeren. Als de autoUpgradeMinorVersion parameter is ingesteld op trueen version parameter wordt weggelaten, installeert de extensie de nieuwste versie van Dapr.

Als u bijvoorbeeld Dapr 1.11.2 wilt gebruiken:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Een releasetrein kiezen

Wanneer u de extensie configureert, kunt u Ervoor kiezen om Dapr te installeren vanuit een bepaalde releasetrein. Geef één van de twee release-treinwaarden op:

Waarde	Beschrijving
`stable`	Standaard.
`dev`	Vroege releases die experimentele functies kunnen bevatten. Niet geschikt voor productie.

Voorbeeld:

properties: {
  releaseTrain: 'stable'
}

Probleemoplossingsproces

Problemen met extensiebeheer oplossen

Als het maken of bijwerken van de extensie mislukt, kunt u suggesties en oplossingen proberen in de handleiding voor het oplossen van problemen met de Dapr-extensie.

Problemen met functionele Dapr-fouten oplossen

Los opensource-fouten met Dapr op die niet gerelateerd zijn aan de extensie via de algemene Dapr-problemen en -oplossingenhandleiding.

Ondersteuning

Notitie

Meer informatie over hoe Microsoft problemen verwerkt die zijn opgebracht voor de Dapr-extensie.

Als u beveiligingsrisico's en regressies van Dapr-runtime ondervindt tijdens het gebruik van de extensie, opent u een probleem met het opensource-project Dapr.

U kunt ook een discussie starten in het Dapr-project Discord:

De Dapr-extensie verwijderen uit uw cluster

Bij het verwijderen van de Dapr-extensie van AKS worden de CRD's die tijdens de installatie zijn gemaakt, niet verwijderd. Deze CRDs blijven in het cluster als residuele componenten, essentieel voor de synchronisatiefunctie tijdens de installatie en verwijdering van de extensie.

Als u het cluster van deze CRD's wilt opschonen, kunt u ze handmatig verwijderen nadat de Dapr-extensie volledig is verwijderd uit AKS.

De extensie verwijderen

Verwijder de extensie uit uw AKS-cluster met behulp van de volgende opdracht:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Als u een Bicep-sjabloon gebruikt, kunt u de sjabloon ook verwijderen.

De CRD's in uw cluster weergeven

Voer de volgende opdracht uit om de CRD's te vinden die u wilt verwijderen:

kubectl get crds | findstr dapr.io

Volgende stappen

De Dapr-extensie configureren voor uw unieke scenario

Feedback

Is deze pagina nuttig?

Last updated on 2025-10-30

Delen via

De Dapr-extensie voor Azure Kubernetes Service (AKS) en Kubernetes met Arc installeren

Hoe het werkt

Vereisten

Voordat u begint

De Azure CLI-extensie voor clusterextensies toevoegen

KubernetesConfiguration De resourceprovider registreren

ExtensionTypes De functie registreren bij uw Azure-abonnement

De extensie maken en Dapr installeren op uw AKS- of Kubernetes-cluster met Arc

Uw beheerde AKS-cluster bijgewerkt houden naar de nieuwste versie

Een releasetrein kiezen

Automatische updates configureren voor het Dapr-besturingsvlak

Bekijk de nieuwste stabiele Dapr-versies die beschikbaar zijn

Richten op een specifieke Dapr-versie

Probleemoplossingsproces

Problemen met extensiebeheer oplossen

Problemen met functionele Dapr-fouten oplossen

Ondersteuning

De Dapr-extensie verwijderen uit uw cluster

De extensie verwijderen

De CRD's in uw cluster weergeven

Volgende stappen

Feedback

Aanvullende resources

`KubernetesConfiguration` De resourceprovider registreren

`ExtensionTypes` De functie registreren bij uw Azure-abonnement