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

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 virtuele machine)

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.
• De nieuwste versie van de Azure CLI.
• Een bestaand AKS-cluster of een verbonden Kubernetes-cluster met Arc.
• Een op rollen gebaseerd toegangsbeheer voor Azure Kubernetes Service

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

Azure-CLI

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

ExtenstionTypes 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 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

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

Weergegeven als	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-version wordt 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.0 1.11.0 dat het een secundaire 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:

1. Zorg ervoor dat u de ExtenstionTypes functie hebt geregistreerd bij uw Azure-abonnement.
2. 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.

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

Bicep

Voordat u begint

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

ExtenstionTypes 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 volgende variabelen in en wijzig de volgende waarden in de 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, autoUpgradeMinorVersion wordt 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.0 1.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 die experimentele functies kunnen 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

U kunt ook de Bicep-sjabloon verwijderen.

Volgende stappen

De Dapr-extensie configureren voor uw unieke scenario