Configurar o Dapr em um aplicativo de contêiner existente

Você pode configurar o Dapr usando vários argumentos e anotações com base no contexto de runtime. As configurações do Dapr disponíveis nos Aplicativos de Contêiner do Azure são consideradas alterações de escopo do aplicativo. Ao executar um aplicativo de contêiner em vários modos de revisão, as alterações nessas configurações não criam uma nova revisão. Em vez disso, todas as revisões existentes serão reiniciadas para garantir que elas estejam configuradas com os valores mais atualizados.

Os Aplicativos de Contêiner do Azure fornecem três canais pelos quais você pode habilitar e configurar o Dapr:

• A CLI do Azure
• Modelos de IaC (infraestrutura como código), como os modelos do Bicep ou do ARM (Azure Resource Manager)
• O portal do Azure

A tabela a seguir descreve a lista atualmente com suporte das configurações de sidecar do Dapr para habilitar o Dapr nos Aplicativos de Contêiner do Azure:

CLI do Aplicativos de Contêiner	Campo de modelo	Descrição
--enable-dapr	dapr.enabled	Habilita o Dapr no aplicativo de contêiner.
--dapr-app-port	dapr.appPort	A porta que seu aplicativo está escutando será usada pelo Dapr para se comunicar com seu aplicativo.
--dapr-app-protocol	dapr.appProtocol	Informa ao Dapr qual protocolo seu aplicativo está usando. As opções válidas são http ou grpc. A configuração padrão é http.
--dapr-app-id	dapr.appId	Um identificador exclusivo do Dapr para o seu aplicativo de contêiner, usado para descoberta de serviço, encapsulamento de estado e ID de consumidor pub/sub.
--dapr-max-request-size	dapr.httpMaxRequestSize	Defina o tamanho máximo dos servidores http e grpc do corpo da solicitação para lidar com o carregamento de arquivos grandes. A configuração padrão é 4 MB.
--dapr-read-buffer-size	dapr.httpReadBufferSize	Defina o tamanho máximo do buffer de leitura do cabeçalho http para lidar ao enviar cabeçalhos multi-KB. A configuração padrão é 4 KB.
--dapr-api-logging	dapr.enableApiLogging	Habilita a exibição de chamadas à API do seu aplicativo para o sidecar do Dapr.
--dapr-log-level	dapr.logLevel	Defina o nível de log para o sidecar do Dapr. Valores permitidos: depuração, erro, informações, aviso. A configuração padrão é info.
--dapr-app-health-enabled	dapr.appHealth.enabled	Configuração opcional para habilitar verificações de integridade do aplicativo para seu aplicativo de contêiner usando o formato booliano. A configuração padrão é false.
--dapr-app-health-path	dapr.appHealth.path	Configure o caminho que o Dapr usa para sondas de saúde quando o canal do aplicativo é HTTP. Esse valor será ignorado se o canal do aplicativo estiver usando gRPC. A configuração padrão é /healthz.
--dapr-app-health-probe-interval	dapr.appHealth.probeIntervalSeconds	Número de segundos entre cada verificação de saúde. A configuração padrão é 3.
--dapr-app-health-probe-timeout	dapr.appHealth.probeTimeoutMilliseconds	Tempo limite em milissegundos para solicitações de verificação de saúde. Esse valor deve ser menor que o probeIntervalSeconds valor. A configuração padrão é 500.
--dapr-app-health-threshold	dapr.appHealth.threshold	Número máximo de falhas consecutivas antes que o app seja considerado não saudável. A configuração padrão é 3.
--dapr-max-concurrency	dapr.maxConcurrency	Limite a concorrência do seu aplicativo. Um valor válido é qualquer número maior que 0. -1 significa que não há limite de simultaneidade.

Usando a CLI

Você pode habilitar o Dapr em seu aplicativo de contêiner usando a CLI do Azure.

az containerapp dapr enable

Para obter mais informações e exemplos, confira a documentação de referência.

Usar o Bicep ou o ARM

Ao usar um modelo de IaC, especifique os seguintes argumentos na seção properties.configuration da definição de recurso do aplicativo de contêiner.

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
  }

BRAÇO

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

Usando o portal do Azure

Você também pode habilitar o Dapr por meio da exibição do portal de seus aplicativos de contêiner.

Observação

Antes de começar, verifique se você já criou seus próprios componentes Dapr. Você pode conectar componentes Dapr por meio do ambiente de aplicativo de contêiner no portal.

Navegue até seu aplicativo de contêiner no portal do Azure e selecione Dapr em Configurações no menu do lado esquerdo.

Por padrão, o Dapr está desabilitado. Selecione Habilitado para expandir as configurações do Dapr.

Insira a ID do aplicativo de componente e selecione os títulos apropriados. Se aplicável, no cabeçalho Componentes, selecione o link para adicionar e gerenciar os componentes do Dapr ao ambiente do aplicativo de contêiner.

Próximas etapas

Saiba mais sobre os componentes do Dapr nos Aplicativos de Contêiner do Azure.