Crie CICD para a sua integração

Este tutorial descreve como automatizar a promoção de uma integração entre diferentes ambientes em diferentes projetos do Google Cloud através de variáveis de configuração (pré-visualização).

Vista geral

Neste tutorial, vai automatizar as implementações da integração de aplicações através da variável de configuração para uma integração de exemplo. Este fluxo de integração de exemplo chama uma API e publica a resposta da API num tópico do Pub/Sub. Este exemplo destina-se a ilustrar a utilização das tarefas Chamar ponto final REST e Conetores. Pode armazenar a integração de exemplo em repositórios do GitHub que correspondam aos diferentes ambientes e Google Cloud projetos.

Crie um tópico do Pub/Sub

  1. Na Google Cloud consola, aceda à página Tópicos do Pub/Sub.

    Aceda a Tópicos

  2. Clique em Criar tópico.

  3. No campo ID do tópico, introduza um ID para o seu tópico. Para mais informações sobre a atribuição de nomes a tópicos, consulte as diretrizes para atribuir um nome a um tópico, uma subscrição, um esquema ou uma captura instantânea.

  4. Mantenha a opção Adicionar uma subscrição predefinida.

  5. Não selecione as outras opções.

  6. Clique em Criar tópico.

Configure um conetor do Pub/Sub

  1. Na Google Cloud consola, aceda à página Integration Connectors > Connections e, de seguida, selecione ou crie um Google Cloud projeto.

    Aceda à página Ligações

  2. Clique em + Criar novo para abrir a página Criar associação.
  3. Na secção Localização, escolha a localização para a ligação.
    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. Clique em SEGUINTE.
  4. Na secção Detalhes da associação, conclua o seguinte:
    1. Conetor: selecione Pub/Sub 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 associação, introduza pub-sub-connector.
    4. Conta de serviço: selecione uma conta de serviço que tenha as funções necessárias.
    5. ID do projeto: Google Cloud ID do projeto onde reside a instância do Pub/Sub.
    6. ID do tópico: introduza o nome do seu tópico do Pub/Sub.
    7. Clicar em Seguinte.
  5. Na secção Autenticação, clique em SEGUINTE.
  6. Rever: reveja os detalhes da ligação e da autenticação.
  7. Clique em Criar.

Crie uma nova integração

Depois de configurar a integração de aplicações, pode criar uma nova integração:

  1. Na Google Cloud Console, aceda à página Integração de aplicações.

    Aceda à solução Application Integration

  2. Clique em Integrações no menu de navegação do lado esquerdo para abrir a página Integrações.
  3. Clique em Criar integração e indique os seguintes detalhes na página Criar integração:
    1. Nome da integração: introduza um nome para a integração. Por exemplo, build-cicd.
    2. Descrição: opcionalmente, introduza uma descrição para a sua integração. Por exemplo, Demo integration created for CICD tutorial.
    3. Região: selecione a região us-central1 na lista de regiões aprovisionadas. Se a região que quer selecionar não estiver aprovisionada, consulte o artigo Aprovisione uma nova região. Para ver uma lista das regiões suportadas, consulte o artigo Localizações de integração de aplicações.
    4. Conta de serviço: este campo é apresentado se tiver ativado a governação para a sua região. Selecione a conta de serviço para a sua integração. Para saber como ativar a administração para a sua região, consulte o artigo Editar região.
    5. Clique em Criar. Esta ação abre a página do editor de integração, na qual pode adicionar as tarefas e os acionadores para criar a sua integração.

Crie um fluxo de integração

Adicione um acionador de API e um ponto final REST de chamadas

Para adicionar um acionador de API, 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 a integração do build-cicd.

    Esta ação abre a integração no editor de integração.

  4. Na barra de navegação do editor de integração, clique em Acionadores > Acionador de API para adicionar o acionador.
  5. Na barra de navegação do editor de integração, clique em Tasks > Call REST Endpoint para adicionar a tarefa.
  6. Adicione uma ligação de limite do elemento Acionador de API ao elemento Chamar ponto final REST passando o cursor do rato sobre um ponto de controlo no elemento Acionador de API e, de seguida, clicando e arrastando uma linha para um ponto de controlo no elemento de tarefa Chamar ponto final REST.

Crie variáveis de configuração

