Usando Google Cloud Pub/Sub com IBM App Connect Enterprise

Google Cloud Pub/Sub é um serviço de sistema de mensagens de publicação / assinatura assíncrono que envia mensagens entre aplicativos. IBM® App Connect Enterprise fornece os nós de entrada Google Cloud PubSub e de solicitação Google Cloud PubSub, que você pode usar para interagir com aplicativos Google Cloud Pub/Sub.

As etapas a seguir mostram como se conectar a uma conta do Google Cloud Pub/Sub e configurar um nó Google Cloud PubSub Request usando a descoberta do conector. É possível seguir um procedimento semelhante para configurar um nó Google Cloud PubSub Input para monitorar Google Cloud Pub/Sub para mensagens, criando um fluxo contendo um nó Google Cloud PubSub Input e configurando-o por meio da descoberta do conector.

1. No Kit de Ferramentas do IBM App Connect Enterprise, crie um fluxo que contenha um nó de solicitação Google Cloud PubSub.
2. Selecione o nó Google Cloud PubSub Request no fluxo para mostrar as propriedades do nó no editor.
3. Na guia Básico , clique em Ativar descoberta do conector.
   Um painel é exibido no qual você especifica o nome do projeto de política e detalhes da área segura a serem usados durante a descoberta do conector.
4. Especifique os detalhes do projeto de política e da área segura a serem usados durante a descoberta de conector:
   1. No campo Projeto de Política , especifique o projeto de política usado para armazenar as políticas criadas durante a descoberta do conector.
      Como alternativa, é possível criar um novo projeto de política clicando em Novo e especificando o nome do novo projeto de política. Em seguida clique em Concluir.
   2. Especifique a área segura a ser usada durante a descoberta do conector. Por padrão, as credenciais usadas durante a descoberta do conector são armazenadas em uma área segura do diretório externo, que é uma área segura do App Connect Enterprise que pode ser usada por qualquer servidor de integração. Como alternativa, é possível armazenar as credenciais em uma área segura do servidor de integração, que é criada no diretório de trabalho do servidor de integração e pode ser usada apenas por esse servidor de integração específico.
      Para especificar a área segura a ser usada para armazenar as credenciais, conclua as etapas na seção Usando o assistente de Descoberta do Conector de um dos seguintes tópicos:

      • Configuração de um cofre de diretório externo
      • Configurando uma área segura do servidor de integração
   3. No campo Chave da área segura , insira a chave da área segura usada para acessar as credenciais armazenadas na área segura. A chave da área segura deve ter pelo menos 8 caracteres.
   4. Opcional: Por padrão, o local da área segura especificado e a chave da área segura são salvos como preferências no Toolkit para que os valores sejam pré-configurados quando você ativar a Descoberta do Conector. Se não desejar que as preferências sejam salvas, cancele a seleção de Salvar nas preferências da área segura.
5. Clique em Ativar descoberta para iniciar o assistente de Descoberta do Conector para o conector Google Cloud Pub/Sub .
   A janela Descoberta do Conector é exibida Se as conexões existentes do Google Cloud Pub/Sub (contas) estiverem disponíveis, uma lista dessas conexões será exibida. Se não houver conexões existentes, o status do conector Google Cloud Pub/Sub será mostrado como Not connected.
   • Se uma ou mais conexões Google Cloud Pub/Sub (contas) estiverem disponíveis, conclua as etapas a seguir:
     1. Selecione a conexão (conta) que você deseja usar clicando nela.
     2. Clique no tipo de objeto necessário e selecione a ação que deseja executar no objeto. Por exemplo, clique em Assinaturas e, em seguida, Recuperar assinaturas.
   • Se não houver conexões existentes (contas), conclua as etapas a seguir:
     1. Clique no tipo de objeto necessário e selecione a ação que deseja executar nesse objeto. Por exemplo, para recuperar assinaturas do Google Cloud Pub/Sub, clique em Assinaturas e, em seguida, em Recuperar assinaturas.
     2. Clique em Conectar para criar a nova conexão Uma janela é exibida na qual você insere os detalhes de sua conta
     3. Insira seus detalhes de conexão:
        • Insira o valor de E-mail do cliente , que é possível localizar no arquivo JSON de chave privada que você faz download ao criar um projeto no Google Cloud Console.
        • Insira a Chave privada para sua conta, que você faz download como um arquivo JSON ao criar um projeto no Google Cloud Console.
        • Insira o ID do projeto para sua conta, que pode ser localizado no console do Google Cloud .

        Clique em Conectar.

        Para obter mais informações sobre como se conectar ao Google Cloud Pub/Sub, consulte “Como usar o IBM App Connect com o Google Cloud Pub/Sub ” na documentação de Entrega Contínua (CD) do IBM App Connect in containers.

6. Configure as propriedades necessárias do conector no assistente
   É possível incluir condições para a recuperação dos dados, clicando em Incluir condição e, em seguida, selecionando a propriedade que deseja filtrar. Por exemplo, é possível filtrar por assinaturas para um tópico específico clicando em Incluir condição, em seguida, em Tópicoe, em seguida, especificando o nome do tópico do qual a assinatura recebe mensagens. Também é possível configurar as propriedades que especificam o número máximo de registros a serem recuperados e a ação a ser executada se esse limite for excedido
7. Quando tiver concluído a especificação das propriedades no assistente de Descoberta do Conector, clique em Salvar.
   A credencial usada para se conectar ao Google Cloud Pub/Sub é armazenada na área segura e os outros detalhes da conexão são salvos na política Google Cloud Pub/Sub. Os valores das propriedades definidas no assistente são retornados ao nó de solicitação Google Cloud PubSub no IBM App Connect Enterprise Toolkit.
