Consulte os conectores compatíveis com o Application Integration.

Gatilho de tranquilidade

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

Antes de começar

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

  • Administrador do conector (roles/connectors.admin)

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

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

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

Para adicionar um gatilho do Sol à 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 Integrações.

    A página Lista de integrações aparece listando 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 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 ver a lista de gatilhos disponíveis.
  5. Clique e coloque o elemento Gatilho do Sol no editor de integração.

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

Configurar o gatilho do Solace usando uma conexão atual

Você pode configurar o gatilho do Sol usando uma conexão existente do Solace no Integration Connectors. O acionador do Console é um acionador de evento do conector. Portanto, você só pode usar uma conexão do Solace com a inscrição de eventos ativada para configurar o acionador.

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

Para configurar um acionador do Console usando uma conexão atual 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 do acionador de evento do conector:
    1. Região:selecione a região da sua conexão do Solace.
    2. Conexão:selecione a conexão do Solace que você quer usar.

      A Application Integration exibe apenas as conexões do Solace 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 Solace na coluna JMS Source Name.
      • Se você selecionar Topic, forneça o nome do tópico do Solace 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 gatilho do Solace.
  4. Clique em Concluído para concluir a configuração do acionador e fechar a página.

Configurar o gatilho do Solace usando uma nova conexão

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

  1. Clique no elemento Gatilho do Sol no editor de integração para abrir o painel de configuração do acionador.
  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 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 63 caracteres.
      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 inscrições de eventos, selecione Ativar inscrição de eventos. Ao selecionar esta opção, a assinatura de eventos é ativada com ações.
      7. VPN de mensagem: a VPN de mensagem 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 uma VPN de mensagens, crie uma para cada VPN de mensagem.
      8. Nome da fila padrão: o nome da fila padrão. Pode ser substituído durante a execução da ação.
      9. Default Topic Name: o nome do tópico a ser conectado.
      10. Opcionalmente, 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 qualquer 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.

      11. Também é possível clicar em + Adicionar rótulo para adicionar um rótulo à conexão na forma de um par de chave-valor.
      12. 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.
        • Selecione Endereço do host na lista para especificar o nome do host ou o endereço IP do destino.
        • Para estabelecer uma conexão particular com seus sistemas de back-end, Selecione Anexo de endpoint na lista e depois selecione o anexo de endpoint necessário. na lista Endpoint Attachment.

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

      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.

        Os seguintes tipos de autenticação são compatíveis com a conexão do Solace:

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

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

      2. Clique em Next.
    5. Revisão: revise os detalhes de conexão e autenticação.
    6. Clique em Criar.

    Saída do gatilho

    O acionador do Sol leva alguns minutos para concluir a configuração da assinatura do evento. É possível consultar o status da assinatura do evento no painel de configuração do acionador, em Detalhes da assinatura do evento.

    O acionador do Sol indica o status de uma assinatura de evento usando os seguintes estados:

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

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

    Variável de saída do acionador

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

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

    Ver inscrições em eventos

    Para visualizar 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 que tem as assinaturas que você quer conferir.
    3. Clique na guia Inscrições de eventos.

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

    Editar acionador do Solace

    É possível editar um gatilho do Sol para alterar ou atualizar a configuração da conexão e os detalhes da assinatura do evento.

    Para editar um acionador do Solace, siga estas etapas:

    1. Clique no elemento Gatilho do Sol no editor de integração para abrir o painel de configuração do acionador.
    2. Clique em Configurar gatilho do Solace.
    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 da assinatura de eventos conforme necessário.
      3. Clique em Concluído.

      4. Confira os detalhes atualizados da conexão e da assinatura do evento no painel de configuração do acionador em Detalhes da assinatura do evento.

    Cotas e limites

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

    A seguir