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

  • Článek

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č)

Použití rozšíření Dapr ke zřízení Dapr v clusteru Kubernetes s podporou AKS nebo Arc eliminuje režijní náklady:

  • Stažení nástrojů Dapr
  • Ruční instalace a správa modulu runtime v clusteru AKS

Rozšíření navíc nabízí podporu všech nativních možností konfigurace Dapr prostřednictvím jednoduchých argumentů příkazového řádku.

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 ke zřízení řídicí roviny Dapr ve vašem 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í.

Aktuálně podporovaná

Verze Dapr

Podpora rozšíření Dapr se liší v závislosti na způsobu správy modulu runtime.

Samoobslužná správa
V případě místního modulu runtime rozšíření Dapr podporuje:

Místní modul runtime vyžaduje ruční upgrade, aby zůstal v okně podpory. Pokud chcete upgradovat Dapr prostřednictvím rozšíření, postupujte podle pokynů k instanci rozšíření update.

Automatický upgrade
Povolením automatického upgradu se vaše rozšíření Dapr aktualizuje na nejnovější podverzi. Mezi aktualizacemi může docházet k zásadním změnám.

Součásti

Podporují se komponenty Azure a open source. Alfa a beta komponenty jsou podporovány v nejlepším úsilí.

Cloudy a oblasti

Globální cloud Azure se podporuje s podporou Arc v následujících oblastech:

Oblast Podpora AKS Podpora arc pro 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 ✔️ ✔️

Předpoklady

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 služeb

Pokud jste dříve nepoužívali rozšíření clusteru, možná budete muset zaregistrovat poskytovatele služeb 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

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

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

Volba trénu vydané verze

Při konfiguraci rozšíření se můžete rozhodnout nainstalovat Dapr z konkrétního --release-train. 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

Ř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

Další kroky