Instale la extensión de Dapr para Azure Kubernetes Service (AKS) y Kubernetes habilitado para Arc

Dapr simplifica la creación de aplicaciones resistentes, sin estado y con estado que se ejecutan en la nube y en el perímetro, y abarca la diversidad de lenguajes y marcos de desarrollador. Con la arquitectura de tipo sidecar de Dapr, puede mantener la plataforma de código independiente a la vez que aborda los desafíos relacionados con la creación de microservicios, como:

• Que llaman a otros servicios de forma confiable y segura
• Que crean aplicaciones controladas por eventos con pub-sub
• Creación de aplicaciones que son portátiles en varios servicios en la nube y hosts (por ejemplo, Kubernetes frente a una máquina virtual)

Nota:

Si tiene previsto instalar Dapr en un entorno de producción de Kubernetes, consulte la página de documentación Directrices de Dapr para el uso de producción.

Funcionamiento

La extensión Dapr usa la CLI de Azure o una plantilla de Bicep para aprovisionar el plano de control de Dapr en el clúster de Kubernetes habilitado para AKS o Arc, creando los siguientes servicios de Dapr:

Servicio de Dapr	Descripción
dapr-operator	Administra las actualizaciones de componentes y los puntos de conexión de servicio de Kubernetes para Dapr (almacenes de estado, pub/subs, etc.).
dapr-sidecar-injector	Inserta Dapr en pods de implementación anotados y agrega las variables de entorno DAPR_HTTP_PORT y DAPR_GRPC_PORT para permitir que las aplicaciones definidas por el usuario se comuniquen fácilmente con Dapr sin codificar de forma rígida los valores de puerto de Dapr.
dapr-placement	Se usa solo para actores. Crea tablas de asignación que asignan instancias de actor a pods.
dapr-sentry	Administra mTLS entre servicios y actúa como entidad de certificación. Para obtener más información, lea la Introducción a la seguridad.

Una vez instalado Dapr en el clúster, puede empezar a desarrollar con las API del bloque de creación de Dapr agregando algunas anotaciones a las implementaciones. Para obtener información general más detallada de las API de bloques de compilación y la mejor forma de usarlas, consulte la Introducción a los bloques de compilación de Dapr.

Advertencia

Si instala Dapr a través de la extensión de AKS o Kubernetes habilitado para Arc, nuestra recomendación es seguir usando la extensión para la administración futura de Dapr en lugar de la CLI de Dapr. La combinación de las dos herramientas puede provocar conflictos y generar un comportamiento no deseado.

Requisitos previos

• Suscripción a Azure. ¿Aún no tiene una? Cree una cuenta gratuita.
• La versión más reciente de la CLI de Azure.
• Un clúster de AKS existente o un clúster de Kubernetes habilitado para Arc conectado.
• Un rol de administrador de control de acceso basado en rol de Azure Kubernetes Service

Seleccione cómo desea instalar, implementar y configurar la extensión Dapr.

CLI de Azure

Antes de empezar

Añada la extensión Azure CLI para extensiones de cluster

Instale la extensión k8s-extension de la CLI de Azure mediante la ejecución de los siguientes comandos:

az extension add --name k8s-extension

Si la extensión k8s-extension ya está instalada, puede actualizarla a su versión más reciente con el siguiente comando:

az extension update --name k8s-extension

Registro del proveedor de KubernetesConfiguration recurso

Si aún no usa extensiones de clúster, es posible que tenga que registrar el proveedor de recursos con su suscripción. Puede comprobar el estado del registro del proveedor mediante el comando az provider list, como se muestra en el siguiente ejemplo:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

El proveedor Microsoft.KubernetesConfiguration debería indicar Registered, tal y como se muestra en el siguiente ejemplo de salida:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Si el proveedor se muestra como NotRegistered, registre el proveedor con el comando az provider register tal como se muestra en el siguiente ejemplo:

az provider register --namespace Microsoft.KubernetesConfiguration

Registre la característica ExtenstionTypes en la suscripción de Azure

La característica ExtensionTypes debe registrarse en la suscripción de Azure. En el terminal, compruebe que está en la suscripción correcta:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Registre la característica ExtenstionTypes.

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

