Consulte os conectores compatíveis com a integração de aplicativos.

Gatilho do Rabbit MQ

O gatilho Rabbit MQ é um gatilho de evento de conector que permite invocar uma integração com base nos eventos do Rabbit MQ em que você se inscreveu na sua conexão do Rabbit MQ.

Antes de começar

Se você planeja criar ou configurar uma nova conexão para o gatilho do Rabbit MQ, verifique se tem o seguinte papel do IAM no projeto:

• Administrador do conector (roles/connectors.admin)

Para mais informações sobre como conceder papéis, consulte Gerenciar o acesso.

Conceda os seguintes papéis do IAM à conta de serviço que você quer usar para o gatilho do Rabbit MQ:

• Invocador do Application Integration (roles/integrations.integrationInvoker)

Para informações sobre como conceder papéis a uma conta de serviço, consulte Gerenciar o acesso a contas de serviço.

Adicionar o acionador do RabbitMQ

Para adicionar um gatilho Rabbit MQ à sua integração, siga estas etapas:

1. No console do Google Cloud, acesse a página Application Integration.

   Acessar o Application Integration

2. No menu de navegação, clique em Integrations.

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

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

   Caso você esteja criando uma nova integração, siga estas etapas:

   1. Insira um nome e uma descrição no painel Criar integração.
   2. Selecione uma região para a integração.
   3. Selecione uma conta de serviço para a integração. Você pode mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel info Resumo da integração na barra de ferramentas da integração.
   4. Clique em Criar.

   Isso abre a integração na página do editor de integração.

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

Para configurar o acionador do RabbitMQ, use uma conexão do RabbitMQ disponível nos Integration Connectors ou crie uma nova usando a opção de criação de conexão inline.

Configurar o gatilho Rabbit MQ usando uma conexão atual

É possível configurar o acionador do RabbitMQ usando uma conexão do RabbitMQ em Integration Connectors. O gatilho Rabbit MQ é um gatilho de evento de conector. Portanto, só é possível usar uma conexão do Rabbit MQ com a assinatura de eventos ativada para configurar o acionador.

Para saber como configurar um gatilho do RabbitMQ usando uma nova conexão do RabbitMQ, consulte Configurar o gatilho do RabbitMQ usando uma nova conexão.

Para configurar um gatilho do RabbitMQ usando uma conexão do RabbitMQ, siga estas etapas:

1. Clique no elemento Rabbit MQ trigger no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar acionador.
3. Informe os seguintes detalhes de configuração na página Editor de gatilho de evento do conector:
   1. Região:selecione a região da sua conexão do Rabbit MQ.
   2. Conexão: selecione a conexão do RabbitMQ que você quer usar.

      A integração de aplicativos só mostra as conexões do RabbitMQ que estão ativas e têm uma assinatura de evento ativada.

   3. Selecione Queue ou Tópico como o JMS Source Type.
      • Se você selecionar Queue, forneça o nome da fila do Rabbit MQ na coluna JMS Source Name.
      • Se você selecionar Topic, forneça o nome do tópico do Rabbit MQ na coluna "Nome da origem do JMS".
   4. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para o acionador do Rabbit MQ.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configurar o acionador do RabbitMQ usando uma nova conexão

Para configurar o gatilho Rabbit MQ usando uma nova conexão do Rabbit MQ, siga estas etapas:

