Extensão Dapr para Azure Functions

Artigo
02/06/2024

Importante

A Extensão Dapr para Azure Functions está atualmente em pré-visualização e apenas tem suporte em ambientes de Aplicativos de Contêiner do Azure.

A Extensão Dapr para Azure Functions é um conjunto de ferramentas e serviços que permitem aos programadores integrar facilmente o Azure Functions com a plataforma Distributed Application Runtime (Dapr).

O Azure Functions é um serviço de computação controlado por eventos que fornece um conjunto de gatilhos e associações para se conectar facilmente a outros serviços do Azure. O Dapr fornece um conjunto de blocos de construção e práticas recomendadas para a criação de aplicativos distribuídos, incluindo microsserviços, gerenciamento de estado, mensagens pub/sub e muito mais.

Com a integração entre Dapr e Functions, você pode criar funções que reagem a eventos do Dapr ou de sistemas externos.

Ação	Direção	Type
Gatilho em uma ligação de entrada Dapr	N/A	daprBindingTrigger
Gatilho em uma invocação de serviço Dapr	N/A	daprServiceInvocationTrigger
Gatilho em uma assinatura de tópico do Dapr	N/A	daprTopicTrigger
Puxe o estado Dapr para uma execução	Está presente em	daprState
Puxe os segredos do Dapr para uma execução	Está presente em	daprSecret
Salvar um valor em um estado Dapr	Do destino para a origem	daprState
Invoque outro aplicativo Dapr	Do destino para a origem	daprInvoke
Publicar uma mensagem em um tópico do Dapr	Do destino para a origem	daprPublicar
Enviar um valor para uma ligação de saída Dapr	Do destino para a origem	daprBinding

Instalar a extensão

O pacote NuGet de extensão que você instala depende do processo de trabalho isolado ou em processo do modo C# que você está usando em seu aplicativo de função:

Em processo
Processo isolado

Esta extensão está disponível instalando o pacote NuGet, versão 0.17.0-preview01.

Usando a CLI do .NET:

dotnet add package Microsoft.Azure.WebJobs.Extensions.Dapr --prerelease

Adicione a extensão ao seu projeto instalando o pacote NuGet, versão 0.17.0-preview01.

Usando a CLI do .NET:

dotnet add package Microsoft.Azure.Functions.Worker.Extensions.Dapr --prerelease

Instalar pacote

Pacote de pré-visualização v4.x

Você pode adicionar a extensão de visualização adicionando ou substituindo o seguinte código em seu host.json arquivo:

{
  "version": "2.0",
  "extensionBundle": {
    "id": "Microsoft.Azure.Functions.ExtensionBundle.Preview",
    "version": "[4.*, 5.0.0)"
  }
}

Habilitação Dapr

Você pode configurar o Dapr usando vários [argumentos e anotações][dapr-args] com base no contexto de tempo de execução. Você pode configurar o Dapr para Azure Functions por meio de dois canais:

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

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

Bicep
BRAÇO

DaprConfig: {
  enabled: true
  appId: '${envResourceNamePrefix}-funcapp'
  appPort: 3001
  httpReadBufferSize: ''
  httpMaxRequestSize: ''
  logLevel: ''
  enableApiLogging: true
}

"DaprConfig": {
  "enabled": true,
  "appId": "${envResourceNamePrefix}-funcapp",
  "appPort": 3001,
  "httpReadBufferSize": "",
  "httpMaxRequestSize": "",
  "logLevel": "",
  "enableApiLogging": true
}

Os valores de configuração do Dapr acima são considerados alterações no escopo do aplicativo. Quando você executa um aplicativo 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.

Ao configurar o Dapr usando o portal do Azure, navegue até seu aplicativo de função e selecione Dapr no menu do lado esquerdo:

Screenshot demonstrating where to find Dapr enablement for a Function App in the Azure portal.

Portas Dapr e ouvintes

Quando você aciona uma função do Dapr, a extensão expõe a porta 3001 automaticamente para ouvir as solicitações recebidas do sidecar do Dapr.

Importante

A porta 3001 só é exposta e ouvida se um gatilho Dapr for definido no aplicativo de função. Ao usar o Dapr, o sidecar aguarda receber uma resposta da porta definida antes de concluir a instanciação. Não defina a anotação ou --app-port a dapr.io/port menos que você tenha um gatilho. Se o fizer, poderá bloquear a sua aplicação a partir do sidecar Dapr.

Se você estiver usando apenas ligações de entrada e saída, a porta 3001 não precisará ser exposta ou definida.

Por padrão, quando o Azure Functions tenta se comunicar com o Dapr, ele chama o Dapr pela porta resolvida a partir da variável DAPR_HTTP_PORTde ambiente . Se essa variável for null, o padrão será port 3500.

Você pode substituir o endereço Dapr usado pelas ligações de entrada e saída definindo a propriedade no function.json para a DaprAddress associação (ou o atributo). Por padrão, ele usa http://localhost:{DAPR_HTTP_PORT}.

O aplicativo de função ainda expõe outra porta e ponto de extremidade para coisas como gatilhos HTTP, que localmente assume 7071como padrão , mas em um contêiner, o padrão é .80

Tipos de vinculação

Os tipos de associação suportados para .NET dependem da versão da extensão e do modo de execução C#, que pode ser um dos seguintes:

Biblioteca de classes em processo
Processo isolado

Uma biblioteca de classes em processo é uma função C# compilada executada no mesmo processo que o tempo de execução do Functions.

A extensão Dapr suporta tipos de parâmetros de acordo com a tabela abaixo.

Enlace	Tipos de parâmetros
Gatilho Dapr	daprBindingTrigger daprServiceInvocationTrigger daprTopicTrigger
Entrada Dapr	daprState daprSecret
Saída Dapr	daprState daprInvoke daprPublicar daprBinding

Para obter exemplos usando esses tipos, consulte o repositório GitHub para a extensão.