Instalace 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 nebo 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.
• Nejnovější verze Azure CLI.
• Existující cluster AKS nebo připojený cluster Kubernetes s podporou Arc.
• Role správce řízení přístupu na základě role ve službě Azure Kubernetes Service

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

Azure CLI

Než začnete

Přidání 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 ještě nepoužíváte 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 , 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

ExtenstionTypes Registrace funkce do předplatného Azure

Tato ExtensionTypes funkce musí být zaregistrovaná ve vašem předplatném Azure. V terminálu ověřte, že jste ve správném předplatném:

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

Zaregistrujte ExtenstionTypes funkci.

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

Registrace funkcí může nějakou dobu trvat. Po několika minutách zkontrolujte stav registrace pomocí následujícího příkazu:

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

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

Udržování spravovaného clusteru AKS aktualizovaného na nejnovější verzi

Na základě vašeho prostředí (vývoj, testování nebo produkce) můžete udržovat aktuální informace o nejnovějších stabilních verzích Dapr.

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, které můžou obsahovat experimentální funkce. Nehodí se pro výrobu.

Příklad:

--release-train stable

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

Upozorňující

Automatický upgrade není vhodný pro produkční prostředí. Povolte automatické aktualizace řídicí roviny Dapr pouze ve vývojových nebo testovacích prostředích. Zjistěte, jak ručně upgradovat na nejnovější verzi Dapr pro produkční prostředí.

Pokud instalujete Dapr bez zadání verze, je automaticky povolená a konfiguruje řídicí rovinu Dapr tak, --auto-upgrade-minor-version aby 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

Zobrazení nejnovějších dostupných stabilních verzí Dapr

Pokud chcete upgradovat na nejnovější verzi Dapr v produkčním prostředí, musíte provést ruční upgrade. Začněte zobrazením seznamu stabilních verzí Dapr dostupných pro spravovaný cluster AKS. Spusťte následující příkaz:

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

Pokud chcete zobrazit nejnovější stabilní verzi Dapr dostupnou pro spravovaný cluster AKS, spusťte následující příkaz:

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

Zobrazení seznamu stabilních verzí Dapr dostupných podle umístění:

1. Ujistěte se, že jste funkci zaregistrovali ExtenstionTypes do předplatného Azure.
2. Spusťte následující příkaz:

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

Potom ručně aktualizujte Dapr na nejnovější stabilní verzi.

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

Než začnete

KubernetesConfiguration Registrace poskytovatele prostředků

Pokud ještě nepoužíváte 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 , 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

ExtenstionTypes Registrace funkce do předplatného Azure

Tato ExtensionTypes funkce musí být zaregistrovaná ve vašem předplatném Azure. V terminálu ověřte, že jste ve správném předplatném:

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

Zaregistrujte ExtenstionTypes funkci.

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

Registrace funkcí může nějakou dobu trvat. Po několika minutách zkontrolujte stav registrace pomocí následujícího příkazu:

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

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

Vytvořte šablonu Bicep podobnou následujícímu příkladu a nasaďte 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ásledující hodnoty na skutečnou 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, autoUpgradeMinorVersion aby 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, které 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 můžete odebrat šablonu Bicep.

Další kroky

Konfigurace rozšíření Dapr pro váš jedinečný scénář