Habilitar 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. Os Aplicativos de Contêiner do Azure fornecem três canais pelos quais você pode habilitar 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. 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. 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. 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. O padrão é info.

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.

Bicep

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

ARM

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

Os valores de configuração do Dapr acima são considerados alterações no 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.

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.