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

Acionador Solace

Pré-visualização — Solace trigger

Esta funcionalidade está sujeita aos "Termos das Ofertas de Pré-DG" na secção Termos Gerais de Serviço dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

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

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 Solace, 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 Solace:

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

Nota: o acionador Solace suporta o protocolo JMS (Java Message Service). Outros protocolos, como MQTT e AMQP, não são suportados.

Adicione o acionador Solace

Para adicionar um acionador do Solace à 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 Solace no editor de integração.

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

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

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

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

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

1. Clique no elemento Acionador Solace 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 Solace.
   2. Ligação: selecione a ligação Solace que quer usar.

      A integração de aplicações só apresenta as ligações do Solace 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 Solace na coluna JMS Source Name.
      • Se selecionar Topic, indique o nome do tópico do Solace 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 Solace.
4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configure o acionador Solace através de uma nova ligação

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

1. Clique no elemento Acionador Solace 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 associação do Solace:
      1. Região: selecione uma localização na lista pendente.

         Para ver a lista de todas as regiões suportadas, consulte o artigo Localizações.

      2. Clicar em Seguinte.
   2. Na secção Detalhes da associação, conclua o seguinte:
      1. Conetor: selecione Solace na lista pendente de conetores disponíveis.
      2. Versão do conetor: selecione a versão do conetor na lista pendente de versões disponíveis.
      3. No campo Nome da ligação, introduza um nome para a instância de ligação.

         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 49 carateres.
         • Para os conetores que suportam a subscrição de eventos, os nomes das associações não podem começar com o prefixo "goog".
      4. Opcionalmente, introduza uma Descrição para a instância de associação.
      5. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
      6. Para usar a associação para subscrições de eventos, selecione Ativar subscrição de eventos. Se selecionar esta opção, ativa a subscrição de eventos com ações.
         Nota: a opção Enable only event subscription não é suportada para esta associação.
      7. VPN de mensagens: a VPN de mensagens do router de mensagens Solace Pub/Sub+ à qual quer estabelecer ligação. Uma ligação é específica de uma VPN de mensagens. Se tiver várias VPNs de mensagens, tem de criar uma ligação separada para cada VPN de mensagens.
      8. Nome da fila predefinida: o nome da fila predefinida pode ser substituído quando a ação é executada.
      9. Nome do tópico predefinido: o nome do tópico ao qual estabelecer ligação.
      10. (Opcional) Para usar SSL, selecione Ativar SSL e especifique os detalhes da configuração SSL.
      1. Selecione um tipo de loja fidedigna. Pode especificar Público, Privado ou Ligação não segura.
      2. Selecione os certificados com base na sua seleção de repositório de confiança. Por exemplo, se selecionar Privado, especifique um repositório de confiança personalizado.
      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.
      11. (Opcional) Configure as definições do nó de associação.
      • Número mínimo de nós: introduza o número mínimo de nós de ligação.
      • Número máximo de nós: introduza o número máximo de nós de ligação.

      Um nó é uma unidade (ou uma réplica) de uma ligação que processa transações. São necessários mais nós para processar mais transações para uma ligação e, inversamente, são necessários menos nós para processar menos transações. Para compreender como os nós afetam os preços dos conectores, consulte o artigo Preços dos nós de ligação. Se não introduzir valores, por predefinição, os nós mínimos são definidos como 2 (para uma melhor disponibilidade) e os nós máximos são definidos como 50.

      Nota: só pode personalizar os valores do nó de associação se for cliente de pagamento por utilização.
      12. Opcionalmente, clique em + Adicionar etiqueta para adicionar uma etiqueta à associação sob a forma de um par chave/valor.
      13. Clicar em Seguinte.
   3. Na secção Destinos, introduza os detalhes do anfitrião remoto (sistema de back-end) ao qual quer estabelecer ligação.
      1. Tipo de destino: selecione um Tipo de destino.
         • Para especificar o nome de anfitrião ou o endereço IP de destino, selecione Endereço do anfitrião e introduza o endereço no campo Anfitrião 1.
         • Para estabelecer uma ligação privada, selecione Anexo do ponto final e escolha o anexo necessário na lista Anexo do ponto final.
           Nota: para saber como criar uma associação de ponto final, consulte Associação de serviço do PSC e Associação de ponto final. Depois de criar a associação do ponto final, esta fica visível na lista Associação do ponto final.

         Se quiser estabelecer uma ligação pública aos seus sistemas de back-end com segurança adicional, pode considerar configurar endereços IP estáticos de saída para as suas ligações e, em seguida, configurar as regras da firewall para permitir apenas os endereços IP estáticos específicos.

         Nota: este conector suporta apenas um destino.
      2. Clicar em Seguinte.
   4. Na secção Autenticação, introduza os detalhes de autenticação.
      1. Selecione um Tipo de autenticação e introduza os detalhes relevantes.

         Os seguintes tipos de autenticação são suportados pela ligação Solace:

         • Anónimo
         • Nome de utilizador e palavra-passe

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

      2. Clicar em Seguinte.
   5. Na secção Detalhes da subscrição de eventos, configure os detalhes relacionados com o evento.
      • Introduza a configuração de mensagens não entregues. Se configurar a fila de mensagens rejeitadas, a ligação escreve os eventos não processados no tópico Pub/Sub especificado. Introduza os seguintes detalhes:
        1. ID do projeto de mensagens não entregues: o ID do projeto do Google Cloud onde configurou o tópico Pub/Sub de mensagens não entregues.
        2. Tópico de mensagens não entregues: o tópico do Pub/Sub onde quer escrever os detalhes do evento não processado.
   6. Rever: reveja os detalhes da ligação e da autenticação.
   7. Clique em Criar.

   Saída do acionador

   O acionador Solace 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 Solace 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.

   Variável de saída do acionador

   Para cada evento, o acionador do Solace gera uma variável de saída (no formato JSON) que pode usar nas tarefas subsequentes.ConnectorEventPayload A variável de saída vai ter a carga útil do seu evento Solace. 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 Solace

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

   Importante: quando edita ou modifica um acionador do Solace, pode manter a subscrição de eventos configurada anteriormente que está anexada ao acionador ou pode 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 Solace, siga estes passos:

   1. Clique no elemento Acionador Solace no editor de integração para abrir o painel de configuração do acionador.
   2. Clique em Configurar acionador Solace.
   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.