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 tempo de execução. As configurações de Dapr disponíveis nos Aplicativos de Contêiner do Azure são consideradas alterações no escopo do aplicativo . Quando você executa um aplicativo de contêiner no modo de várias revisões, as alterações nessas configurações não criam uma nova revisão. Em vez disso, todas as revisões existentes são reiniciadas para garantir que sejam configuradas com os valores mais atualizados.

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

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

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

CLI de aplicativos de contêiner	Campo Modelo	Descrição
`--enable-dapr`	`dapr.enabled`	Habilita o Dapr no aplicativo contêiner.
`--dapr-app-port`	`dapr.appPort`	A porta em que seu aplicativo está escutando e que é 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 Dapr exclusivo para 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 upload 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 de cabeçalho http para manipular ao enviar cabeçalhos de vários KB. A configuração padrão é `4 KB`.
`--dapr-api-logging`	`dapr.enableApiLogging`	Permite visualizar as chamadas de API do seu aplicativo para o sidecar Dapr.
`--dapr-log-level`	`dapr.logLevel`	Defina o nível de log para o sidecar Dapr. Valores permitidos: debug, error, info, warn. 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 booleano. A configuração padrão é `false`. A saúde do Dapr Sidecar está ligada a esta definição de saúde da aplicação.
`--dapr-app-health-path`	`dapr.appHealth.path`	Defina o caminho que o Dapr invoca para testes de integridade 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 sonda de integridade. 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 a aplicação seja considerada pouco saudável. A configuração padrão é `3`.
`--dapr-max-concurrency`	`dapr.maxConcurrency`	Limite a simultaneidade do seu aplicativo. Um valor válido é qualquer número maior que `0`. `-1` significa que não há limite para a 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, consulte a documentação de referência.

Usando Bíceps ou ARM

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

Bíceps
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
  }

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

Utilizar o portal do Azure

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

Nota

Antes de começar, certifique-se de que já criou os seus próprios componentes Dapr. Você pode conectar componentes do Dapr por meio do ambiente do 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á desativado. Selecione Ativado para expandir as configurações do Dapr.

Captura de tela do Dapr sendo desativado por padrão e onde clicar para ativá-lo.

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

Captura de tela mostrando algumas configurações básicas para habilitar o Dapr no aplicativo contêiner.

Próximos passos

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

Feedback

Esta página foi útil?

Last updated on 2025-05-07