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 tempo de execução. Os Aplicativos de Contêiner do Azure fornecem três canais por meio dos quais você pode habilitar 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	Description
--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 predefiniçã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. 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. 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 predefiniçã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, 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.

Bicep

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

BRAÇO

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

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.

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.

Próximos passos

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