Instale a extensão Dapr para o Serviço Kubernetes do Azure (AKS) e o Kubernetes habilitado para Arc

Antes de começar

Adicionar a extensão da CLI do Azure para extensões de cluster

Instale a k8s-extension extensão da CLI do Azure executando os seguintes comandos:

az extension add --name k8s-extension

Se a k8s-extension extensão já estiver instalada, você pode atualizá-la para a versão mais recente usando o seguinte comando:

az extension update --name k8s-extension

Registrar o provedor de KubernetesConfiguration recursos

Se você ainda não estiver usando extensões de cluster, talvez seja necessário registrar o provedor de recursos com sua assinatura. Você pode verificar o status do registro do provedor usando o comando az provider list , conforme mostrado no exemplo a seguir:

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

O provedor Microsoft.KubernetesConfiguration deve relatar como Registered, conforme mostrado na saída de exemplo a seguir:

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

Se o provedor mostrar como NotRegistered, registre o provedor usando o registro do provedor az, conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Registar a ExtenstionTypes funcionalidade na sua subscrição do Azure

O ExtensionTypes recurso precisa ser registrado em sua assinatura do Azure. No terminal, verifique se você está na assinatura correta:

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

Registre o ExtenstionTypes recurso.

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

O registro de recursos pode levar algum tempo. Após alguns minutos, verifique o status do registro usando o seguinte comando:

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

Crie a extensão e instale o Dapr em seu cluster Kubernetes habilitado para AKS ou Arc

Ao instalar a extensão Dapr, use o valor do sinalizador que corresponde ao seu tipo de cluster:

• Aglomerado AKS: --cluster-type managedClusters.
• Cluster Kubernetes habilitado para Arc: --cluster-type connectedClusters.

Crie a extensão Dapr, que instala o Dapr em seu cluster Kubernetes habilitado para AKS ou Arc.

Por exemplo, instale a versão mais recente do Dapr através da extensão Dapr no seu cluster 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

Mantenha seu cluster AKS gerenciado atualizado para a versão mais recente

Com base em seu ambiente (desenvolvimento, teste ou produção), você pode manter-se atualizado com as versões estáveis mais recentes do Dapr.

Escolher um comboio de libertação

Ao configurar a extensão, você pode optar por instalar o Dapr a partir de um trem de liberação específico. Especifique um dos dois valores do trem de liberação:

Por exemplo:

--release-train stable

Configurando atualizações automáticas para o plano de controle Dapr

Se você instalar o Dapr sem especificar uma versão, --auto-upgrade-minor-version será automaticamente habilitado, configurando o plano de controle do Dapr para atualizar automaticamente sua versão secundária em novas versões.

Você pode desabilitar a atualização automática especificando o --auto-upgrade-minor-version parâmetro e definindo o valor como false.

O versionamento do Dapr está no MAJOR.MINOR.PATCH formato, o 1.12.0 que significa 1.11.0 que é uma atualização de versão secundária.

--auto-upgrade-minor-version true

Visualizando as últimas versões estáveis do Dapr disponíveis

Para atualizar para a versão mais recente do Dapr em um ambiente de produção, você precisa atualizar manualmente. Comece visualizando uma lista das versões estáveis do Dapr disponíveis para seu cluster AKS gerenciado. Execute o seguinte comando:

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

Para ver a versão estável mais recente do Dapr disponível para o cluster AKS gerenciado, execute o seguinte comando:

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

Para visualizar uma lista das versões estáveis do Dapr disponíveis por local:

1. Certifique-se de que registou a ExtenstionTypes funcionalidade na sua subscrição do Azure.
2. Execute o seguinte comando.

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

Em seguida, atualize manualmente o Dapr para a versão estável mais recente.

Direcionando uma versão específica do Dapr

O mesmo argumento de linha de comando é usado para instalar uma versão específica do Dapr ou reverter para uma versão anterior. Defina --auto-upgrade-minor-version para false e --version para a versão do Dapr que você deseja instalar. Se o version parâmetro for omitido, a extensão instalará a versão mais recente do Dapr. Por exemplo, para usar o 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

Antes de começar

Registrar o provedor de KubernetesConfiguration recursos

Se você ainda não estiver usando extensões de cluster, talvez seja necessário registrar o provedor de recursos com sua assinatura. Você pode verificar o status do registro do provedor usando o comando az provider list , conforme mostrado no exemplo a seguir:

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

O provedor Microsoft.KubernetesConfiguration deve relatar como Registered, conforme mostrado na saída de exemplo a seguir:

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

Se o provedor mostrar como NotRegistered, registre o provedor usando o registro do provedor az, conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Registar a ExtenstionTypes funcionalidade na sua subscrição do Azure

O ExtensionTypes recurso precisa ser registrado em sua assinatura do Azure. No terminal, verifique se você está na assinatura correta:

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

Registre o ExtenstionTypes recurso.

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

O registro de recursos pode levar algum tempo. Após alguns minutos, verifique o status do registro usando o seguinte comando:

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

Implante a extensão Dapr em seu cluster Kubernetes habilitado para AKS ou Arc

Crie um modelo Bicep semelhante ao exemplo a seguir e implante a extensão Dapr em seu cluster existente.

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

Defina as variáveis a seguir, alterando os seguintes valores para seu grupo de recursos real e nomes de cluster.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Implante o modelo Bicep usando o az deployment group comando.

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

Configurando atualizações automáticas para o plano de controle Dapr

Se você implantar o Dapr sem especificar uma versão, autoUpgradeMinorVersion será automaticamente habilitado, configurando o plano de controle do Dapr para atualizar automaticamente sua versão secundária em novas versões.

Você pode desabilitar a atualização automática especificando o autoUpgradeMinorVersion parâmetro e definindo o valor como false.

O versionamento do Dapr está no MAJOR.MINOR.PATCH formato, o 1.12.0 que significa 1.11.0 que é uma atualização de versão secundária.

properties {
  autoUpgradeMinorVersion: true
}

Direcionando uma versão específica do Dapr

Defina autoUpgradeMinorVersion para false e version para a versão do Dapr que você deseja instalar. Se o parâmetro for definido como true, e version o autoUpgradeMinorVersion parâmetro for omitido, a extensão instalará a versão mais recente do Dapr.

Por exemplo, para usar o Dapr 1.11.2:

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

Escolher um comboio de libertação

Ao configurar a extensão, você pode optar por instalar o Dapr a partir de um trem de liberação específico. Especifique um dos dois valores do trem de liberação:

Por exemplo:

properties: {
  releaseTrain: 'stable'
}