Migrar do Dapr OSS para a extensão Dapr para Serviço de Kubernetes do Azure (AKS)

Este artigo mostra como migrar do Dapr OSS para a extensão do Dapr para AKS.

Você pode configurar a extensão do Dapr para usar e gerenciar os recursos do Kubernetes criados pelo Dapr OSS verificando uma instalação existente do Dapr usando a CLI do Azure (método padrão) ou configurando a instalação existente do Dapr usando --configuration-settings.

Para obter mais informações, confira Extensão do Dapr para AKS.

Verificar se há uma instalação existente do Dapr

Quando você cria a extensão do Dapr, a extensão verifica se já existe uma instalação do Dapr no cluster. Se o Dapr existir, a extensão usará e gerenciará os recursos do Kubernetes criados pelo Dapr OSS.

1. Liste os detalhes da instalação atual do Dapr usando o comando helm list -A e salve o namespace e o nome da versão do Dapr da saída.

   helm list -A
   

2. Insira o namespace e o nome da versão do Helm (de helm list -A) quando receber as seguintes perguntas:

   Enter the Helm release name for Dapr, or press Enter to use the default name [dapr]:
   Enter the namespace where Dapr is installed, or press Enter to use the default namespace [dapr-system]:
   

Configurar a instalação existente do Dapr usando --configuration-settings

Ao criar a extensão do Dapr, você pode configurar a extensão para usar e gerenciar os recursos do Kubernetes criados pelo Dapr OSS usando o sinalizador --configuration-settings.

1. Liste os detalhes da instalação atual do Dapr usando o comando helm list -A e salve o namespace e o nome da versão do Dapr da saída.

   helm list -A
   

2. Crie a extensão do Dapr usando o az k8s-extension create e use os sinalizadores --configuration-settings para definir o namespace e o nome da versão do Dapr.

   az k8s-extension create --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --configuration-settings "existingDaprReleaseName=dapr" \
   --configuration-settings "existingDaprReleaseNamespace=dapr-system"
   

Atualizar o modo de HA ou as configurações do serviço de posicionamento

Ao instalar a extensão do Dapr em uma instalação existente do Dapr, você receberá a seguinte mensagem:

The extension will be installed on your existing Dapr installation. Note, if you have updated the default values for global.ha.* or dapr_placement.* in your existing Dapr installation, you must provide them in the configuration settings. Failing to do so will result in an error, since Helm upgrade will try to modify the StatefulSet. See <link> for more information.

O Kubernetes permite apenas a aplicação de patch a campos limitados em StatefulSets. Se um dos modos de HA ou configurações do serviço de posicionamento estiver configurado, ocorrerá uma falha na atualização. Para atualizar o modo de HA ou as configurações do serviço de posicionamento, você precisa excluir o conjunto com estado e, em seguida, atualizar o modo de HA.

1. Exclua o conjunto com estado usando o comando kubectl delete.

   kubectl delete statefulset.apps/dapr-placement-server -n dapr-system
   

2. Atualize o modo de HA usando o comando az k8s-extension update.

   az k8s-extension update --cluster-type managedClusters \
   --cluster-name myAKSCluster \
   --resource-group myResourceGroup \
   --name dapr \
   --extension-type Microsoft.Dapr \
   --auto-upgrade-minor-version true \  
   --configuration-settings "global.ha.enabled=true" \    
   

Para obter mais informações, confira Diretrizes de produção do Dapr.

Próximas etapas

Saiba mais sobre o Dapr e como usá-lo.