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

O Dapr simplifica a criação de aplicações resilientes, sem estado e com estado que são executadas na nuvem e no edge e abraçam a diversidade de linguagens e frameworks de desenvolvimento. 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 aplicações orientadas por 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 planear instalar o Dapr num ambiente de produção Kubernetes, consulte a página de documentação das 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 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 de ambiente `DAPR_HTTP_PORT` e `DAPR_GRPC_PORT`, permitindo que aplicativos definidos pelo usuário se comuniquem facilmente com o Dapr sem a necessidade de codificar os valores das portas Dapr.
`dapr-placement`	Usado apenas para atores. Cria tabelas de mapeamento que associam instâncias de ator a 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 instalar o Dapr através da extensão do AKS ou do Kubernetes com suporte para Arc, recomendamos que continue a usar a extensão para a gestão futura 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 do Azure CLI.
Um cluster AKS existente ou um cluster Kubernetes habilitado para Arc.
Função de Administrador de Controlo de Acesso Baseado em Funções no Azure Kubernetes Service

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

CLI do Azure
Bíceps

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

Registar o fornecedor 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, registe o provedor usando o comando az provider register, conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Registe a `ExtensionTypes` 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>

Registe a ExtensionTypes funcionalidade.

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

O registo 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:

Cluster AKS: --cluster-type managedClusters.
Cluster Kubernetes habilitado para o 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	Descrição
`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 instalar o Dapr sem especificar uma versão, --auto-upgrade-minor-versioné automaticamente ativado, configurando o plano de controlo do Dapr para atualizar automaticamente a sua versão menor em novos lançamentos.

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 que significa que 1.11.0 para 1.12.0 é uma atualização de versão menor.

--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:

Certifique-se de que registou a ExtensionTypes funcionalidade na sua subscrição do Azure.
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.

Apontando para uma determinada versão do Dapr

Nota

O Dapr é suportado com uma janela deslizante, 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. O comando de exemplo a seguir instala a versão 1.14.4-msft.10 do Dapr no 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 \
--version 1.14.4-msft.10

Antes de começar

Registar o fornecedor de `KubernetesConfiguration` recursos

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, registe o provedor usando o comando az provider register, conforme mostrado no exemplo a seguir:

az provider register --namespace Microsoft.KubernetesConfiguration

Registe a `ExtensionTypes` 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>

Registe a ExtenstionTypes funcionalidade.

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

O registo 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 implantar o Dapr sem especificar uma versão, autoUpgradeMinorVersionserá automaticamente ativado, configurando o plano de controlo do Dapr para atualizar automaticamente a sua versão menor em novos lançamentos.

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 que significa que 1.11.0 para 1.12.0 é uma atualização de versão menor.

properties {
  autoUpgradeMinorVersion: true
}

Apontando para uma determinada versão do Dapr

Nota

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

Resolução de problemas em erros na gestão de extensões

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

Solução de problemas de erros funcionais do Dapr

Solucione problemas de erros de código aberto do Dapr não relacionados à extensão por meio do guia comum de problemas e soluções do Dapr.

Apoio

Nota

Saiba mais sobre como a Microsoft lida com os problemas levantados para a extensão Dapr.

Se você estiver enfrentando riscos de segurança e regressões de tempo de execução do Dapr ao usar a extensão, abra um problema com o projeto de código aberto do Dapr.

Você também pode iniciar uma discussão no projeto Dapr Discord:

Excluir a extensão Dapr do cluster

O processo de desinstalação da extensão Dapr do AKS não exclui os CRDs criados durante a instalação. Esses CRDs permanecem no cluster como componentes residuais, essenciais para o reconciliador durante a instalação e desinstalação da extensão.

Para limpar o cluster desses CRDs, você pode excluí-los manualmente depois que a extensão Dapr tiver sido completamente desinstalada do AKS.

Desinstalando a extensão

Exclua a extensão do cluster AKS usando o seguinte comando:

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

Ou, se estiver usando um modelo Bicep, você pode excluir o modelo.

Listando os CRDs em seu cluster

Para localizar os CRDs que você deseja remover, execute o seguinte comando:

kubectl get crds | findstr dapr.io

Passos Seguintes

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

Feedback

Esta página foi útil?

Last updated on 2025-04-07

Partilhar via

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

Como funciona

Pré-requisitos

Antes de começar

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

Registar o fornecedor de KubernetesConfiguration recursos

Registe a ExtensionTypes funcionalidade na sua subscrição do Azure

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

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

Escolher um comboio de libertação

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

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

Apontando para uma determinada versão do Dapr

Solução de problemas

Resolução de problemas em erros na gestão de extensões

Solução de problemas de erros funcionais do Dapr

Apoio

Excluir a extensão Dapr do cluster

Desinstalando a extensão

Listando os CRDs em seu cluster

Passos Seguintes

Feedback

Recursos adicionais

Registar o fornecedor de `KubernetesConfiguration` recursos

Registe a `ExtensionTypes` funcionalidade na sua subscrição do Azure