Rozšíření Dapr pro Azure Kubernetes Service (AKS) a Kubernetes s podporou Arc

Dapr zjednodušuje vytváření odolných, bezstavových a stavových aplikací, které běží na cloudu a hraničních zařízeních a přijímají rozmanitost jazyků a vývojových architektur. Díky architektuře sajdkáru Dapr můžete udržovat platformu kódu nezávislou na řešení problémů souvisejících s vytvářením mikroslužeb, například:

• Spolehlivé a bezpečné volání dalších služeb
• Vytváření aplikací řízených událostmi pomocí pub/sub
• Vytváření aplikací, které jsou přenosné napříč několika cloudovými službami a hostiteli (například Kubernetes a virtuální počítač)

Poznámka:

Pokud plánujete nainstalovat Dapr v produkčním prostředí Kubernetes, přečtěte si pokyny pro dokumentaci k produkčnímu využití Dapr.

Jak to funguje

Rozšíření Dapr používá azure CLI nebo šablonu Bicep ke zřízení řídicí roviny Dapr v clusteru AKS nebo Kubernetes s podporou arc a vytváří následující služby Dapr:

Služba Dapr	Popis
dapr-operator	Spravuje aktualizace komponent a koncové body služeb Kubernetes pro Dapr (úložiště stavů, pub/subs atd.)
dapr-sidecar-injector	Vloží Dapr do podů nasazení s poznámkami a přidá proměnné DAPR_HTTP_PORT prostředí a DAPR_GRPC_PORT umožní uživatelům definovaným aplikacím snadno komunikovat s Dapr bez pevně zakódovaných hodnot portů Dapr.
dapr-placement	Používá se jenom pro aktéry. Vytvoří mapování tabulek, které mapují instance objektu actor na pody.
dapr-sentry	Spravuje mTLS mezi službami a funguje jako certifikační autorita. Další informace najdete v přehledu zabezpečení.

Po instalaci Dapr do clusteru můžete začít vyvíjet pomocí rozhraní API stavebního bloku Dapr přidáním několika poznámek do nasazení. Podrobnější přehled rozhraní API stavebních bloků a jejich nejlepšího použití najdete v přehledu stavebních bloků Dapr.

Upozorňující

Pokud nainstalujete Dapr prostřednictvím rozšíření Kubernetes s podporou AKS nebo Arc, doporučujeme pokračovat v používání rozšíření pro budoucí správu Dapr místo rozhraní příkazového řádku Dapr. Kombinace těchto dvou nástrojů může způsobit konflikty a vést k nežádoucímu chování.

Požadavky

• Předplatné Azure. Nemáte ho? Vytvořte si bezplatný účet.
• Nainstalujte nejnovější verzi Azure CLI.
• Pokud ho ještě nemáte, musíte vytvořit cluster AKS nebo připojit cluster Kubernetes s podporou Arc.
• Ujistěte se, že máte roli RBAC služby Azure Kubernetes Service Správa.

Vyberte, jak chcete nainstalovat, nasadit a nakonfigurovat rozšíření Dapr.

Azure CLI

Nastavení rozšíření Azure CLI pro rozšíření clusteru

k8s-extension Nainstalujte rozšíření Azure CLI spuštěním následujících příkazů:

az extension add --name k8s-extension

k8s-extension Pokud už je rozšíření nainstalované, můžete ho aktualizovat na nejnovější verzi pomocí následujícího příkazu:

az extension update --name k8s-extension

KubernetesConfiguration Registrace poskytovatele prostředků

Pokud jste dříve nepoužívali rozšíření clusteru, možná budete muset zaregistrovat poskytovatele prostředků ve vašem předplatném. Stav registrace zprostředkovatele můžete zkontrolovat pomocí příkazu [az provider list][az-provider-list], jak je znázorněno v následujícím příkladu:

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

Zprostředkovatel Microsoft.KubernetesConfiguration by měl hlásit jako zaregistrovaný, jak je znázorněno v následujícím příkladu výstupu:

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

Pokud se poskytovatel zobrazí jako NotRegistered, zaregistrujte poskytovatele pomocí příkazu az provider register , jak je znázorněno v následujícím příkladu:

az provider register --namespace Microsoft.KubernetesConfiguration

Vytvoření rozšíření a instalace Dapr v clusteru Kubernetes s podporou AKS nebo Arc

Při instalaci rozšíření Dapr použijte hodnotu příznaku odpovídající vašemu typu clusteru:

• Cluster AKS: --cluster-type managedClusters.
• Cluster Kubernetes s podporou arc: --cluster-type connectedClusters.

Poznámka:

Pokud v clusteru AKS používáte operační systém Dapr a chcete nainstalovat rozšíření Dapr pro AKS, přečtěte si další informace o tom, jak úspěšně migrovat na rozšíření Dapr.

Vytvořte rozšíření Dapr, které nainstaluje Dapr do clusteru Kubernetes s podporou služby AKS nebo Arc.

Nainstalujte si například nejnovější verzi Dapr prostřednictvím rozšíření Dapr v clusteru AKS:

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

Konfigurace automatických aktualizací řídicí roviny Dapr

Upozorňující

Automatické aktualizace řídicí roviny Dapr můžete povolit jenom v vývojových nebo testovacích prostředích. Automatický upgrade není vhodný pro produkční prostředí.

Pokud instalujete Dapr bez zadání verze, je automaticky povolená a konfiguruje řídicí rovinu Dapr tak, --auto-upgrade-minor-versionaby automaticky aktualizovala jeho podverzi v nových verzích.

Automatickou aktualizaci můžete zakázat zadáním parametru --auto-upgrade-minor-version a nastavením hodnoty na falsehodnotu .