El registro de características puede tardar algún tiempo. Después de unos minutos, compruebe el estado del registro mediante el comando siguiente:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Creación de la extensión e instalación de Dapr en el clúster de AKS o Kubernetes habilitado para Arc

Al instalar la extensión de Dapr, use el valor de marca que corresponde al tipo de clúster:

• Clúster de AKS: --cluster-type managedClusters.
• Clúster de Kubernetes habilitado para Arc: --cluster-type connectedClusters.

Nota

Si usa Dapr OSS en el clúster de AKS y desea instalar la extensión de Dapr para AKS, obtenga más información sobre cómo migrar correctamente a la extensión de Dapr.

Cree la extensión de Dapr, que instala Dapr en el clúster de AKS o Kubernetes habilitado para Arc.

Por ejemplo, instale la versión más reciente de Dapr a través de la extensión Dapr en el clúster de 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

Mantener el clúster de AKS administrado actualizado a la versión más reciente

En función de su entorno (desarrollo, prueba o producción), puede mantenerse al día con las versiones estables de Dapr más recientes.

Elección de una serie de versiones

Al configurar la extensión, puede optar por instalar Dapr desde un tren de versión determinado. Especifique uno de los dos valores de entrenamiento de versión:

Value	Descripción
stable	Predeterminada.
dev	Versiones preliminares que pueden contener características experimentales. No son adecuadas para producción.

Por ejemplo:

--release-train stable

Configuración de actualizaciones automáticas en el plano de control de Dapr

Advertencia

La actualización automática no es adecuada para entornos de producción. Habilitar solo las actualizaciones automáticas en el plano de control de Dapr en entornos de desarrollo o pruebas. Aprenda a actualizar manualmente a la versión más reciente de Dapr para entornos de producción.

Si instala Dapr sin especificar una versión, --auto-upgrade-minor-version se habilita automáticamente, configurando el plano de control de Dapr para actualizar automáticamente su versión secundaria en nuevas versiones.

Puede deshabilitar la actualización automática especificando el parámetro --auto-upgrade-minor-version y estableciendo el valor en false.

El control de versiones de Dapr tiene el formato MAJOR.MINOR.PATCH, lo que significa que 1.11.0 a 1.12.0 es una actualización de versión secundaria.

--auto-upgrade-minor-version true

Visualización de las últimas versiones estables de Dapr disponibles

Para actualizar a la versión más reciente de Dapr en un entorno de producción, debe actualizar manualmente. Empiece por ver una lista de las versiones estables de Dapr disponibles para el clúster de AKS administrado. Ejecute el siguiente 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 la versión estable de Dapr más reciente disponible para el clúster de AKS administrado, ejecute el comando siguiente:

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 ver una lista de las versiones estables de Dapr disponibles por ubicación:

1. Asegúrese de que ha registrado la característica de ExtenstionTypes en la suscripción de Azure.
2. Ejecute el siguiente comando:

az k8s-extension extension-types list-versions-by-location --location westus --extension-type microsoft.dapr

Después, actualice manualmente Dapr a la versión estable más reciente.

Obtención como destino una versión específica de Dapr

Nota

Dapr se admite con una ventana gradual, que incluye solo las versiones actuales y anteriores. Es su responsabilidad operativa mantenerse actualizado a estas versiones admitidas. Si tiene una versión más antigua de Dapr, es posible que deba realizar actualizaciones intermedias para llegar a una versión admitida.

Para instalar una versión específica de Dapr o revertir a una versión anterior, se usa el mismo argumento de línea de comandos. Establezca --auto-upgrade-minor-version en false y --version en la versión de Dapr que quiere instalar. Si se omite el parámetro version, la extensión instala la versión más reciente de Dapr. Por ejemplo, para usar Dapr 1.13.5:

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.13.5

Bicep

Antes de empezar

Registro del proveedor de KubernetesConfiguration recurso

Si aún no usa extensiones de clúster, es posible que tenga que registrar el proveedor de recursos con su suscripción. Puede comprobar el estado del registro del proveedor mediante el comando az provider list, como se muestra en el siguiente ejemplo:

az provider list --query "[?contains(namespace,'Microsoft.KubernetesConfiguration')]" -o table

