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 infraestructura como código (IaC), como en las plantillas de Bicep o 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 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 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	Establezca 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	Establezca la ruta de acceso que Dapr invoca para los sondeos de estado cuando el canal de la aplicación sea 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	Limite 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

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.

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
  }

BRAZO

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

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.

Pasos siguientes

Obtenga más información acerca de los componentes de Dapr en Azure Container Apps.