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

  • Artikel

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)

Om du använder Dapr-tillägget för att etablera Dapr på ditt AKS- eller Arc-aktiverade Kubernetes-kluster eliminerar du kostnaderna för:

  • Ladda ned Dapr-verktyg
  • Installera och hantera körningen manuellt i AKS-klustret

Tillägget har dessutom stöd för alla inbyggda Dapr-konfigurationsfunktioner via enkla kommandoradsargument.

Kommentar

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

Så här fungerar det

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

Dapr-tjänst Description
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.

Stöds för närvarande

Dapr-versioner

Stöd för Dapr-tillägg varierar beroende på hur du hanterar körningen.

Självhanterad
För självhanterad körning stöder Dapr-tillägget:

Självhanterad körning kräver manuell uppgradering för att finnas kvar i supportfönstret. Om du vill uppgradera Dapr via tillägget följer du anvisningarna för instansen av uppdateringstillägget.

Automatisk uppgradering
När du aktiverar automatisk uppgradering uppdateras Dapr-tillägget till den senaste delversionen. Du kan uppleva icke-bakåtkompatibla ändringar mellan uppdateringar.

Komponenter

Azure + öppen källkod-komponenter stöds. Alfa- och betakomponenter stöds med bästa förmåga.

Moln/regioner

Globalt Azure-moln stöds med Arc-stöd i följande regioner:

Region AKS-stöd Stöd för Arc for Kubernetes
australiaeast ✔️ ✔️
australiasoutheast ✔️ ❌
brazilsouth ✔️ ❌
canadacentral ✔️ ✔️
canadaeast ✔️ ✔️
centralindia ✔️ ✔️
centralus ✔️ ✔️
eastasia ✔️ ✔️
eastus ✔️ ✔️
eastus2 ✔️ ✔️
eastus2euap ❌ ✔️
francecentral ✔️ ✔️
francesouth ✔️ ❌
germanywestcentral ✔️ ✔️
japaneast ✔️ ✔️
japanwest ✔️ ❌
koreacentral ✔️ ✔️
koreasouth ✔️ ❌
northcentralus ✔️ ✔️
northeurope ✔️ ✔️
norwayeast ✔️ ❌
southafricanorth ✔️ ❌
southcentralus ✔️ ✔️
southeastasia ✔️ ✔️
southindia ✔️ ❌
swedencentral ✔️ ✔️
switzerlandnorth ✔️ ✔️
uaenorth ✔️ ❌
uksouth ✔️ ✔️
ukwest ✔️ ❌
westcentralus ✔️ ✔️
westeurope ✔️ ✔️
westus ✔️ ✔️
westus2 ✔️ ✔️
westus3 ✔️ ✔️

Förutsättningar

Konfigurera 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 tjänstleverantören

Om du inte tidigare har använt klustertillägg kan du behöva registrera tjänstleverantören med din prenumeration. Du kan kontrollera statusen för providerregistreringen med kommandot [az provider list][az-provider-list] enligt 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

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

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 X.X.X:

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

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 installerar Dapr utan att ange en version --auto-upgrade-minor-versionaktiveras 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

Välja ett versionståg

När du konfigurerar tillägget kan du välja att installera Dapr från en viss --release-train. Ange något av de två versionstågsvärdena:

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

Till exempel:

--release-train 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

Nästa steg