El proveedor Microsoft.KubernetesConfiguration debería indicar Registered, tal y como se muestra en el siguiente ejemplo de salida:

Namespace                          RegistrationState    RegistrationPolicy
---------------------------------  -------------------  --------------------
Microsoft.KubernetesConfiguration  Registered           RegistrationRequired

Si el proveedor se muestra como NotRegistered, registre el proveedor con el comando az provider register tal como se muestra en el siguiente ejemplo:

az provider register --namespace Microsoft.KubernetesConfiguration

Registre la característica ExtenstionTypes en la suscripción de Azure

La característica ExtensionTypes debe registrarse en la suscripción de Azure. En el terminal, compruebe que está en la suscripción correcta:

az account set --subscription <YOUR-AZURE-SUBSCRIPTION-ID>

Registre la característica ExtenstionTypes.

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

El registro de características puede tardar algún tiempo. Después de unos minutos, compruebe el estado del registro mediante el comando siguiente:

az feature show --namespace Microsoft.KubernetesConfiguration --name ExtensionTypes

Implementación de la extensión Dapr en el clúster de Kubernetes habilitado para AKS o Arc

Cree una plantilla de Bicep similar al ejemplo siguiente para implementar la extensión Dapr en el clúster 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'
  }
}

Establezca las siguientes variables y cambie los valores siguientes a los nombres reales del grupo de recursos y del clúster.

MY_RESOURCE_GROUP=<myResourceGroup>
MY_AKS_CLUSTER=<myAKSCluster>

Implemente la plantilla de Bicep mediante el comando az deployment group.

az deployment group create \
  --resource-group $MY_RESOURCE_GROUP \
  --template-file ./my-bicep-file-path.bicep \
  --parameters clusterName=$MY_AKS_CLUSTER

Configuración de actualizaciones automáticas en el plano de control de Dapr

Advertencia

Puede habilitar las actualizaciones automáticas en el plano de control de Dapr solo en entornos de desarrollo o pruebas. La actualización automática no es adecuada para entornos de producción.

Si implementa Dapr sin especificar una versión, autoUpgradeMinorVersion se habilita automáticamente, configurando el plano de control de Dapr para actualizar automáticamente su versión secundaria en nuevas versiones.

Puede deshabilitar la actualización automática especificando el parámetro autoUpgradeMinorVersion y estableciendo el valor en false.

El control de versiones de Dapr tiene el formato MAJOR.MINOR.PATCH, lo que significa que 1.11.0 a 1.12.0 es una actualización de versión secundaria.

properties {
  autoUpgradeMinorVersion: true
}

Obtención como destino una versión específica de Dapr

Nota

Dapr se admite con una ventana gradual, que incluye solo las versiones actuales y anteriores. Es su responsabilidad operativa mantenerse actualizado a estas versiones admitidas. Si tiene una versión más antigua de Dapr, es posible que deba realizar actualizaciones intermedias para llegar a una versión admitida.

Establezca autoUpgradeMinorVersion en false y version en la versión de Dapr que quiere instalar. Si el parámetro autoUpgradeMinorVersion se establece en true, y version se omite parámetro, la extensión instala la versión más reciente de Dapr.

Por ejemplo, para usar Dapr 1.11.2:

properties: {
  autoUpgradeMinorVersion: false
  version: '1.11.2'
}

Elección de una serie de versiones

Al configurar la extensión, puede optar por instalar Dapr desde un tren de versión determinado. Especifique uno de los dos valores de entrenamiento de versión:

Value	Descripción
stable	Predeterminada.
dev	Versiones preliminares que pueden contener características experimentales. No son adecuadas para producción.

Por ejemplo:

properties: {
  releaseTrain: 'stable'
}

Solución de errores de la extensión

Si la extensión no puede crear o actualizar, pruebe sugerencias y soluciones en la guía de solución de problemas de la extensión de Dapr.

Solución de problemas de Dapr

Solucione los errores de Dapr a través de la guía de incidencias y soluciones comunes de Dapr.

Eliminación de la extensión

Si necesita eliminar la extensión y quitar Dapr del clúster de AKS, puede usar el siguiente comando:

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

O bien, puede quitar la plantilla de Bicep.

Pasos siguientes

Configurar la extensión Dapr para su escenario único