Consulte os conetores suportados para a solução Application Integration.

Acionador do Rabbit MQ

O acionador do Rabbit MQ é um acionador de eventos do conetor que lhe permite invocar uma integração com base nos eventos do Rabbit MQ aos quais subscreveu na sua ligação do Rabbit MQ.

Importante: os conectores de integração são um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças da utilização dos Conetores de integração, consulte o artigo Preços dos Conetores de integração.

Antes de começar

Se planeia criar ou configurar uma nova associação para o acionador do RabbitMQ, certifique-se de que tem a seguinte função do IAM no projeto:

• Administrador do conetor (roles/connectors.admin)

Para informações sobre a concessão de funções, consulte o artigo Faça a gestão do acesso.

Conceda as seguintes funções de IAM à conta de serviço que quer usar para o acionador do RabbitMQ:

• Application Integration Invoker (roles/integrations.integrationInvoker)

Para obter informações sobre a atribuição de funções a uma conta de serviço, consulte o artigo Faça a gestão do acesso às contas de serviço.

Adicione o acionador do RabbitMQ

Para adicionar um acionador do RabbitMQ à sua integração, siga estes passos:

1. Na Google Cloud consola, aceda à página Application Integration.

   Aceda à solução Application Integration

2. No menu de navegação, clique em Integrações

   A página Lista de integrações é apresentada com todas as integrações disponíveis no projeto do Google Cloud.

3. Selecione uma integração existente ou clique em Criar integração para criar uma nova.

   Se estiver a criar uma nova integração:

   1. Introduza um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
      Nota: o menu pendente Regiões apenas apresenta as regiões aprovisionadas no seu projeto do Google Cloud. Para aprovisionar uma nova região, clique em Ativar região. Consulte o artigo Ative uma nova região para mais informações.
   3. Selecione uma conta de serviço para a integração. Pode alterar ou atualizar os detalhes da conta de serviço de uma integração em qualquer altura no painel Resumo da integração na barra de ferramentas de integração.
      Nota: a opção para selecionar uma conta de serviço é apresentada apenas se tiver ativado a gestão da integração para a região selecionada.
   4. Clique em Criar.

   A integração recém-criada é aberta no editor de integração.

4. Na barra de navegação do editor de integração, clique em Acionadores para ver a lista de acionadores disponíveis.
5. Clique e coloque o elemento Acionador do RabbitMQ no editor de integração.

Para configurar o acionador do Rabbit MQ, pode usar uma ligação do Rabbit MQ existente disponível nos Integration Connectors ou criar uma nova ligação do Rabbit MQ através da opção de criação de ligações inline.

Configure o acionador do RabbitMQ através de uma associação existente

Pode configurar o acionador do Rabbit MQ através de uma ligação existente do Rabbit MQ nos Integration Connectors. Tenha em atenção que o acionador do Rabbit MQ é um acionador de eventos de conetores. Por conseguinte, só pode usar uma ligação do Rabbit MQ com a subscrição de eventos ativada para configurar o acionador.

Para obter informações sobre como configurar um acionador do Rabbit MQ através de uma nova ligação do Rabbit MQ, consulte o artigo Configure o acionador do Rabbit MQ através de uma nova ligação

Para configurar um acionador do Rabbit MQ através de uma ligação existente ao Rabbit MQ, siga estes passos:

1. Clique no elemento Acionador do RabbitMQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Forneça os seguintes detalhes de configuração na página Editor do acionador de eventos do conetor:
   1. Região: selecione a região da sua ligação RabbitMQ.
   2. Ligação: selecione a ligação Rabbit MQ que quer usar.

      A integração de aplicações só apresenta as ligações do RabbitMQ que estão ativas e têm uma subscrição de eventos ativada.

   3. Selecione Queue ou Tópico como JMS Source Type.
      • Se selecionar Queue, indique o nome da fila do RabbitMQ na coluna JMS Source Name.
      • Se selecionar Topic, indique o nome do tópico do Rabbit MQ na coluna Nome da origem JMS.
   4. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para o acionador do RabbitMQ.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador do RabbitMQ com uma nova ligação