Para criar variáveis de configuração, siga estes passos:
  1. Na barra de navegação do editor de integração, clique em (Ativar/desativar painel) para apresentar o painel Variáveis.
  2. Clique em +Criar.
  3. Faça o seguinte no painel Criar variável:
    1. Em Nome, introduza url.

      A integração de aplicações adiciona o prefixo `CONFIG_ às variáveis de configuração. Se quiser adicionar a variável de configuração à sua integração através de APIs, use o seguinte formato para as variáveis de configuração: `CONFIG_CONFIG_VARIABLE_NAME`. Para obter informações sobre como transferir e carregar integrações, consulte o artigo Carregue e transfira integrações.

    2. Em Tipo de variável, selecione Variável de configuração.
    3. Para Tipo de dados, selecione String.
    4. Clique em Criar.

      A variável de configuração é apresentada no painel Variáveis.

  4. Repita os passos 2 e 3 para adicionar a seguinte variável de configuração:
    • Nome: connection_name
    • Tipo de variável: Config Variable
    • Tipo de dados: String

Adicione e configure o ponto final REST de chamadas

Para criar uma variável de configuração, siga estes passos:
  1. No editor de integração, clique na tarefa Chamar ponto final REST para abrir o painel de configuração da tarefa. Em seguida, faça o seguinte:
    1. Expanda a secção Entrada de tarefas.
    2. No URL base do ponto final, clique em Variável e adicione $`CONFIG_url`$.

Adicione e configure uma tarefa de conetores

  1. Na barra de navegação do editor de integração, clique em Tarefa > Conectores.
  2. Clique em Configurar conetores.
  3. Na lista Região, selecione a região onde criou o conetor do Pub/Sub.
  4. No campo Ligação, selecione o conetor do Pub/Sub que criou no passo anterior.
  5. Na secção Tipo, selecione Ações.
  6. Na secção Definir entidades/ações, para Ações, selecione publishMessage.
  7. No Valor predefinido, adicione o valor predefinido da variável de configuração.
  8. Clique em Criar.
  9. No painel de configuração da tarefa Conetores, expanda a secção Detalhes da ligação para atualizar o seguinte campo:
    1. No campo Nome da ligação, clique em Variável e selecione $`CONFIG_connection_name`$.

Adicione uma tarefa de mapeamento de dados

  1. Na barra de navegação do editor de integração, clique em Tarefa > Mapeamento de dados.
  2. Adicione uma ligação de limite do elemento Chamar ponto final REST ao elemento Mapeamento de dados passando o cursor do rato sobre um ponto de controlo no elemento Chamar ponto final REST e, de seguida, clicando e arrastando uma linha para um ponto de controlo no elemento de tarefa Mapeamento de dados.
  3. Adicione outra associação de aresta do elemento Mapeamento de dados ao elemento Conetores passando o cursor do rato sobre um ponto de controlo no elemento Mapeamento de dados e, de seguida, clicando e arrastando uma linha para um ponto de controlo no elemento de tarefa Conetores.
  4. No painel de configuração da tarefa Mapeamento de dados, clique em Abrir editor de mapeamento de dados.
  5. Mapeie a variável de saída da tarefa Chamar ponto final REST para a variável de entrada da tarefa Connectors.

Publique a integração

Para publicar a integração, siga estes passos:
  1. Para publicar a integração, clique em Publicar na barra de ferramentas do editor de integração.

    É apresentada a caixa de diálogo Publicar integração.

  2. Na caixa de diálogo Publicar integração, introduza o valor das seguintes variáveis de configuração:
    1. url: introduza o nome do URL do ponto final.
    2. connection_name: introduza o nome do conetor do Pub/Sub que criou no passo anterior.
  3. Clique em Publicar.
  4. Após publicar com êxito a integração, pode ver e inspecionar os registos de execução da integração publicada. Para ver os registos, clique em Registos na barra de ferramentas do editor de integração.

Promova a integração em todos os ambientes

Para promover a sua integração em vários ambientes, pode usar a integrationcli ferramenta, que é uma ferramenta de código aberto que lhe permite interagir com as APIs Application Integration e as APIs Integration Connectors. Esta ferramenta permite-lhe gerir entidades de integração, como integrações, configurações de autorização, etc. Para ver informações sobre como gerar a estrutura para a integração e aplicar as alterações geradas pela estrutura, consulte a Introdução ao integrationcli no blogue da comunidade.

Também pode promover alterações em vários ambientes configurando pipelines de DevOps, por exemplo, usando o Jenkins, o GitLab, o Cloud Build, etc. Para mais informações, consulte o artigo Integração com o Cloud Build.

Se não quiser usar o integrationcli, pode transferir e carregar manualmente a integração para um novo projeto. Tem de criar os conetores no novo projeto manualmente, uma vez que atualmente não são transferíveis. Quando publica a integração no novo ambiente, o Application Integration permite-lhe introduzir valores para as variáveis de configuração.

O que se segue?