Conexão RabbitMQ
Introdução
Uma conexão RabbitMQ, criada usando o conector RabbitMQ, estabelece acesso ao RabbitMQ. Uma vez que uma conexão é configurada, é possível criar instâncias de atividades RabbitMQ associadas a essa conexão para serem usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).
O conector RabbitMQ suporta o Protocolo Avançado de Filas de Mensagens (AMQP), um protocolo para mensagens empresariais. O uso do AMQP requer uma conexão segura e certificados certificados por CA.
Nota
Este conector suporta a política de organização Habilitar Reautenticação em Caso de Alteração. Se habilitado, uma alteração no Hostname, Username ou Virtual Host nesta conexão requer que os usuários reentrem a Senha para a conexão.
Criar ou editar uma conexão RabbitMQ
Uma nova conexão RabbitMQ é criada usando o conector RabbitMQ a partir de uma destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A página Endpoints Globais (veja Criar um endpoint global em Endpoints Globais).
Uma conexão RabbitMQ existente pode ser editada a partir destas localizações:
- A aba Endpoints e conectores do projeto na paleta de componentes de design (veja Paleta de componentes de design).
- A aba Componentes do painel do projeto (veja Menu de ações de componentes em Aba Componentes do painel do projeto).
- A página Endpoints Globais (veja Editar um endpoint global em Endpoints Globais).
Configurar uma conexão RabbitMQ
Cada elemento da interface do usuário da tela de configuração da conexão RabbitMQ é descrito abaixo.
Dica
Campos com um ícone de variável suportam o uso de variáveis globais, variáveis de projeto e variáveis Jitterbit. Comece digitando um colchete aberto [ no campo ou clicando no ícone de variável para exibir um menu com as variáveis existentes para escolher.
-
Nome da Conexão: Insira um nome para identificar a conexão. O nome deve ser único para cada conexão RabbitMQ e não deve conter barras
/ou dois pontos:. Este nome também é usado para identificar o endpoint RabbitMQ, que se refere tanto a uma conexão específica quanto às suas atividades. -
Nome do Host: Insira o host para a instância.
-
Porta: Insira a porta para a instância. As portas padrão para instâncias RabbitMQ são a porta
5672para conexões regulares; e5671para conexões que usam TLS. -
Nome de Usuário: Insira o nome de usuário para a instância.
-
Senha: Insira a senha para a instância.
-
Host Virtual: Insira o host virtual.
-
Protocolo de Segurança a ser usado: Selecione o protocolo de segurança a ser usado, seja Nenhum, TLSv1.0, TLSv1.1, TLSv1.2, TLSv1.3. Para mais informações, consulte a documentação TLS do RabbitMQ.
-
Teste: Clique para verificar a conexão usando a configuração fornecida. Quando a conexão é testada, a versão mais recente do conector é baixada pelos agentes no grupo de agentes associado ao ambiente atual. Este conector suporta a suspensão do download da versão mais recente do conector usando a política de organização Desativar Atualização Automática do Conector.
-
Salvar Alterações: Clique para salvar e fechar a configuração da conexão.
-
Descartar Alterações: Após fazer alterações em uma configuração nova ou existente, clique para fechar a configuração sem salvar. Uma mensagem solicita que você confirme que deseja descartar as alterações.
-
Excluir: Após abrir uma configuração de conexão existente, clique para excluir permanentemente a conexão do projeto e fechar a configuração (veja Dependências de componentes, exclusão e remoção). Uma mensagem solicita que você confirme que deseja excluir a conexão.
Próximas etapas
Após a criação de uma conexão RabbitMQ, você coloca um tipo de atividade na tela de design para criar instâncias de atividade que serão usadas como fontes (para fornecer dados em uma operação) ou como alvos (para consumir dados em uma operação).
As ações do menu para uma conexão e seus tipos de atividade estão acessíveis no painel do projeto e na paleta de componentes de design. Para mais detalhes, veja Menus de ações em Fundamentos do conector.
Estes tipos de atividade estão disponíveis:
-
Publicar em Lote: Publica um lote de mensagens em um exchange no RabbitMQ e é destinado a ser usado como um alvo em uma operação.
-
Obter em Lote: Recupera um lote de mensagens disponíveis em uma fila específica do RabbitMQ e é destinado a ser usado como uma fonte em uma operação.
-
Reconhecer: Reconhece uma mensagem (usando um
ackId) no RabbitMQ e é destinado a ser usado como um alvo em uma operação. -
Obter: Recupera mensagens de uma fila do RabbitMQ e é destinado a ser usado como uma fonte em uma operação.
-
Publicar: Publica uma mensagem em um exchange no RabbitMQ e é destinado a ser usado como um alvo em uma operação.
-
Consumir: Consome mensagens de uma fila do RabbitMQ e é destinado a ser usado como uma fonte em uma operação.