Configuración de Dapr en una aplicación de contenedor existente

Puede configurar Dapr mediante varios argumentos y anotaciones basados en el contexto en tiempo de ejecución. Las configuraciones de Dapr disponibles en Azure Container Apps 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.

Azure Container Apps proporciona tres canales a través de los cuales puede habilitar y configurar Dapr:

• La CLI de Azure
• Plantillas de Bicep o de Azure Resource Manager (ARM)
• Portal de Azure

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 en el que tu aplicación está configurada para escuchar, que Dapr usa para comunicarse con tu aplicación.
--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	Establece el tamaño máximo del cuerpo de la solicitud que los servidores HTTP y gRPC pueden manejar para la carga de archivos grandes. El valor predeterminado es 4 MB.
--dapr-read-buffer-size	dapr.httpReadBufferSize	Establece el tamaño máximo del búfer de lectura de encabezado HTTP para gestionar cuando se envían encabezados de varios KB. El valor predeterminado es 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	Establece el nivel de registro del sidecar de Dapr. Valores permitidos: debug, error, info, warn. El valor predeterminado es info.
--dapr-app-health-enabled	dapr.appHealth.enabled	Configuración opcional para habilitar las comprobaciones de estado de la aplicación para la aplicación contenedora con formato booleano. El valor predeterminado es false. La salud del Dapr sidecar está vinculada a esta configuración de salud de la aplicación.
--dapr-app-health-path	dapr.appHealth.path	Establece la ruta que Dapr invoca para las verificaciones de salud cuando el canal de la aplicación es HTTP. Este valor se omite si el canal de la aplicación usa gRPC. El valor predeterminado es /healthz.
--dapr-app-health-probe-interval	dapr.appHealth.probeIntervalSeconds	Número de segundos entre cada prueba de estado. El valor predeterminado es 3.
--dapr-app-health-probe-timeout	dapr.appHealth.probeTimeoutMilliseconds	Tiempo de espera en milisegundos para las solicitudes de sondeo de estado. Este valor debe ser menor que el probeIntervalSeconds valor. El valor predeterminado es 500.
--dapr-app-health-threshold	dapr.appHealth.threshold	Número máximo de fallos consecutivos antes de que la aplicación se considere poco saludable. El valor predeterminado es 3.
--dapr-max-concurrency	dapr.maxConcurrency	Limita la simultaneidad de la aplicación. Un valor válido es cualquier número mayor que 0. -1 significa que no hay ningún límite en la simultaneidad.

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

Para usar una plantilla de infraestructura como código (IaC), como Bicep o ARM, especifique los argumentos siguientes en la properties.configuration sección de la definición de recursos de la aplicación contenedora.

Bíceps

 dapr: {
   enabled: true
   appId: 'nodeapp'
   appProtocol: 'http'
   appPort: 3000
   httpReadBufferSize: 30
   httpMaxRequestSize: 10
   logLevel: 'debug'
   enableApiLogging: true
   appHealth: {
     enabled: true
     path: '/health'
     probeIntervalSeconds: 3
     probeTimeoutMilliseconds: 1000
     threshold: 3
   },
   maxConcurrency: 10
  }

ARM

  "dapr": {
    "enabled": true,
    "appId": "nodeapp",
    "appProtocol": "http",
    "appPort": 3000,
    "httpReadBufferSize": 30,
    "httpMaxRequestSize": 10,
    "logLevel": "debug",
    "enableApiLogging": true,
    "appHealth": {
      "enabled": true,
      "path": "/health",
      "probeIntervalSeconds": 3,
      "probeTimeoutMilliseconds": 1000,
      "threshold": 3,
    },
    "maxConcurrency": 10
  }

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 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ú de la barra lateral.

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

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.

Paso siguiente

Más información sobre los componentes de Dapr en Azure Container Apps