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

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.

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:

Příklad:

--release-train stable

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

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

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

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

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

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:

Příklad:

properties: {
  releaseTrain: 'stable'
}