Installera Dapr-tillägget för Azure Kubernetes Service (AKS) och Arc-aktiverade Kubernetes

Dapr förenklar skapandet av motståndskraftiga, tillståndslösa och tillståndskänsliga program som körs i molnet och gränsen och omfattar mångfalden av språk och utvecklarramverk. Med Daprs sidovagnsarkitektur kan du hålla din kodplattform agnostisk samtidigt som du hanterar utmaningar med att skapa mikrotjänster, till exempel:

• Anropa andra tjänster på ett tillförlitligt och säkert sätt
• Skapa händelsedrivna appar med pub/sub
• Skapa program som är portabla över flera molntjänster och värdar (till exempel Kubernetes jämfört med en virtuell dator)

Kommentar

Om du planerar att installera Dapr i en Kubernetes-produktionsmiljö kan du läsa dokumentationssidan för Dapr-riktlinjer för produktionsanvändning .

Hur det fungerar

Dapr-tillägget använder Azure CLI eller en Bicep-mall för att etablera Dapr-kontrollplanet på ditt AKS- eller Arc-aktiverade Kubernetes-kluster och skapar följande Dapr-tjänster:

Dapr-tjänst	beskrivning
dapr-operator	Hanterar komponentuppdateringar och Kubernetes-tjänstslutpunkter för Dapr (tillståndslager, pub/subs osv.)
dapr-sidecar-injector	Matar in Dapr i kommenterade distributionspoddar och lägger till miljövariablerna DAPR_HTTP_PORT och DAPR_GRPC_PORT gör det möjligt för användardefinierade program att enkelt kommunicera med Dapr utan hårdkodande Dapr-portvärden.
dapr-placement	Används endast för skådespelare. Skapar mappningstabeller som mappar aktörsinstanser till poddar.
dapr-sentry	Hanterar mTLS mellan tjänster och fungerar som certifikatutfärdare. Mer information finns i säkerhetsöversikten.

När Dapr har installerats i klustret kan du börja utveckla med hjälp av API:erna för Dapr-byggblock genom att lägga till några anteckningar i dina distributioner. En mer detaljerad översikt över byggblocks-API:er och hur du använder dem på bästa sätt finns i översikten över Dapr-byggblock.

Varning

Om du installerar Dapr via AKS- eller Arc-aktiverade Kubernetes-tillägget rekommenderar vi att du fortsätter att använda tillägget för framtida hantering av Dapr i stället för Dapr CLI. Att kombinera de två verktygen kan orsaka konflikter och leda till oönskade beteenden.

Förutsättningar

• En Azure-prenumeration. Har du ingen? Skapa ett kostnadsfritt konto.
• Den senaste versionen av Azure CLI.
• Ett befintligt AKS-kluster eller ett anslutet Arc-aktiverat Kubernetes-kluster.
• Rollbaserad administratörsroll för Azure Kubernetes-tjänsten

Välj hur du vill installera, distribuera och konfigurera Dapr-tillägget.

Azure CLI

Innan du börjar

Lägga till Azure CLI-tillägget för klustertillägg

k8s-extension Installera Azure CLI-tillägget genom att köra följande kommandon:

az extension add --name k8s-extension

k8s-extension Om tillägget redan är installerat kan du uppdatera det till den senaste versionen med hjälp av följande kommando:

az extension update --name k8s-extension

KubernetesConfiguration Registrera resursprovidern

Om du inte redan använder klustertillägg kan du behöva registrera resursprovidern med din prenumeration. Du kan kontrollera statusen för providerregistreringen med kommandot az provider list , som du ser i följande exempel:

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

Microsoft.KubernetesConfiguration-providern bör rapportera som Registrerad, enligt följande exempelutdata:

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

Om providern visas som NotRegistered registrerar du providern med hjälp av az providerregistret enligt följande exempel:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrera funktionen i ExtenstionTypes din Azure-prenumeration

