Partilhar via

Visão geral das ligações RabbitMQ para Azure Functions

O Azure Functions integra-se ao RabbitMQ por meio de gatilhos e associações.

Nota

As associações RabbitMQ só são totalmente suportadas nos planos Elastic Premium e Dedicated (App Service). Os planos Flex Consumption e Consumption ainda não são suportados.

As associações RabbitMQ não são suportadas pelo tempo de execução do Azure Functions v1.x.

A extensão RabbitMQ do Azure Functions permite enviar e receber mensagens usando a API RabbitMQ com Functions.

Ação Tipo
Execute uma função quando uma mensagem RabbitMQ passar pela fila Acionador
Enviar mensagens RabbitMQ Vinculação de saída

Pré-requisitos

Antes de trabalhar com a extensão RabbitMQ, você deve configurar seu endpoint RabbitMQ. Para saber mais sobre o RabbitMQ, consulte a página de introdução.

Instalar a extensão

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

As funções são executadas em um processo de trabalho C# isolado. Para saber mais, consulte Guia para executar o C# Azure Functions em um processo de trabalho isolado.

Adicione a extensão ao seu projeto instalando este pacote NuGet.

Instalar pacote

Para poder usar essa extensão de associação em seu aplicativo, certifique-se de que o arquivo dehost.json na raiz do seu projeto contém esta extensionBundle referência:

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

Neste exemplo, o version valor de instrui o host Functions a usar uma versão de [4.0.0, 5.0.0) pacote que seja pelo menos 4.0.0 , mas menor que 5.0.0, que inclui todas as versões potenciais do 4.x. Essa notação mantém efetivamente seu aplicativo na versão secundária mais recente disponível do pacote de extensão v4.x.

Quando possível, você deve usar a versão principal mais recente do pacote de extensão e permitir que o tempo de execução mantenha automaticamente a versão secundária mais recente. Você pode visualizar o conteúdo do pacote mais recente na página de lançamento dos pacotes de extensão. Para obter mais informações, consulte Pacotes de extensão do Azure Functions.

configurações host.json

Esta seção descreve as definições de configuração disponíveis para essa associação na versão 2.x e posterior. As configurações no arquivo host.json aplicam-se a todas as funções em uma instância de aplicativo de função. Para obter mais informações sobre definições de configuração de aplicativo de função, consulte host.json referência para o Azure Functions.

{
    "version": "2.0",
    "extensions": {
        "rabbitMQ": {
            "prefetchCount": 100,
            "queueName": "queue",
            "connectionString": "%<MyConnectionAppSetting>%",
            "port": 10
        }
    }
}
Propriedade Predefinido Description
prefetchCount 30 Obtém ou define o número de mensagens que o destinatário da mensagem pode solicitar simultaneamente e é armazenado em cache.
queueName n/d Nome da fila de onde receber mensagens.
connectionString n/d A configuração do aplicativo que contém a cadeia de conexão da fila de mensagens RabbitMQ.
port 0 (ignorado se estiver usando connectionString) Obtém ou define a porta usada. O padrão é 0, o que aponta para a configuração de porta padrão do cliente rabbitmq: 5672.
  • Last updated on