Gatilho do Solace

Visualização — gatilho do Solace

Este recurso está sujeito aos Termos das Soluções Pré-GA na seção Termos Gerais de Serviço dos Termos Específicos de Serviço. Os recursos pré-GA estão disponíveis "no estado em que se encontram" e podem ter suporte limitado. Para mais informações, consulte as descrições da fase de lançamento.

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

Importante:o Integration Connectors é um componente faturável do Google Cloud. Para informações sobre os custos e as cobranças de uso dos Integration Connectors, consulte os preços dos Integration Connectors.

Antes de começar

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

• Administrador de conectores (roles/connectors.admin)

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

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

• 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.

Observação: o gatilho do Solace oferece suporte ao protocolo JMS (Java Message Service). Outros protocolos, como MQTT e AMQP, não são aceitos.

Adicionar o gatilho do Solace

Para adicionar um gatilho do Solace à integração, siga estas etapas:

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

   Acessar o Application Integration

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

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

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

   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.
      Observação: o menu suspenso Regiões lista apenas as regiões provisionadas no projeto do Google Cloud. Para provisionar uma nova região, clique em Ativar região. Consulte Ativar nova região para obter mais informações.
   3. Selecione uma conta de serviço para a integração. É possível mudar ou atualizar os detalhes da conta de serviço de uma integração a qualquer momento no painel de informações Resumo da integração na barra de ferramentas de integração.
      Observação:a opção para selecionar uma conta de serviço só será exibida se você tiver ativado a governança de integração para a região selecionada.
   4. Clique em Criar.

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

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

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

Configurar o gatilho do Solace usando uma conexão atual

É possível configurar o gatilho do Solace usando uma conexão do Solace no Integration Connectors. Observe que o acionador do Solace é um acionador de evento de conector. Portanto, só é possível usar uma conexão do Solace com a assinatura de evento ativada para configurar o acionador.

Para informações sobre como configurar um gatilho do Solace usando uma nova conexão do Solace, consulte Configurar o gatilho do Solace usando uma nova conexão

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

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

      O Application Integration mostra apenas as conexões do Solace que estão ativas e têm uma assinatura de evento ativada.

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

Configurar o gatilho do Solace usando uma nova conexão

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

