Pular para o conteúdo principal

Integração Git CI

O Git CI mantém um repositório do Smart Engineering sincronizado com um repositório do Bitbucket Cloud. Quando um evento Git configurado corresponde aos gatilhos e filtros selecionados, o AI Cockpit importa e indexa o commit exato que gerou o evento.

Use o Git CI quando o repositório de código-fonte muda com frequência e a equipe quer disponibilizar o código no Smart Engineering sem enviar um novo pacote .zip a cada alteração.

Antes de começar​

  • Abra o repositório do Smart Engineering que receberá as atualizações.
  • Tenha o workspace e o slug do repositório no Bitbucket Cloud, por exemplo, workspace/repository.
  • Tenha a URL de clone do repositório e um token de acesso ou token de API do Bitbucket com acesso de leitura.
  • Confirme que você pode criar um webhook no repositório do Bitbucket.

Atualmente, o Git CI oferece suporte ao Bitbucket Cloud. A integração importa e indexa o código-fonte; ela não cria tasks de documentação nem regenera automaticamente a documentação ou os projetos de Modernização de Código existentes.

Configurar a integração​

  1. Abra a página de configuração do repositório em /repositories/:repositoryId/config.

  2. Selecione Configurar Git CI.

  3. Informe a identidade do repositório Bitbucket (workspace/repository), sua URL de clone e uma credencial com acesso de leitura.

  4. Selecione um ou mais gatilhos:

    GatilhoEvento Bitbucket correspondente
    Push para branchUm push para uma branch correspondente.
    Pull request mescladoUm pull request mesclado em uma branch correspondente.
    Tag criadaUm push que cria uma tag correspondente.

  5. Defina filtros de branch e tag quando necessário. Os filtros aceitam padrões glob, como main, release/* e v*.

  6. Mantenha a integração habilitada e, opcionalmente, informe um e-mail para receber notificações de processamento.

  7. Selecione Configurar integração.

  8. Copie a URL e o segredo do webhook exibidos. O segredo é mostrado apenas uma vez.

  9. No Bitbucket, crie um webhook com essa URL e esse segredo e habilite os eventos correspondentes aos gatilhos selecionados.

Guarde o segredo do webhook de forma segura. Não o versione no código-fonte nem o compartilhe em tickets ou mensagens.

O que acontece após um evento​

Para cada evento correspondente, o AI Cockpit coloca a revisão na fila, importa o commit SHA exato e executa a indexação. O status da integração mostra o último commit processado com sucesso. O destinatário configurado recebe uma notificação quando o processamento é concluído ou falha.

Eventos que não correspondem ao gatilho, filtro de branch ou filtro de tag selecionados são ignorados. Notificações repetidas para o mesmo commit não criam importações duplicadas, e atualizações do mesmo repositório são processadas em ordem.

Gerenciar a integração​

Use Gerenciar integração na página de configuração para alterar gatilhos, filtros, destinatário de notificação ou o estado de processamento. Para trocar a credencial, informe um novo token e salve as alterações.

A identidade e a URL de clone do repositório ficam fixas após a configuração. Para usar outro repositório Bitbucket, remova a integração e crie-a novamente. A remoção da integração impede o processamento das entregas pendentes.

Se o processamento falhar três vezes seguidas, o AI Cockpit desabilita a integração e cancela as entregas pendentes. Corrija a causa, como uma credencial expirada ou uma revisão inacessível, e habilite a integração novamente.

Usar Git CI com a Modernização de Código​

Espere a revisão importada terminar o processamento antes de iniciar um novo projeto de Modernização de Código. Ao criar o projeto, escolha a versão que contém a revisão que deseja usar como referência. Uma atualização pelo Git CI não altera a versão de referência de um projeto de modernização existente.

Veja também​