1. Clique no elemento Gatilho do Rabbit MQ no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar gatilho.
3. Ignore o campo Região.
4. Clique em Conexão e selecione a opção Criar conexão no menu suspenso.
5. Conclua as seguintes etapas no painel Criar conexão:
   1. Na etapa Local, escolha o local da nova conexão do RabbitMQ:
      1. Região:selecione uma região na lista suspensa.
      2. Clique em Próxima.
   2. Na etapa Detalhes da conexão, forneça detalhes sobre a nova conexão do Rabbit MQ:
      1. Versão do conector:escolha uma versão disponível do conector do Rabbit MQ na lista suspensa.
      2. Nome da conexão: insira um nome para a conexão do RabbitMQ.
      3. (Opcional) Descrição : insira uma descrição para a conexão.
      4. (Opcional) Ativar o Cloud Logging: marque esta caixa de seleção para armazenar todos os dados de registro da conexão.
      5. Conta de serviço: selecione uma conta de serviço com os papéis do IAM necessários para a conexão do Rabbit MQ.
      6. Ativar a assinatura de eventos: selecione essa opção para ativar a assinatura de eventos da conexão RabbitMQ.
      7. (Opcional) Expanda Configurações avançadas para definir as configurações do nó de conexão.

         Para mais informações sobre as configurações de nós de conexão para o Rabbit MQ, consulte a documentação Conexão do MQ do Rabbit.

      8. (Opcional) Clique em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
      9. Clique em Próxima.
   3. Na etapa Destinos, forneça os detalhes da instância do RabbitMQ:
      1. Destination Type:selecione Host address.
      2. Host:insira o nome do host ou o endereço IP da sua instância do Rabbit MQ.
      3. Clique em Próxima.
   4. Como opção, se quiser usar SSL, selecione Ativar SSL. Os detalhes da configuração do SSL serão exibidos.
      1. Selecione um tipo de loja de confiança. Pode ser Pública, Particular ou Conexão não segura.
      2. Selecione os certificados com base na sua seleção de loja de confiança.
      3. Se você estiver usando mTLS, selecione os certificados de armazenamento de chaves na seção Armazenamento de chaves.
      4. Opcionalmente, selecione a versão TLS.
      5. Insira o pacote de criptografia compatível. Insira vários pacotes de criptografia como valores separados por vírgulas. Para mais informações, consulte Pacotes de criptografia aceitos.
      .
   5. Na etapa Autenticação, forneça os detalhes de autenticação para a instância do Rabbit MQ:
      1. Selecione o tipo de autenticação desejado e insira os detalhes relevantes para acessar o URL do host do Rabbit MQ fornecido.

         Para entender como configurar esses tipos de autenticação, consulte Configurar autenticação.

      2. Clique em Próxima.
   6. Revisão: revise os detalhes de conexão do RabbitMQ fornecidos.
   7. Clique em Criar para concluir a criação de uma nova conexão do RabbitMQ.
6. Clique em Concluído e feche a página.

Pacotes de criptografia aceitos

Saída do gatilho

O gatilho do RabbitMQ leva alguns minutos para concluir a configuração da assinatura de eventos. É possível conferir o status da assinatura de evento no painel de configuração do acionador em Detalhes da assinatura de evento.

O gatilho Rabbit MQ indica o status de uma assinatura de evento usando os seguintes estados:

• restart_alt Creating: indica que o acionador está fazendo a assinatura da assinatura de eventos.
• check_circle Active: indica que o acionador foi inscrito em uma assinatura de evento.
• error Error: indica que há um problema com a assinatura de evento configurada.

Além do status da inscrição no evento, a seção Detalhes da assinatura do evento também exibe outros detalhes, como a região da conexão, o nome da conexão e o nome da assinatura do evento.

A imagem a seguir mostra um exemplo de layout do painel de configuração do acionador do Rabbit MQ:

Acionar variável de saída

Para cada evento, o gatilho Rabbit MQ gera um ConnectorEventPayload. variável de saída (no formato JSON) que pode ser usada nas tarefas downstream. A variável de saída terá o payload do evento do Rabbit MQ. Exemplo:

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

Conferir assinaturas de eventos

Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão nos Conectores de integração, faça o seguinte:

1. Acesse Integration Connectors > Conexões.

   Acessar a página "Conexões"

2. Clique na conexão em que você quer ver as assinaturas.
3. Clique na guia Assinaturas de eventos.

   Isso exibe todas as inscrições de eventos da conexão.

Editar gatilho do Rabbit MQ

É possível editar um gatilho do RabbitMQ para mudar ou atualizar a configuração de conexão e os detalhes da assinatura de eventos.

Para editar um gatilho do Rabbit MQ, siga estas etapas:

1. Clique no elemento Rabbit MQ trigger no editor de integração para abrir o painel de configuração do gatilho.
2. Clique em Configurar o gatilho do MQ do Rabbit.
3. Faça o seguinte na página Editor do acionador de evento do conector:
   1. Para manter a assinatura de eventos configurada anteriormente, clique em Reter. Caso contrário, clique em Excluir.
   2. Atualize a configuração da conexão e os detalhes de inscrição no evento conforme desejado.
   3. Clique em Concluído.

É possível conferir os detalhes atualizados da conexão e da assinatura de eventos no painel de configuração do acionador em Detalhes da assinatura de eventos.

Cotas e limites

Para informações sobre o assunto, consulte Cotas e limites.

A seguir

• Saiba mais sobre todas as tarefas e acionadores.
• Saiba como testar e publicar uma integração.
• Saiba mais sobre o tratamento de erros.
• Saiba mais sobre os registros de execução de integração.