Descubra como configurar um trigger downstream para executar testes automatizados após mudanças, garantindo a qualidade antes da implantação.
Como configurar uma Trigger Downstream?
Antes de começarmos, considere que esta configuração é para implementar o CI downstream do GitLab, acionado por uma Merge Request no branch de Desenvolvimento (Develop) no ambiente de STG. Agora, siga o passo a passo!
1. Edite o arquivo .gitlab-ci.yml
No diretório raiz do repositório da sua equipe, edite ou crie um arquivo chamado .gitlab-ci.yml. Este arquivo define as etapas e os trabalhos para o pipeline CI/CD.
2. Adicione novas etapas e trabalhos
Abaixo está um exemplo básico de como adicionar uma nova etapa ao arquivo .gitlab-ci.yml:
Neste exemplo:
- Stages – Definem a sequência de etapas (test, publish, vlad, integration_tests, rebuild-staging).
- Job (integration_tests) – Esse trabalho é colocado na etapa integration_tests.
- Rules – O trabalho será acionado se a tag do commit corresponder ao regex ^./stg/.$ ou se o branch do commit corresponder ao regex ^stg-.*$.
- Trigger – Especifica o projeto downstream a ser acionado (projectName/repository).
3. Personalize o trabalho e o caminho do projeto
Adicione um trabalho com o mesmo nome da etapa (integration_tests) e modifique a seção de gatilho para refletir o caminho real do seu projeto.
4. Commit e Push
Faça o commit do arquivo .gitlab-ci.yml e envie para o repositório.
5. Crie uma Merge Request
Crie uma nova Merge Request (MR) no projeto. Isso deve acionar o pipeline e incluir a nova etapa de integration_tests.
6. Monitore o Pipeline
Vá até a seção CI/CD do seu projeto no GitLab para monitorar o progresso do pipeline. O pipeline será executado automaticamente conforme a configuração no arquivo .gitlab-ci.yml.
7. Revise os Resultados
Depois que o pipeline for concluído, revise os resultados dos testes na interface do GitLab. Se algum teste falhar, você poderá ver logs e relatórios detalhados para ajudar a diagnosticar e corrigir os problemas.
Como integrar a automação de testes na pipeline do sistema com um trigger downstream no GitLab: dicas adicionais
- Garanta que o projeto downstream especificado na seção de gatilho tenha permissões apropriadas e seja acessível a partir do projeto atual.
- Teste suas alterações no .gitlab-ci.yml em um branch de feature antes de mesclá-las no branch principal.
- Use o editor de pipeline CI/CD do GitLab para validar a sintaxe e a configuração do seu .gitlab-ci.yml.
Como integrar a automação de testes na pipeline do sistema com um trigger downstream no GitLab: considerações finais
Seguindo todos os passos descritos neste artigo, teremos nossos testes automatizados sendo executados no pipeline downstream do GitLab. Assim, os testes serão executados sempre após qualquer nova Merge Request, garantindo agilidade e testes constantes, assegurando a qualidade das novas versões da aplicação.
Se quiser saber mais sobre como configurar um YAML para um pipeline de testes, confira este artigo.
Espero que tenha gostado deste guia e fique à vontade para deixar qualquer dúvida nos comentários.