Para configurar o acionador do RabbitMQ através de uma nova ligação do RabbitMQ, siga estes passos:

1. Clique no elemento Acionador do RabbitMQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador.
3. Ignore o campo Região.
4. Clique em Associação e selecione a opção Criar associação no menu pendente.
5. Conclua os seguintes passos no painel Criar associação:
   1. No passo Localização, escolha a localização para a nova ligação do RabbitMQ:
      1. Região: selecione uma região na lista pendente.
      2. Clicar em Seguinte.
   2. No passo Detalhes da ligação, forneça detalhes sobre a nova ligação do Rabbit MQ:
      1. Versão do conector: escolha uma versão disponível do conector do Rabbit MQ na lista pendente.
      2. Nome da associação: introduza um nome para a associação do RabbitMQ.
         Nota: os nomes das associações têm de cumprir os seguintes critérios:

         • Os nomes das associações podem usar letras, números ou hífenes.
         • As letras têm de ser minúsculas.
         • Os nomes das associações têm de começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das associações não podem exceder 63 carateres.
      3. (Opcional) Descrição: introduza uma descrição para a associação.
      4. (Opcional) Ativar registo na nuvem: selecione esta caixa de verificação para armazenar todos os dados de registo da ligação.
      5. Conta de serviço: selecione uma conta de serviço com as funções do IAM necessárias para a associação do RabbitMQ.
      6. Ativar subscrição de eventos: selecione esta opção para ativar a subscrição de eventos para a ligação do RabbitMQ.
         Nota: este conector não suporta a opção Enable only event subscription.
      7. (Opcional) Expanda Definições avançadas para configurar as definições do nó de ligação.

         Para mais informações acerca das definições do nó de ligação para o Rabbit MQ, consulte a documentação Ligação do Rabbit MQ.

      8. (Opcional) Clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par de chave-valor.
      9. Clicar em Seguinte.
   3. No passo Destinos, indique os detalhes da instância do RabbitMQ:
      1. Tipo de destino: selecione Endereço do anfitrião.
      2. Anfitrião: introduza o nome de anfitrião ou o endereço IP da sua instância do RabbitMQ.
      3. Clicar em Seguinte.
   4. Opcionalmente, se quiser usar SSL, selecione Ativar SSL. São apresentados os detalhes da configuração SSL.
      1. Selecione um tipo de loja fidedigna. Pode ser Público, Privado ou Ligação não segura.
      2. Selecione os certificados conforme apresentado com base na sua seleção da loja de confiança.
      3. Se estiver a usar o mTLS, selecione os certificados do armazenamento de chaves na secção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão do TLS.
      5. Introduza o conjunto de cifras suportado. Introduza várias suites de cifragem como valores separados por vírgulas. Para mais informações, consulte o artigo Conjuntos de cifras suportados.
      Nota:

      • Todos os seus certificados têm de ser certificados X.509 e têm de estar no formato PEM (Privacy Enhanced Mail).
      • Não pode selecionar diretamente um certificado quando configura o SSL. Tem de armazenar todos os seus certificados e chaves privadas como um segredo do Secret Manager e, em seguida, selecionar o segredo necessário durante a configuração SSL.
   5. No passo Autenticação, indique os detalhes de autenticação da instância do RabbitMQ:
      1. Selecione o tipo de autenticação pretendido e introduza os detalhes relevantes para aceder ao URL do anfitrião do RabbitMQ fornecido.

         Para saber como configurar estes tipos de autenticação, consulte o artigo Configurar autenticação.

      2. Clicar em Seguinte.
   6. Rever: reveja os detalhes da ligação do RabbitMQ fornecidos.
   7. Clique em Criar para concluir a criação de uma nova ligação do RabbitMQ.
6. Clique em Concluído e feche a página.

