Habilitar Dapr en las aplicaciones contenedoras

  • Artículo

Puede configurar Dapr mediante varios argumentos y anotaciones basados en el contexto en tiempo de ejecución. Azure Container Apps proporciona tres canales mediante los cuales puede configurar Dapr:

En la tabla siguiente se describe la lista admitida actualmente de configuraciones de sidecar de Dapr para habilitar Dapr en Azure Container Apps:

CLI de Container Apps Campo de plantilla Descripción
--enable-dapr dapr.enabled Habilita Dapr en la aplicación de contenedor.
--dapr-app-port dapr.appPort El puerto que escucha la aplicación y que Dapr usará para comunicarse con ella
--dapr-app-protocol dapr.appProtocol Indica a Dapr qué protocolo usa la aplicación. Las opciones válidas son http o grpc. El valor predeterminado es http.
--dapr-app-id dapr.appId Identificador Dapr único para la aplicación contenedora que se usa para la detección de servicios, la encapsulación de estado y el id. consumidor de pub/sub.
--dapr-max-request-size dapr.httpMaxRequestSize Establezca el tamaño máximo de los servidores HTTP y gRPC del cuerpo de la solicitud para controlar la carga de archivos grandes. El valor predeterminado es 4 MB.
--dapr-read-buffer-size dapr.httpReadBufferSize Establezca el tamaño máximo del búfer de lectura de encabezado http para controlarlo al enviar encabezados de varios KB. El valor predeterminado de 4 KB.
--dapr-api-logging dapr.enableApiLogging Permite ver las llamadas API de la aplicación al sidecar de Dapr.
--dapr-log-level dapr.logLevel Establezca el nivel de registro del sidecar de Dapr. Valores permitidos: debug, error, info, warn. El valor predeterminado es info.

Uso de la CLI

Puede habilitar Dapr en la aplicación contenedora mediante la CLI de Azure.

az containerapp dapr enable

Para obtener más información y ejemplos, consulte la documentación de referencia.

Uso de Bicep o ARM

Al usar una plantilla de IaC, especifique los argumentos siguientes en la sección properties.configuration de la definición de recursos de la aplicación de contenedor.

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
 }

Los valores de configuración de Dapr anteriores se consideran cambios en el ámbito de la aplicación. Al ejecutar una aplicación de contenedor en el modo de revisión múltiple, los cambios en esta configuración no crearán una nueva revisión. En su lugar, se reiniciarán todas las revisiones existentes para asegurarse de que están configuradas con los valores más recientes.

Uso de Azure Portal

También puede habilitar Dapr a través de la vista del portal de las aplicaciones de contenedor.

Nota:

Antes de empezar, asegúrese de haber creado sus propios componentes de Dapr. Puede conectar los componentes de Dapr a través del entorno de la aplicación contenedora en el portal.

Vaya a la aplicación contenedora en Azure Portal y seleccione Dapr en Configuración en el menú izquierdo.

Screenshot showing where to enable Dapr in your container app via the Azure portal view.

De forma predeterminada, Dapr está deshabilitado. Seleccione Habilitado para expandir la configuración de Dapr.

Screenshot of Dapr being disabled by default and where to click to enable it.

Escriba el identificador de aplicación del componente y seleccione los encabezados adecuados. Si procede, en el encabezado Componentes, seleccione el vínculo para agregar y administrar los componentes de Dapr en el entorno de la aplicación contenedora.

Screenshot showing some basic settings for enabling Dapr on the container app.

Pasos siguientes

Pruebe a trabajar con Dapr y Azure Container Apps mediante uno de los siguientes tutoriales: