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

O Dapr simplifica a criação de aplicativos resilientes, sem estado e com monitoração de estado que são executados na nuvem e na borda e abraçam a diversidade de linguagens e estruturas de desenvolvedores. Com a arquitetura sidecar do Dapr, você pode manter sua plataforma de código agnóstica enquanto enfrenta desafios relacionados à criação de microsserviços, como:

• Ligar para outros serviços de forma fiável e segura
• Criação de aplicativos orientados a eventos com pub/sub
• Criação de aplicativos que são portáteis em vários serviços de nuvem e hosts (por exemplo, Kubernetes versus uma máquina virtual)

Nota

Se você planeja instalar o Dapr em um ambiente de produção do Kubernetes, consulte a página de documentação de diretrizes do Dapr para uso de produção.

Como funciona

A extensão Dapr usa a CLI do Azure ou um modelo Bicep para provisionar o plano de controle Dapr em seu cluster Kubernetes habilitado para AKS ou Arc, criando os seguintes serviços Dapr:

Serviço Dapr	Description
dapr-operator	Gerencia atualizações de componentes e pontos de extremidade de serviços Kubernetes para Dapr (lojas de estado, pub/subs, etc.)
dapr-sidecar-injector	Injeta Dapr em pods de implantação anotados e adiciona as variáveis DAPR_HTTP_PORT de ambiente e DAPR_GRPC_PORT permite que aplicativos definidos pelo usuário se comuniquem facilmente com o Dapr sem codificar valores de porta Dapr.
dapr-placement	Usado apenas para atores. Cria tabelas de mapeamento que mapeiam instâncias de ator para pods.
dapr-sentry	Gerencia mTLS entre serviços e atua como uma autoridade de certificação. Para obter mais informações, leia a visão geral de segurança.

Depois que o Dapr estiver instalado em seu cluster, você poderá começar a desenvolver usando as APIs de bloco de construção do Dapr adicionando algumas anotações às suas implantações. Para obter uma visão geral mais detalhada das APIs de bloco de construção e como usá-las melhor, consulte a visão geral dos blocos de construção do Dapr.

Aviso

Se você instalar o Dapr através da extensão AKS ou do Kubernetes habilitado para Arc, nossa recomendação é continuar usando a extensão para gerenciamento futuro do Dapr em vez da CLI do Dapr. A combinação das duas ferramentas pode causar conflitos e resultar em comportamentos indesejados.

Pré-requisitos

• Uma subscrição do Azure. Não tem um? Crie uma conta gratuita.
• A versão mais recente da CLI do Azure.
• Um cluster AKS existente ou um cluster Kubernetes habilitado para Arc conectado.
• Uma função de Administrador de Controle de Acesso Baseado em Função do Serviço Kubernetes do Azure

Selecione como você gostaria de instalar, implantar e configurar a extensão Dapr.

CLI do Azure

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.

Nota

Se você estiver usando o Dapr OSS em seu cluster AKS e quiser instalar a extensão Dapr para AKS, leia mais sobre como migrar com êxito para a extensão Dapr.

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:

valor	Description
stable	Predefinição.
dev	Lançamentos iniciais que podem conter recursos experimentais. Não é adequado para produção.

Por exemplo:

--release-train stable

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

Aviso

A atualização automática não é adequada para ambientes de produção. Habilite apenas as atualizações automáticas para o plano de controle Dapr em ambientes de desenvolvimento ou teste. Saiba como atualizar manualmente para a versão mais recente do Dapr para ambientes de produção.

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

Nota

O Dapr é suportado com uma janela contínua, incluindo apenas as versões atual e anterior. É da sua responsabilidade operacional manter-se atualizado com estas versões suportadas. Se você tiver uma versão mais antiga do Dapr, talvez seja necessário fazer atualizações intermediárias para chegar a uma versão suportada.

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

Bicep

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

Aviso

Você pode habilitar atualizações automáticas para o plano de controle Dapr somente em ambientes de desenvolvimento ou teste. A atualização automática não é adequada para ambientes de produção.

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

Nota

O Dapr é suportado com uma janela contínua, incluindo apenas as versões atual e anterior. É da sua responsabilidade operacional manter-se atualizado com estas versões suportadas. Se você tiver uma versão mais antiga do Dapr, talvez seja necessário fazer atualizações intermediárias para chegar a uma versão suportada.

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:

valor	Description
stable	Predefinição.
dev	Lançamentos iniciais que podem conter recursos experimentais. Não é adequado para produção.

Por exemplo:

properties: {
  releaseTrain: 'stable'
}

Solução de problemas de erros de extensão

Se a extensão não conseguir criar ou atualizar, tente sugestões e soluções no guia de solução de problemas da extensão Dapr.

Solução de problemas do Dapr

Solucione erros do Dapr por meio do guia comum de problemas e soluções do Dapr.

Excluir a extensão

Se você precisar excluir a extensão e remover o Dapr do seu cluster AKS, você pode usar o seguinte comando:

az k8s-extension delete --resource-group <myResourceGroup> --cluster-name <myAKSCluster> --cluster-type managedClusters --name dapr

Ou você pode remover o modelo Bicep.

Passos Seguintes

Configure a extensão Dapr para seu cenário exclusivo