8. Quando tiver concluído a descoberta e salvo os valores da propriedade, saia do assistente de Descoberta do Conector clicando no X no canto superior direito da janela ou pressionando Alt+F4.
9. Voltar à edição do nó “ Google Cloud ” ( PubSub Request) no IBM App Connect Enterprise Toolkit.
   As propriedades do conector que foram configuradas no assistente de Descoberta do Conector (na etapa 6) agora estão visíveis no nó Google Cloud PubSub . A guia Básico mostra os valores das propriedades Ação e Objeto que você configura no assistente. Por exemplo, se você selecionou Assinaturas > Recuperar assinaturas no assistente, as seguintes propriedades estarão visíveis na guia Básico do nó:

   • Ação - RETRIEVEALL
   • Objeto - Subscription

   Os valores das propriedades Ação e Objeto são exibidos no formato somente leitura.. Se você desejar mudar esses valores, poderá fazer isso clicando em Ativar descoberta do conector novamente e configurando novos valores no assistente de Descoberta do conector. É possível modificar outras propriedades clicando em Editar ao lado da propriedade

   A propriedade Nome base do esquema especifica o nome base dos arquivos de esquema que descrevem o formato das mensagens de solicitação e resposta enviadas e recebidas do conector Google Cloud Pub/Sub . O nome base do esquema é configurado automaticamente na primeira vez em que você executa a descoberta para o nó e é baseado no nome do fluxo e no nome do nó atuais Se você configurar essa propriedade manualmente antes de executar a descoberta pela primeira vez, o valor configurado será usado. Se você renomear os esquemas após a descoberta, deverá editar essa propriedade para que ela corresponda ao nome base do esquema usado pelos esquemas renomeados no projeto. Se você alterar essa propriedade após a descoberta, deverá renomear os nomes do esquema para corresponder ou executar a descoberta novamente.

   Dependendo da ação selecionada durante a descoberta, o assistente de Descoberta do Conector gera um esquema de solicitação e um esquema de resposta ou apenas um esquema de resposta. Um esquema de solicitação será gerado apenas se a ação e o objeto selecionados requererem uma mensagem de solicitação O esquema de solicitação gerado é usado para validação da mensagem de solicitação.. Se a ação tiver sido RETRIEVE ou DELETE, apenas o esquema de resposta será retornado pelo conector

   Os arquivos de esquema gerados são incluídos no projeto e podem ser usados por um nó Mapeamento para transformar dados de entrada ou saída. O nome do arquivo completo do esquema é derivado do nome base do esquema (como gen/MyMessageFlow.Google_Cloud_PubSub_Request), sufixado com response.schema.json ou request.schema.json. É possível abrir o esquema clicando em Abrir esquema de solicitação ou em Abrir esquema de resposta.

10. Verifique se as configurações de propriedades no nó Google Cloud PubSub Request estão corretas e salve o fluxo de mensagens.
11. Na guia Conexão do nó Google Cloud PubSub Request , a propriedade Política mostra o nome da política que contém os detalhes da identidade de segurança a ser usada para a conexão A política tem um tipo Google Cloud Pub/Sub.
    Para obter mais informações, consulte Google Cloud Pub/Sub.
12. Opcional: Configure a propriedade Tempo limite na guia Conexão para especificar o tempo (em segundos) que o nó aguarda para que o Google Cloud Pub/Sub processe a operação. .
13. A guia Filtro do nó Google Cloud PubSub Request contém propriedades que controlam a maneira na qual o fluxo de mensagens seleciona dados. Os valores iniciais dessas propriedades são obtidos dos valores da propriedade que foram configurados para o conector Google Cloud Pub/Sub no assistente de Descoberta do Conector, incluindo as propriedades de opções de filtro e quaisquer condições especificadas (conforme descrito na etapa 6). Se você retornar subsequentemente ao assistente de Descoberta do Conector e alterar os valores de quaisquer propriedades (incluindo novas condições, por exemplo), essas atualizações serão refletidas nas propriedades configuradas no nó.

    As propriedades de Opções de Filtro controlam quais objetos devem ser operados quando o nó Google Cloud PubSub é executado As propriedades Limite de Filtro controlam o número máximo de itens a serem recuperados e a ação a ser executada se o limite for excedido.

    É possível modificar os valores clicando em Editar próximo ao valor que deseja modificar na seção Opções de Filtro e alterando os valores da propriedade que foram configurados na seção Limite de Filtro .

    Os valores da propriedade podem ser valores de texto ou expressões ESQL ou XPATH que são resolvidas a partir do conteúdo da mensagem transmitida para o nó Google Cloud PubSub Request à medida que ele é executado.

14. Na guia Solicitação , configure a propriedade Local de dados para especificar o local na árvore de mensagens recebidas que contém os dados do objeto a serem criados no Google Cloud Pub/Sub. Esses dados formam a solicitação que é enviada do nó Google Cloud PubSub Request para o sistema Google Cloud Pub/Sub .
15. Na guia Resultado , configure a propriedade Local de dados de saída: para especificar o local na árvore de mensagem de saída que conterá os dados do registro criado em Google Cloud Pub/Sub.
16. Por padrão, as mensagens de solicitação são validadas com relação ao esquema de solicitação gerado durante a descoberta do conector. É possível desativar a validação de solicitação ou mudar as configurações de validação usando as propriedades Validação do nó Google Cloud PubSub ..
17. Salve o fluxo de mensagem