1. Clique no elemento Gatilho do Solace 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 etapas a seguir no painel Criar conexão :
   1. Na etapa Local, escolha o local da nova conexão do Solace:
      1. Região: selecione um local na lista suspensa.

         Para conferir a lista de todas as regiões com suporte, consulte Locais.

      2. Clique em Próxima.
   2. Na seção Detalhes da conexão, faça o seguinte:
      1. Conector: selecione Solace na lista suspensa de conectores disponíveis.
      2. Versão do conector: selecione a versão do conector na lista suspensa de versões disponíveis.
      3. No campo Nome da conexão, insira um nome para a instância de conexão

         Os nomes de conexão precisam atender aos seguintes critérios:

         • Os nomes de conexões podem usar letras, números ou hifens.
         • As letras precisam ser minúsculas.
         • Os nomes das conexões precisam começar com uma letra e terminar com uma letra ou um número.
         • Os nomes das conexões não podem exceder 49 caracteres.
         • Para conectores que oferecem suporte à assinatura de eventos, os nomes de conexão não podem começar com o prefixo "goog".
      4. Como opção, insira uma Descrição para a instância de conexão.
      5. Conta de serviço: selecione uma conta de serviço que tenha os papéis necessários.
      6. Para usar a conexão para assinaturas de eventos, selecione Ativar assinatura de eventos. Ao selecionar essa opção, a assinatura de eventos é ativada com ações.
         Observação: A opção Enable only event subscription não é compatível com essa conexão.
      7. VPN de mensagens: a VPN de mensagens do roteador de mensagens do Solace Pub/Sub+ a que você quer se conectar. Uma conexão é específica para uma VPN de mensagens. Se você tiver muitas VPNs de mensagens, crie uma conexão separada para cada VPN de mensagens.
      8. Nome da fila padrão: o nome da fila padrão. Pode ser substituído durante a execução da ação.
      9. Nome do tópico padrão: o nome do tópico a que se conectar.
      10. (Opcional) Para usar SSL, selecione Ativar SSL e especifique os detalhes de configuração do SSL.
      1. Selecione um tipo de repositório de confiança. É possível especificar Pública, Particular ou Conexão não segura.
      2. Selecione os certificados com base na seleção do repositório de confiança. Por exemplo, se você selecionar Particular, especifique um repositório de confiança personalizado.
      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 ícones como valores separados por vírgulas. Para mais informações, consulte Pacotes de criptografia compatíveis.
      Observação:
      • Todos os certificados precisam estar no formato X.509 e precisam estar no formato PEM (Privacy Enhanced Mail).
      • Não é possível selecionar um certificado diretamente ao configurar o SSL. É preciso armazenar todos os seus certificados e chaves privadas como um Secret do Secret Manager e, em seguida, selecionar o secret exigido durante a configuração do SSL.
      11. (Opcional) Defina as Configurações do nó de conexão.
      • Número mínimo de nós: digite o número mínimo de nós de conexão.
      • Número máximo de nós: digite o número máximo de nós de conexão.

      Um nó é uma unidade (ou réplica) de uma conexão que processa transações. Mais nós são necessários para processar mais transações para uma conexão e, por outro lado, menos nós são necessários para processar menos transações. Para entender como os nós afetam os preços do conector, consulte Preços dos nós de conexão. Se você não inserir nenhum valor, por padrão os nós mínimos serão definidos como 2 (para melhor disponibilidade) e os nós máximos serão definidos como 50.

      Observação:você só poderá personalizar os valores do nó de conexão se for um cliente de pagamento por uso.
      12. Outra opção é clicar em + Adicionar marcador para adicionar um marcador à conexão na forma de um par de chave-valor.
      13. Clique em Próxima.
   3. Na seção Destinos, insira os detalhes do host remoto (sistema de back-end) ao qual você quer se conectar.
      1. Tipo de destino: selecione um Tipo de destino.
         • Para especificar o nome do host ou o endereço IP de destino, selecione Endereço do host e insira o endereço no campo Host 1.
         • Para estabelecer uma conexão particular, selecione Endereço do host e adicione o anexo de endpoint criado para o SAP Gateway usando o protocolo HTTPS.
         Observação: Para entender como criar um anexo de endpoint, consulte Anexo de serviço PSC e anexo de endpoint. Depois de ter criado o anexo de endpoint, ele vai aparecer na lista Anexo do endpoint.

         Para estabelecer uma conexão pública com os sistemas de back-end com mais segurança, você pode considerar configurar endereços IP de saída estáticos para suas conexões, e então configurar suas regras de firewall para autorizar apenas os endereços IP estáticos específicos.

         Observação: esse conector oferece suporte a apenas um destino.
      2. Clique em Próxima.
   4. Na seção Autenticação, insira os detalhes da autenticação.
      1. Selecione um Tipo de autenticação e insira os detalhes relevantes.

         A conexão do Solace oferece suporte aos seguintes tipos de autenticação:

         • Anônimo
         • Nome de usuário e senha

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

      2. Clique em Próxima.
   5. Na seção Detalhes da assinatura de eventos, configure os detalhes relacionados ao evento.
      • Insira a configuração de mensagens não entregues. Se você configurar mensagens não entregues, a conexão vai gravar os eventos não processados no tópico do Pub/Sub especificado. Insira os seguintes detalhes:
        1. ID do projeto de mensagens não entregues: o ID do projeto na nuvem do Google Cloud em que você configurou o tópico do Pub/Sub de mensagens não entregues.
        2. Tópico de mensagens inativas: o tópico do Pub/Sub em que você quer gravar os detalhes do evento não processado.
   6. Revisão: revise os detalhes de conexão e autenticação.
   7. Clique em Criar.

   Saída do gatilho

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

   O gatilho do Solace indica o status de uma assinatura de evento usando os seguintes estados:

   • Creating: indica que o gatilho está se inscrevendo na assinatura de eventos.
   • Active: indica que o gatilho foi inscrito em uma assinatura de evento.
   • Error: indica que há um problema com a assinatura de evento configurada.

   Além do status da assinatura de eventos, a seção Detalhes da assinatura de eventos também mostra outros detalhes, como região de conexão, nome da conexão e nome da assinatura de eventos.

   Variável de saída do gatilho

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

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

   Conferir assinaturas de eventos

   Para conferir e gerenciar todas as assinaturas de eventos associadas a uma conexão no Integration Connectors, faça o seguinte:

   1. Acesse a página Integration Connectors > Conexões.

      Acessar a página Conexões

   2. Clique na conexão para a qual você quer conferir as assinaturas.
   3. Clique na guia Assinaturas de eventos.

      Isso mostra todas as assinaturas de eventos da conexão.

   Editar o gatilho do Solace

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

   Importante:ao editar ou modificar um gatilho do Solace, é possível manter a assinatura de evento configurada anteriormente anexada ao gatilho ou excluí-la. A exclusão de uma assinatura de evento afeta todas as integrações publicadas que usam essa assinatura de evento.

   Para editar um gatilho do Solace, siga estas etapas:

   1. Clique no elemento Gatilho do Solace no editor de integração para abrir o painel de configuração do gatilho.
   2. Clique em Configurar gatilho do Solace.
   3. Faça o seguinte na página Editor de gatilho de evento de conector :
      1. Para manter a assinatura de evento configurada anteriormente, clique em Manter ou em Excluir.
         Aviso:a exclusão de uma assinatura de evento afeta todas as integrações publicadas que usam a assinatura de evento. Esta tarefa não pode ser desfeita.
      2. Atualize a configuração de conexão e os detalhes da assinatura de eventos 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 gatilho 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.