Partilhar via

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

  • Artigo

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

Você pode configurar a extensão Dapr para usar e gerenciar os recursos do Kubernetes criados pelo Dapr OSS:

Para obter mais informações, consulte uma visão geral da extensão Dapr para AKS.

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

Quando você instala a extensão Dapr, a extensão verifica se há uma instalação existente 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 helm list -A comando e salve o nome da versão do Dapr e o namespace da saída.

    helm list -A

  2. Digite o nome da versão Helm e o namespace (de helm list -A) quando solicitado com 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]:

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

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

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

    helm list -A

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

    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 HA ou as configurações do serviço de posicionamento

Ao instalar a extensão Dapr sobre uma instalação existente do Dapr, você recebe 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 só permite a aplicação de patches para campos limitados em StatefulSets. Se qualquer uma das configurações do modo HA ou do serviço de posicionamento estiver configurada, a atualização falhará. Para atualizar o modo HA ou as configurações do serviço de posicionamento, você deve excluir o conjunto stateful e, em seguida, atualizar o modo HA.

  1. Exclua o conjunto stateful usando o kubectl delete comando.

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

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

    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, consulte as diretrizes de produção do Dapr.

Próximos passos

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