Migrer de Dapr OSS vers l’extension Dapr pour Azure Kubernetes Service (AKS)

Cet article vous montre comment migrer de Dapr OSS vers l’extension Dapr pour AKS.

Vous pouvez configurer l’extension Dapr pour qu’elle utilise et gère les ressources Kubernetes créées par Dapr OSS soit :

• Vérification d’une installation Dapr existante en utilisant Azure CLI (méthode par défaut), ou
• Configuration de l’installation Dapr existante à l’aide de --configuration-settings.

Pour plus d’informations, consultez un vue d'ensemble de l’extension Dapr pour AKS.

Rechercher une installation Dapr existante

Quand vous installez l’extension Dapr, celle-ci recherche une installation existante de Dapr sur votre cluster. Si Dapr est présent, l’extension utilise et gère les ressources Kubernetes créées par Dapr OSS.

1. Listez les détails de votre installation actuelle de Dapr à l’aide de la commande helm list -A et enregistrez le nom de la version et l’espace de noms de Dapr à partir de la sortie.

   helm list -A
   

2. Quand vous y êtes invité, entrez le nom de la version et l’espace de noms de Helm (à partir de helm list -A) :

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

Configurer l’installation existante de Dapr avec --configuration-settings

Quand vous créez l’extension Dapr, vous pouvez la configurer pour qu’elle utilise et gère les ressources Kubernetes créées par Dapr OSS à l’aide de l’indicateur --configuration-settings.

1. Listez les détails de votre installation actuelle de Dapr à l’aide de la commande helm list -A et enregistrez le nom de la version et l’espace de noms de Dapr à partir de la sortie.

   helm list -A
   

2. Créez l’extension Dapr à l’aide de la commande az k8s-extension create et utilisez les indicateurs --configuration-settings pour définir le nom de la version et l’espace de noms de 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"
   

Mettre à jour le mode haute disponibilité ou les paramètres du service de placement

Quand vous installez l’extension Dapr sur une installation existante de Dapr, vous recevez le message suivant :

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.

Kubernetes autorise uniquement la mise à jour corrective pour des champs limités dans StatefulSets. Si l’un des paramètres du service de sélection élective ou du mode haute disponibilité est configuré, la mise à niveau échoue. Pour mettre à jour les paramètres du service de sélection élective ou du mode haute disponibilité, vous devez supprimer le StatefulSet, puis mettre à jour le mode haute disponibilité.

1. Supprimez le StatefulSet à l’aide de la commande kubectl delete.

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

2. Mettez à jour le mode haute disponibilité à l’aide de la commande 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" \    
   

Pour plus d’informations, consultez les instructions de production Dapr.

Étapes suivantes

En savoir plus sur Dapr et comment l’utiliser.