Extensão Dapr para AKS (Serviço de Kubernetes do Azure) e Kubernetes habilitado para Arc

O Dapr é um runtime portátil e orientado por eventos que simplifica a compilação de aplicativos resilientes, sem estado e com estado executados na nuvem e na borda, e que incluem a diversidade de linguagens e estruturas de desenvolvedor. Com a arquitetura de sidecar do Dapr, você pode manter sua plataforma de código independente enquanto lida com desafios na criação de microsserviços, como:

• Chamando outros serviços de forma confiável e segura
• Criar aplicativos controlados por eventos com pub-sub
• Criando aplicativos que são portáteis em vários serviços de nuvem e hosts (por exemplo, Kubernetes versus uma VM)

Observação

Se você planeja instalar o Dapr em um ambiente de produção do Kubernetes, consulte a página de documentação Diretrizes do Dapr para uso em 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	Descrição
dapr-operator	Gerencia atualizações de componentes e pontos de extremidade de serviços do Kubernetes para Dapr (armazenamentos de estado, pub/subs, etc.)
dapr-sidecar-injector	Injeta o Dapr em pods de implantação anotada e adiciona as variáveis de ambiente DAPR_HTTP_PORT e DAPR_GRPC_PORT para permitir que aplicativos definidos pelo usuário se comuniquem facilmente com o Dapr sem valores hard-coding de porta do Dapr.
dapr-placement	Usado apenas para atores. Cria tabelas de mapeamento que mapeiam instâncias de ator para pods.
dapr-sentry	Gerencia a mTLS entre serviços e atua como uma autoridade de certificação. Para obter mais informações, leia visão geral de segurança.

Depois que o Dapr estiver instalado no cluster, você poderá começar a desenvolver usando as APIs do bloco de construção 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 por meio da extensão do AKS ou Kubernetes habilitado para Arc, é recomendável continuar usando a extensão para o gerenciamento futuro do Dapr em vez da CLI do Dapr. A combinação das duas ferramentas pode causar conflitos e resultar em um comportamento indesejado.

Pré-requisitos

• Uma assinatura do Azure. Não tem uma? Crie uma conta gratuita.
• Instale a versão mais recente da CLI do Azure.
• Se você ainda não tiver um, precisará criar um cluster do AKS ou conectar um cluster Kubernetes habilitado para Arc.
• Verifique se você tem uma função de Administrador RBAC do Serviço de Kubernetes do Azure

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

CLI do Azure

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

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

az extension add --name k8s-extension

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

az extension update --name k8s-extension

Registrar o provedor de recursos KubernetesConfiguration

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

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

O provedor Microsoft.KubernetesConfiguration deve ser relatado como Registrado, conforme mostrado na seguinte saída de exemplo:

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

Se o provedor é exibido como NotRegistered, registre o provedor usando az provider register conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Criar a extensão e instalar o Dapr em seu cluster do AKS ou do Kubernetes habilitado para Arc

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

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

Observação

Se você estiver usando o Dapr OSS em seu cluster do 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 no cluster do AKS ou do Kubernetes habilitado para Arc.

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

Como configurar atualizações automáticas para o painel de controle do Dapr

Aviso

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

Se você instalar o Dapr sem especificar uma versão, --auto-upgrade-minor-versionserá habilitado automaticamente, configurando o painel 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 parâmetro --auto-upgrade-minor-versione definindo o valor como false.

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

--auto-upgrade-minor-version true

Direcionando uma versão específica do Dapr

Observação

O Dapr tem suporte com uma janela rolante, incluindo apenas as versões atuais e anteriores. Sua responsabilidade operacional é manter-se atualizado com essas versões com suporte. Se você tiver uma versão mais antiga do Dapr, talvez seja necessário fazer atualizações intermediárias para obter uma versão com suporte.

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 como false e --version para a versão do Dapr que você deseja instalar. Se o parâmetro version for omitido, a extensão instalará a versão mais recente do Dapr. Por exemplo, para usar o Dapr 1.11.2:

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

Como escolher um trem de lançamento

Ao configurar a extensão, você pode optar por instalar o Dapr em um treinamento de versão específico. Especifique um dos dois valores do conjunto de versões:

Valor	Descrição
stable	Padrão.
dev	Versões iniciais podem conter recursos experimentais. Não adequado para produção.

Por exemplo:

--release-train stable

Bicep

Registrar o provedor de recursos KubernetesConfiguration

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

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

O provedor Microsoft.KubernetesConfiguration deve ser relatado como Registrado, conforme mostrado na seguinte saída de exemplo:

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

Se o provedor é exibido como NotRegistered, registre o provedor usando az provider register conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Implantar a extensão Dapr no cluster Kubernetes habilitado para AKS ou Arc

Crie um modelo Bicep semelhante ao exemplo a seguir para implantar 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 seguintes variáveis, alterando os valores abaixo para os nomes reais do grupo de recursos e do cluster.

MY_RESOURCE_GROUP=myResourceGroup
MY_AKS_CLUSTER=myAKScluster

Implante o modelo Bicep usando o comando az deployment group.

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

Como configurar atualizações automáticas para o painel de controle do Dapr

Aviso

Você pode habilitar atualizações automáticas para o painel de controle do 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, autoUpgradeMinorVersionserá habilitado automaticamente, configurando o plano de controle Dapr para atualizar automaticamente sua versão secundária em novas versões.

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

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

properties {
  autoUpgradeMinorVersion: true
}

Direcionando uma versão específica do Dapr

Observação

O Dapr tem suporte com uma janela rolante, incluindo apenas as versões atuais e anteriores. Sua responsabilidade operacional é manter-se atualizado com essas versões com suporte. Se você tiver uma versão mais antiga do Dapr, talvez seja necessário fazer atualizações intermediárias para obter uma versão com suporte.

Defina autoUpgradeMinorVersion como false e version para a versão do Dapr que você deseja instalar. Se o parâmetro autoUpgradeMinorVersion estiver definido como true e o parâmetro version 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'
}

Como escolher um trem de lançamento

Ao configurar a extensão, você pode optar por instalar o Dapr em um treinamento de versão específico. Especifique um dos dois valores do conjunto de versões:

Valor	Descrição
stable	Padrão.
dev	Versões iniciais podem conter recursos experimentais. Não adequado para produção.

Por exemplo:

properties: {
  releaseTrain: 'stable'
}

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

Se a extensão não for criada ou atualizada, 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 de soluções e problemas comuns do Dapr.

Excluir a extensão

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

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

Ou simplesmente remova o modelo Bicep.

Próximas etapas

• Saiba mais sobre as configurações e as preferências adicionais que você pode definir na extensão do Dapr.
• Depois de ter provisionado com êxito o Dapr no cluster do AKS, tente implantar um aplicativo de exemplo.
• Experimente o Fluxo de Trabalho do Dapr em sua extensão do Dapr para AKS