Funktionen ExtensionTypes måste vara registrerad på din Azure-prenumeration. Kontrollera att du har rätt prenumeration i terminalen:

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

Registrera funktionen ExtenstionTypes .

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

Det kan ta lite tid att registrera funktionen. Efter några minuter kontrollerar du registreringsstatusen med hjälp av följande kommando:

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

Skapa tillägget och installera Dapr i ditt AKS- eller Arc-aktiverade Kubernetes-kluster

När du installerar Dapr-tillägget använder du det flaggvärde som motsvarar din klustertyp:

• AKS-kluster: --cluster-type managedClusters.
• Arc-aktiverat Kubernetes-kluster: --cluster-type connectedClusters.

Kommentar

Om du använder Dapr OSS i aks-klustret och vill installera Dapr-tillägget för AKS kan du läsa mer om hur du migrerar till Dapr-tillägget.

Skapa Dapr-tillägget som installerar Dapr på ditt AKS- eller Arc-aktiverade Kubernetes-kluster.

Installera till exempel den senaste versionen av Dapr via Dapr-tillägget i AKS-klustret:

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

Håll ditt hanterade AKS-kluster uppdaterat till den senaste versionen

Baserat på din miljö (utveckling, testning eller produktion) kan du hålla dig uppdaterad med de senaste stabila Dapr-versionerna.

Välja ett versionståg

När du konfigurerar tillägget kan du välja att installera Dapr från ett visst versionståg. Ange något av de två versionstågsvärdena:

Värde	beskrivning
stable	Standard.
dev	Tidiga versioner som kan innehålla experimentella funktioner. Inte lämplig för produktion.

Till exempel:

--release-train stable

Konfigurera automatiska uppdateringar av Dapr-kontrollplanet

Varning

Automatisk uppgradering är inte lämplig för produktionsmiljöer. Aktivera endast automatiska uppdateringar av Dapr-kontrollplanet i utvecklings- eller testmiljöer. Lär dig hur du manuellt uppgraderar till den senaste Dapr-versionen för produktionsmiljöer.

Om du installerar Dapr utan att ange en version --auto-upgrade-minor-version aktiveras automatiskt, konfigurerar du Dapr-kontrollplanet för att automatiskt uppdatera dess delversion på nya versioner.

Du kan inaktivera automatisk uppdatering genom att ange parametern --auto-upgrade-minor-version och ange värdet till false.

Dapr-versionshantering är i MAJOR.MINOR.PATCH format, vilket innebär 1.11.0 att 1.12.0 är en delversionsuppgradering .

--auto-upgrade-minor-version true

Visa de senaste stabila Tillgängliga Dapr-versionerna

Om du vill uppgradera till den senaste Dapr-versionen i en produktionsmiljö måste du uppgradera manuellt. Börja med att visa en lista över stabila Dapr-versioner som är tillgängliga för ditt hanterade AKS-kluster. Kör följande kommando:

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

Kör följande kommando för att se den senaste stabila Dapr-versionen som är tillgänglig för ditt hanterade AKS-kluster:

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

Så här visar du en lista över stabila Dapr-versioner som är tillgängliga efter plats:

1. Kontrollera att du har registrerat funktionen i ExtenstionTypes din Azure-prenumeration.
2. Kör följande kommando.

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

Uppdatera sedan Dapr manuellt till den senaste stabila versionen.

Rikta in sig på en specifik Dapr-version

Kommentar

Dapr stöds med ett rullande fönster, inklusive endast aktuella och tidigare versioner. Det är ditt operativa ansvar att hålla dig uppdaterad med dessa versioner som stöds. Om du har en äldre version av Dapr kan du behöva göra mellanliggande uppgraderingar för att komma till en version som stöds.

Samma kommandoradsargument används för att installera en viss version av Dapr eller återställa till en tidigare version. Ange --auto-upgrade-minor-version till false och --version till den version av Dapr som du vill installera. Om parametern version utelämnas installerar tillägget den senaste versionen av Dapr. Om du till exempel vill använda Dapr 1.13.5:

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