Conjuntos de cifras suportados

Versão do TLS	Conjuntos de cifras suportados
1.2	TLS_ECDHE_ECDSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_ECDSA_WITH_AES_128_CBC_SHA256 TLS_ECDHE_ECDSA_WITH_AES_256_CBC_SHA384 TLS_ECDHE_RSA_WITH_AES_128_GCM_SHA256 TLS_ECDHE_RSA_WITH_AES_256_GCM_SHA384 TLS_ECDHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_128_GCM_SHA256 TLS_DHE_RSA_WITH_AES_256_GCM_SHA384 TLS_DHE_RSA_WITH_AES_128_CBC_SHA TLS_DHE_RSA_WITH_AES_256_CBC_SHA TLS_DHE_RSA_WITH_AES_128_CBC_SHA256 TLS_DHE_RSA_WITH_AES_256_CBC_SHA256
1.3	TLS_AES_256_GCM_SHA384 TLS_CHACHA20_POLY1305_SHA256 TLS_AES_128_GCM_SHA256

Saída do acionador

O acionador do Rabbit MQ demora alguns minutos a concluir a configuração da subscrição de eventos. Pode ver o estado da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

O acionador do RabbitMQ indica o estado de uma subscrição de eventos através dos seguintes estados:

• Creating: indica que o acionador está a subscrever a subscrição de eventos.
• Active: indica que o acionador subscreveu com êxito uma subscrição de eventos.
• Error: indica que existe um problema com a subscrição de eventos configurada.

Além do estado da subscrição de eventos, a secção Detalhes da subscrição de eventos também apresenta outros detalhes, como a região de ligação, o nome da ligação e o nome da subscrição de eventos.

A imagem seguinte mostra um exemplo de esquema do painel de configuração do acionador do RabbitMQ:

Variável de saída do acionador

Para cada evento, o acionador do RabbitMQ gera uma variável de saída ConnectorEventPayload (no formato JSON) que pode usar nas tarefas posteriores. A variável terá a carga útil do seu evento Rabbit MQ. Por exemplo:

{
"message": "Hello world",
"messageContentType": "Text"
}

Veja as subscrições de eventos

Para ver e gerir todas as subscrições de eventos associadas a uma ligação nos Integration Connectors, faça o seguinte:

1. Aceda à página Integration Connectors > Ligações.

   Aceda à página Ligações

2. Clique na associação para a qual quer ver as subscrições.
3. Clique no separador Subscrições de eventos.

   Esta apresenta todas as subscrições de eventos da associação.

Edite o acionador do Rabbit MQ

Pode editar um acionador do RabbitMQ para alterar ou atualizar a configuração da ligação e os detalhes da subscrição de eventos.

Importante: quando edita ou modifica um acionador do RabbitMQ, pode manter a subscrição de eventos configurada anteriormente associada ao acionador ou eliminá-la. A eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam essa subscrição de eventos.

Para editar um acionador do Rabbit MQ, siga estes passos:

1. Clique no elemento Acionador do RabbitMQ no editor de integração para abrir o painel de configuração do acionador.
2. Clique em Configurar acionador do RabbitMQ.
3. Faça o seguinte na página Editor de acionadores de eventos do conetor:
   1. Para manter a subscrição de eventos configurada anteriormente, clique em Manter. Caso contrário, clique em Eliminar.
      Aviso: a eliminação de uma subscrição de eventos afeta todas as integrações publicadas que usam a subscrição de eventos. Não é possível anular esta tarefa.
   2. Atualize a configuração da associação e os detalhes da subscrição de eventos conforme pretendido.
   3. Clique em Concluído.

Pode ver os detalhes atualizados da associação e da subscrição de eventos no painel de configuração do acionador em Detalhes da subscrição de eventos.

Quotas e limites

Para informações sobre quotas e limites, consulte o artigo Quotas e limites.

O que se segue?

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais acerca do processamento de erros.
• Saiba mais sobre os registos de execução da integração.