Migración de Dapr OSS a la extensión Dapr para Azure Kubernetes Service (AKS)

En este artículo se muestra cómo migrar de Dapr OSS a la extensión Dapr para AKS.

Puede configurar la extensión Dapr para usar y administrar los recursos de Kubernetes creados por Dapr OSS mediante la comprobación de una instalación de Dapr existente mediante la CLI de Azure (método predeterminado) o la configuración de la instalación de Dapr existente mediante --configuration-settings.

Para más información, consulte Extensión de Dapr para AKS.

Comprobación de una instalación de Dapr existente

Al crear la extensión de Dapr, la extensión comprueba si hay una instalación de Dapr existente en el clúster. Si Dapr existe, la extensión usa y administra los recursos de Kubernetes creados por Dapr OSS.

1. Enumere los detalles de la instalación actual de Dapr con el comando helm list -A y guarde el nombre de la versión de Dapr y el espacio de nombres de la salida.

   helm list -A
   

2. Escriba el nombre de la versión de Helm y el espacio de nombres (de helm list -A) cuando se le pidan las siguientes preguntas:

   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 la instalación de Dapr existente mediante --configuration-settings

Al crear la extensión Dapr, puede configurar la extensión para usar y administrar los recursos de Kubernetes creados por Dapr OSS mediante la marca --configuration-settings.

1. Enumere los detalles de la instalación actual de Dapr con el comando helm list -A y guarde el nombre de la versión de Dapr y el espacio de nombres de la salida.

   helm list -A
   

2. Cree la extensión Dapr con az k8s-extension create y use las marcas --configuration-settings para establecer el nombre y el espacio de nombres de la versión 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"
   

Actualización del modo de alta disponibilidad o la configuración del servicio de selección de ubicación

Al instalar la extensión Dapr sobre una instalación de Dapr ya existente, recibirá el siguiente mensaje:

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 solo permite aplicar revisiones a campos limitados en StatefulSets. Si se configura alguno de los valores del servicio de selección de ubicación o modo de alta disponibilidad, se produce un error en la actualización. Para actualizar el modo de alta disponibilidad o la configuración del servicio de selección de ubicación, debe eliminar el conjunto con estado y, a continuación, actualizar el modo de alta disponibilidad.

1. Elimine el conjunto con estado mediante el comando kubectl delete.

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

2. Actualice el modo de alta disponibilidad mediante el 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 más información, consulte Instrucciones de producción de Dapr.

Pasos siguientes

Obtenga más información sobre Dapr y cómo usarlo.