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

Dapr vereenvoudigt het bouwen van tolerante, staatloze en stateful toepassingen die worden uitgevoerd in de cloud en rand en de diversiteit van talen en frameworks voor ontwikkelaars 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 VM)

Notitie

Als u van plan bent Dapr te installeren in een Kubernetes-productieomgeving, raadpleegt u de pagina Met dapr-richtlijnen voor documentatie over 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:

Dapr-service	Beschrijving
dapr-operator	Beheert onderdeelupdates en Kubernetes-services-eindpunten voor Dapr (statusarchieven, 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 toewijzen aan pods.
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.
• Installeer de nieuwste versie van de Azure CLI.
• Als u er nog geen hebt, moet u een AKS-cluster maken of een Kubernetes-cluster met Arc verbinden.
• Zorg ervoor dat u een RBAC-Beheer-rol voor Azure Kubernetes Service hebt

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

Azure-CLI

De Azure CLI-extensie instellen voor clusterextensies

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 hebt 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][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

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.
• Kubernetes-cluster met Arc: --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

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 installeert zonder een versie op te geven, --auto-upgrade-minor-versionwordt 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 --auto-upgrade-minor-version parameter op te geven en de waarde in te stellen op false.

Dapr-versiebeheer heeft MAJOR.MINOR.PATCH een indeling, wat betekent 1.12.01.11.0 dat het een secundaire versie-upgrade is.

--auto-upgrade-minor-version true

Een specifieke Dapr-versie instellen

Notitie

Dapr wordt ondersteund met een doorlopend venster, inclusief alleen de huidige en vorige versies. 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. Ingesteld --auto-upgrade-minor-version 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. Als u bijvoorbeeld Dapr 1.11.2 wilt gebruiken:

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.11.2

Een releasetrein kiezen

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

Weergegeven als	Beschrijving
stable	Standaard.
dev	Vroege releases kunnen experimentele functies bevatten. Niet geschikt voor productie.

Voorbeeld:

--release-train stable

Bicep

KubernetesConfiguration De resourceprovider registreren

Als u nog geen clusterextensies hebt 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][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

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

Maak een Bicep-sjabloon die vergelijkbaar is met het volgende voorbeeld om de Dapr-extensie te implementeren 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 volgende variabelen in en wijzig de onderstaande waarden in uw werkelijke resourcegroep en clusternamen.

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 een indeling, wat betekent 1.12.01.11.0 dat het een secundaire versie-upgrade is.

properties {
  autoUpgradeMinorVersion: true
}

Een specifieke Dapr-versie instellen

Notitie

Dapr wordt ondersteund met een doorlopend venster, inclusief alleen de huidige en vorige versies. 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.

Ingesteld autoUpgradeMinorVersion 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 een van de twee release trainwaarden op:

Weergegeven als	Beschrijving
stable	Standaard.
dev	Vroege releases kunnen experimentele functies bevatten. Niet geschikt voor productie.

Voorbeeld:

properties: {
  releaseTrain: 'stable'
}

Extensiefouten 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 Dapr oplossen

Los Dapr-fouten op via de veelvoorkomende Problemen en oplossingen voor Dapr.

De extensie verwijderen

Als u de extensie wilt verwijderen en Dapr uit uw AKS-cluster wilt verwijderen, kunt u de volgende opdracht gebruiken:

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

Of verwijder gewoon de Bicep-sjabloon.

Volgende stappen

• Meer informatie over extra instellingen en voorkeuren die u kunt instellen voor de Dapr-extensie.
• Nadat u Dapr hebt ingericht in uw AKS-cluster, kunt u een voorbeeldtoepassing implementeren.
• Dapr Workflow uitproberen in uw Dapr-extensie voor AKS