Innan du börjar

KubernetesConfiguration Registrera resursprovidern

Om du inte redan använder klustertillägg kan du behöva registrera resursprovidern med din prenumeration. Du kan kontrollera statusen för providerregistreringen med kommandot az provider list , som du ser i följande exempel:

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

Microsoft.KubernetesConfiguration-providern bör rapportera som Registrerad, enligt följande exempelutdata:

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

Om providern visas som NotRegistered registrerar du providern med hjälp av az providerregistret enligt följande exempel:

az provider register --namespace Microsoft.KubernetesConfiguration

Registrera funktionen i ExtenstionTypes din Azure-prenumeration

Funktionen ExtensionTypes måste vara registrerad på din Azure-prenumeration. Kontrollera att du har rätt prenumeration i terminalen:

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

Registrera funktionen ExtenstionTypes .

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

Det kan ta lite tid att registrera funktionen. Efter några minuter kontrollerar du registreringsstatusen med hjälp av följande kommando:

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

Distribuera Dapr-tillägget i ditt AKS- eller Arc-aktiverade Kubernetes-kluster

Skapa en Bicep-mall som liknar följande exempel och distribuera Dapr-tillägget till ditt befintliga kluster.

@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'
  }
}

Ange följande variabler och ändra följande värden till din faktiska resursgrupp och klusternamn.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Distribuera Bicep-mallen med kommandot az deployment group .

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

Konfigurera automatiska uppdateringar av Dapr-kontrollplanet

Varning

Du kan endast aktivera automatiska uppdateringar av Dapr-kontrollplanet i utvecklings- eller testmiljöer. Automatisk uppgradering är inte lämplig för produktionsmiljöer.

Om du distribuerar Dapr utan att ange en version autoUpgradeMinorVersion aktiveras automatiskt, konfigurerar du Dapr-kontrollplanet för att automatiskt uppdatera dess delversion på nya versioner.

Du kan inaktivera automatisk uppdatering genom att ange parametern autoUpgradeMinorVersion och ange värdet till false.

Dapr-versionshantering är i MAJOR.MINOR.PATCH format, vilket innebär 1.11.0 att 1.12.0 är en delversionsuppgradering .

properties {
  autoUpgradeMinorVersion: true
}

Rikta in sig på en specifik Dapr-version

Kommentar

Dapr stöds med ett rullande fönster, inklusive endast aktuella och tidigare versioner. Det är ditt operativa ansvar att hålla dig uppdaterad med dessa versioner som stöds. Om du har en äldre version av Dapr kan du behöva göra mellanliggande uppgraderingar för att komma till en version som stöds.

Ange autoUpgradeMinorVersion till false och version till den version av Dapr som du vill installera. Om parametern autoUpgradeMinorVersion är inställd på true, och version parametern utelämnas, installerar tillägget den senaste versionen av Dapr.

Om du till exempel vill använda Dapr 1.11.2:

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

Välja ett versionståg

När du konfigurerar tillägget kan du välja att installera Dapr från ett visst versionståg. Ange något av de två versionstågsvärdena:

Värde	beskrivning
stable	Standard.
dev	Tidiga versioner som kan innehålla experimentella funktioner. Inte lämplig för produktion.

Till exempel:

properties: {
  releaseTrain: 'stable'
}

Felsöka tilläggsfel

Om tillägget inte kan skapa eller uppdatera kan du prova förslag och lösningar i felsökningsguiden för Dapr-tillägget.

Felsöka Dapr

Felsöka Dapr-fel via den vanliga dapr-problem- och lösningsguiden.

Ta bort tillägget

Om du behöver ta bort tillägget och ta bort Dapr från AKS-klustret kan du använda följande kommando:

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

Du kan också ta bort Bicep-mallen.

Nästa steg

Konfigurera Dapr-tillägget för ditt unika scenario