Nainstalujte Dapr rozšíření 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ěží v cloudovém prostředí a na okraji sítě, a které využívají různé programovací jazyky a vývojářské rámce. S architekturou sidecar od Dapr můžete udržet svůj kód nezávislý na platformě a zároveň řešit výzvy spojené s budováním mikroslužeb, jako jsou:

Spolehlivé a bezpečné volání jiných služeb
Tvorba událostmi řízených aplikací pomocí modelu pub/sub
Vytváření aplikací, které jsou přenosné napříč různými cloudovými službami a hostiteli (například Kubernetes vs. virtuální stroj)

Poznámka

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

Jak to funguje

Rozšíření Dapr používá rozhraní Azure CLI nebo šablonu Bicep k zajištění řídicí roviny Dapr na vašem AKS nebo Arc-povolném Kubernetes clusteru, vytvářející následující služby Dapr:

Služba Dapr	Description
`dapr-operator`	Spravuje aktualizace komponent a koncové body služeb Kubernetes pro Dapr (úložiště stavů, pub/subs atd.)
`dapr-sidecar-injector`	Vkládá Dapr do podů s anotovanými nasazeními a přidává proměnné prostředí `DAPR_HTTP_PORT` a `DAPR_GRPC_PORT`, aby umožnil aplikacím definovaným uživatelem snadno komunikovat s Dapr bez tvrdého kódování hodnot portů Dapr.
`dapr-placement`	Používá se jenom pro aktéry. Vytváří mapovací tabulky, které mapují instance aktérů k podům.
`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í API stavebních bloků Dapr přidáním několika anotací do nasazení. Pro podrobnější přehled API stavebních bloků a jak je nejlépe používat, se podívejte na přehled stavebních bloků Dapr.

Varování

Pokud nainstalujete Dapr přes rozšíření AKS nebo Arc-enabled Kubernetes, doporučujeme pokračovat v používání tohoto rozšíření pro budoucí správu Dapr místo Dapr CLI. Kombinace těchto dvou nástrojů může způsobit konflikty a vést k nežádoucímu chování.

Prerequisites

Předplatné Azure. Pokud žádné nemáte, 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ě rolí služby Azure Kubernetes.

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

Azure CLI
Biceps

Než začnete

Přidejte 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

Registrovat `KubernetesConfiguration` poskytovatele zdrojů

Pokud ještě nepoužíváte rozšíření clusterů, možná budete muset zaregistrovat poskytovatele prostředků v rámci vašeho předplatného. Pomocí příkazu az provider list můžete zkontrolovat stav registrace poskytovatele, 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 zobrazuje jako NotRegistered, zaregistrujte poskytovatele pomocí příkazu az provider register, jak je uvedeno v následujícím příkladu:

az provider register --namespace Microsoft.KubernetesConfiguration

Zaregistrujte funkci `ExtensionTypes` ke svému předplatnému Azure

Funkce ExtensionTypes musí být zaregistrována k vašemu předplatnému Azure. V terminálu ověřte, že jste ve správném předplatném:

az account set --subscription <your-azure-subscription-ID>

Zaregistrujte ExtensionTypes 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 téma Migrace z OSS Dapr na rozšíření Dapr.

Vytvořte rozšíření Dapr, které nainstaluje Dapr na váš cluster Kubernetes s podporou AKS nebo Arc.

Například nainstalujete nejnovější verzi Dapr pomocí rozšíření Dapr na svém AKS clusteru.

az k8s-extension create --cluster-type managedClusters \
--cluster-name <your-AKS-cluster> \
--resource-group <your-resource-group> \
--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í nejnovější stabilní verze Dapr.

Vyberte cyklus vydání

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

Value	Description
`stable`	Default.
`dev`	Dřívější verze, které můžou obsahovat experimentální funkce. Nehodí se pro výrobu.

Například:

--release-train stable

Nakonfigurujte automatické aktualizace řídicí roviny Dapr

Varování

Automatický upgrade není vhodný pro produkční prostředí. Povolit automatické aktualizace řídicího letového prostredí Dapr pouze v prostředí pro vývoj nebo testování. Zjistěte, jak ručně upgradovat na nejnovější verzi Dapr pro produkční prostředí.

Pokud nainstalujete Dapr bez zadání verze, --auto-upgrade-minor-version, což nakonfiguruje řídicí rovinu Dapr tak, aby automaticky aktualizovala svoji podverzi v nových verzích.

Automatickou aktualizaci můžete zakázat určením parametru --auto-upgrade-minor-version a nastavením hodnoty na false.

Dapr verzování je ve MAJOR.MINOR.PATCH formátu, což znamená, že 1.11.0 na 1.12.0 představuje upgrade podverze.

--auto-upgrade-minor-version true

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

Aby bylo možné povýšit na nejnovější verzi Dapr ve výrobním prostředí, je třeba provést manuální upgrade. Začněte tím, že zobrazíte seznam stabilních verzí Dapr dostupné vašemu spravovanému clusteru AKS. Spusťte následující příkaz:

az k8s-extension extension-types list-versions-by-cluster --resource-group <your-resource-group> --cluster-name <your-AKS-cluster> --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 <your-resource-group> --cluster-name <your-AKS-cluster> --cluster-type managedClusters --extension-type microsoft.dapr  --release-train stable --show-latest

Chcete-li zobrazit seznam dostupných stabilních verzí Dapr podle umístění:

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

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

Zaměření na konkrétní verzi Dapr

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

Poznámka

Dapr podporuje verze v režimu průběžného okna, které zahrnují pouze aktuální a předchozí verze. 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á pro instalaci konkrétní verze Dapr nebo pro návrat k předchozí verzi. Nastavte --auto-upgrade-minor-version na false a --version na verzi Dapr, kterou chcete nainstalovat. Pokud je parametr version vynechán, rozšíření nainstaluje nejnovější verzi Dapr. Následující ukázkový příkaz nainstaluje do clusteru AKS verzi 1.14.4-msft.10 Dapr:

az k8s-extension create --cluster-type managedClusters \
--cluster-name <your-AKS-cluster> \
--resource-group <your-resource-group> \
--name dapr \
--extension-type Microsoft.Dapr \
--auto-upgrade-minor-version false \
--version 1.14.4-msft.10

Než začnete

Registrovat `KubernetesConfiguration` poskytovatele zdrojů

Pokud ještě nepoužíváte rozšíření clusteru, možná budete muset zaregistrovat poskytovatele prostředků v rámci vašeho předplatného. Pomocí příkazu az provider list můžete zkontrolovat stav registrace poskytovatele, 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 zobrazuje jako NotRegistered, zaregistrujte poskytovatele pomocí příkazu az provider register, jak je uvedeno v následujícím příkladu:

az provider register --namespace Microsoft.KubernetesConfiguration

Zaregistrujte funkci `ExtensionTypes` ke svému předplatnému Azure

Funkce ExtensionTypes musí být zaregistrována k vašemu předplatnému 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 na váš cluster AKS nebo Kubernetes povolený pro Arc

Vytvořte šablonu Bicep podobnou následujícímu příkladu a nasaďte rozšíření Dapr do svého 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é tak, že změníte hodnoty na názvy vaší aktuální skupiny prostředků a clusteru.

MY_RESOURCE_GROUP=<your-resource-group>
MY_AKS_CLUSTER=<your-AKS-cluster>

Nasadit šablonu Bicep pomocí příkazu az deployment group.

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

Nakonfigurujte automatické aktualizace řídicí roviny Dapr

Varování

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, autoUpgradeMinorVersion, což nakonfiguruje řídicí rovinu Dapr tak, aby automaticky aktualizovala jeho minoritní verzi s novými verzemi.

Automatickou aktualizaci můžete zakázat určením parametru autoUpgradeMinorVersion a nastavením hodnoty na false.

Verzování Dapr je ve formátu MAJOR.MINOR.PATCH, což znamená, že 1.11.01.12.0 je upgrade podverze.

properties {
  autoUpgradeMinorVersion: true
}

Zacílit na konkrétní verzi Dapr

Poznámka

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

Například, pro použití Dapr 1.11.2:

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

Vybrat release train

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

Value	Description
`stable`	Default.
`dev`	Dřívější verze, které můžou obsahovat experimentální funkce. Nehodí se pro výrobu.

Například:

properties: {
  releaseTrain: 'stable'
}

Řešení problémů

Řešení chyb správy rozšíření

Pokud se rozšíření nepodaří vytvořit nebo aktualizovat, vyzkoušejte návrhy a řešení v Průvodci řešením problémů s rozšířením Dapr.

Řešení potíží s funkčními chybami Dapr

Při řešení opensourcových chyb Dapr, které nesouvisejí s rozšířením, si prohlédněte průvodce běžnými problémy a řešeními Dapr.

Podpora

Poznámka

Zjistěte více o tom, jak Microsoft řeší problémy vzniklé pro rozšíření Dapr.

Pokud při používání rozšíření zaznamenáte bezpečnostní rizika a regrese v době běhu Dapr, otevřete problém v otevřeném zdrojovém projektu Dapr.

Můžete také zahájit diskuzi na Discordu projektu Dapr.

Odstranění rozšíření Dapr z clusteru

Proces odinstalace rozšíření Dapr z AKS neodstraní definice vlastních prostředků (CRD) vytvořené během instalace. Tyto CRD zůstávají v clusteru jako zbytkové komponenty, které jsou nezbytné pro usmiřovatele během instalace a odinstalace rozšíření.

Pokud chcete vyčistit cluster těchto CRD, můžete je po úplné odinstalaci rozšíření Dapr z AKS odstranit ručně.

Odinstalace rozšíření

Pomocí následujícího příkazu odstraňte rozšíření z clusteru AKS:

az k8s-extension delete --resource-group <your-resource-group> --cluster-name <your-AKS-cluster> --cluster-type managedClusters --name dapr

Nebo, pokud používáte šablonu Bicep, můžete šablonu odstranit.

Seznam CRD ve vašem clusteru

Pokud chcete najít identifikátory CRD, které chcete odebrat, spusťte následující příkaz:

kubectl get crds | findstr dapr.io

Další krok

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

Váš názor

Byla tato stránka užitečná?

Last updated on 2026-02-19

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

Jak to funguje

Prerequisites

Než začnete

Přidejte rozšíření Azure CLI pro rozšíření clusteru.

Registrovat KubernetesConfiguration poskytovatele zdrojů

Zaregistrujte funkci ExtensionTypes ke svému předplatnému Azure

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

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

Vyberte cyklus vydání

Nakonfigurujte automatické aktualizace řídicí roviny Dapr

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

Zaměření na konkrétní verzi Dapr

Řešení problémů

Řešení chyb správy rozšíření

Řešení potíží s funkčními chybami Dapr

Podpora

Odstranění rozšíření Dapr z clusteru

Odinstalace rozšíření

Seznam CRD ve vašem clusteru

Další krok

Váš názor

Další materiály

Registrovat `KubernetesConfiguration` poskytovatele zdrojů

Zaregistrujte funkci `ExtensionTypes` ke svému předplatnému Azure