Správa verzí Dapr je ve MAJOR.MINOR.PATCH formátu, což znamená 1.11.0 , že se jedná 1.12.0 o upgrade podverze .

--auto-upgrade-minor-version true

Cílení na konkrétní verzi Dapr

Poznámka:

Dapr se podporuje s průběžným oknem, včetně pouze aktuálních a předchozích verzí. Je vaší provozní odpovědností zůstat v aktualizovaném stavu s těmito podporovanými verzemi. Pokud máte starší verzi Dapr, možná budete muset provést přechodné upgrady, abyste se dostali k podporované verzi.

Stejný argument příkazového řádku se používá k instalaci konkrétní verze Dapr nebo vrácení zpět na předchozí verzi. Nastavte --auto-upgrade-minor-version na false verzi Dapr, --version kterou chcete nainstalovat. Pokud parametr version vynecháte, rozšíření nainstaluje nejnovější verzi Dapr. Pokud chcete například použít Dapr 1.11.2:

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

Volba trénu vydané verze

Při konfiguraci rozšíření se můžete rozhodnout nainstalovat Dapr z konkrétního trénování vydané verze. Zadejte jednu ze dvou hodnot trénování vydané verze:

Hodnota	Popis
stable	Výchozí.
dev	Dřívější verze můžou obsahovat experimentální funkce. Nehodí se pro výrobu.

Příklad:

--release-train stable

Bicep

KubernetesConfiguration Registrace poskytovatele prostředků

Pokud jste dříve nepoužívali rozšíření clusteru, možná budete muset zaregistrovat poskytovatele prostředků ve vašem předplatném. Stav registrace zprostředkovatele můžete zkontrolovat pomocí příkazu [az provider list][az-provider-list], jak je znázorněno v následujícím příkladu:

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

Zprostředkovatel Microsoft.KubernetesConfiguration by měl hlásit jako zaregistrovaný, jak je znázorněno v následujícím příkladu výstupu:

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

Pokud se poskytovatel zobrazí jako NotRegistered, zaregistrujte poskytovatele pomocí příkazu az provider register , jak je znázorněno v následujícím příkladu:

az provider register --namespace Microsoft.KubernetesConfiguration

Nasazení rozšíření Dapr do clusteru Kubernetes s podporou AKS nebo Arc

Vytvořte šablonu Bicep podobnou následujícímu příkladu pro nasazení rozšíření Dapr do existujícího clusteru.

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

Nastavte následující proměnné a změňte níže uvedené hodnoty na vlastní skupinu prostředků a názvy clusterů.

MY_RESOURCE_GROUP=myResourceGroup
MY_AKS_CLUSTER=myAKScluster

Nasaďte šablonu Bicep pomocí az deployment group příkazu.

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

Konfigurace automatických aktualizací řídicí roviny Dapr

Upozorňující

Automatické aktualizace řídicí roviny Dapr můžete povolit jenom v vývojových nebo testovacích prostředích. Automatický upgrade není vhodný pro produkční prostředí.

Pokud nasadíte Dapr bez zadání verze, automaticky se povolí konfigurace řídicí roviny Dapr tak, autoUpgradeMinorVersionaby automaticky aktualizovala jeho podverzi v nových verzích.

Automatickou aktualizaci můžete zakázat zadáním parametru autoUpgradeMinorVersion a nastavením hodnoty na falsehodnotu .

Správa verzí Dapr je ve MAJOR.MINOR.PATCH formátu, což znamená 1.11.0 , že se jedná 1.12.0 o upgrade podverze .

properties {
  autoUpgradeMinorVersion: true
}

Cílení na konkrétní verzi Dapr

Poznámka:

Dapr se podporuje s průběžným oknem, včetně pouze aktuálních a předchozích verzí. Je vaší provozní odpovědností zůstat v aktualizovaném stavu s těmito podporovanými verzemi. Pokud máte starší verzi Dapr, možná budete muset provést přechodné upgrady, abyste se dostali k podporované verzi.

Nastavte autoUpgradeMinorVersion na false verzi Dapr, version kterou chcete nainstalovat. autoUpgradeMinorVersion Pokud je parametr nastaven na truehodnotu a version parametr je vynechán, rozšíření nainstaluje nejnovější verzi Dapr.

Pokud chcete například použít Dapr 1.11.2:

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

Volba trénu vydané verze

Při konfiguraci rozšíření se můžete rozhodnout nainstalovat Dapr z konkrétního trénování vydané verze. Zadejte jednu ze dvou hodnot trénování vydané verze:

Hodnota	Popis
stable	Výchozí.
dev	Dřívější verze můžou obsahovat experimentální funkce. Nehodí se pro výrobu.

Příklad:

properties: {
  releaseTrain: 'stable'
}

Řešení chyb rozšíření

Pokud se rozšíření nepodaří vytvořit nebo aktualizovat, vyzkoušejte návrhy a řešení v průvodci odstraňováním potíží s rozšířením Dapr.

Řešení potíží s dapr

Při řešení potíží s dapr vyřešte běžné problémy a řešení Dapr.

Odstranění rozšíření

Pokud potřebujete rozšíření odstranit a odebrat Dapr z clusteru AKS, můžete použít následující příkaz:

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

Nebo šablonu Bicep jednoduše odeberte.

Další kroky

• Přečtěte si další informace o dalších nastaveních a předvolbách, které můžete nastavit v rozšíření Dapr.
• Po úspěšném zřízení Dapr v clusteru AKS zkuste nasadit ukázkovou aplikaci.
• Vyzkoušení pracovního postupu Dapr v rozšíření Dapr pro AKS