Essa é uma revisão anterior do documento!
Parte 2: Deploy em Homologação
1. Adicionando o Componente de Deploy em Homologação
O deploy em homologação utiliza o mesmo componente deploy-docker do deploy em produção. A diferença está nos inputs: o environment passa a ser "homolog" e o tag aponta para o runner do servidor de homologação.
Adicione um segundo bloco dentro do include:
stages: - deploy include: # Deploy em Produção - component: $CI_SERVER_FQDN/GER-TI/tce.kubernetes/tce.templates/deploy-docker@2.0.0 inputs: environment: "production" compose-file: "docker-compose.yml" tag: dockers-prod-runner # Deploy em Homologação - component: $CI_SERVER_FQDN/GER-TI/tce.kubernetes/tce.templates/deploy-docker@2.0.0 inputs: environment: "homolog" compose-file: "docker-compose.yml" tag: docker-stag-runner
O environment: "homolog" instrui o componente a realizar o deploy no ambiente de homologação quando houver commit na branch develop.
Dica: Os jobs que tiveremenvironment: homologsó executarão nas branchesdevelopehomolog. Os jobs que tiveremenvironment: productionsó executarão nas branchesmainemaster.
O tag: dockers-stag-runner indica o servidor de homologação que irá executar o job. Para ver quais tags estão disponíveis, acesse https://gitsource.tce.go.gov.br/groups/GER-TI/-/runners. Para saber qual tag utilizar, veja gitlab_runners.
Os dois blocos deincludeconvivem no mesmo arquivo: cada um responde à sua branch e ao seu ambiente de forma independente.
2. Criando a Branch de Homologação
O componente dispara o deploy ao detectar um push nas branches develop ou homolog — qualquer uma das duas funciona.
Crie a branch a partir da main:
git checkout -b develop git push -u origin develop
Esse push já é suficiente para acionar o job de deploy em homologação.
3. Validar e Commitar
- Utilize a aba Visualizar no editor para garantir que a sintaxe está correta.
- Se tudo estiver certo, clique em Commit changes no final da página.
- Faça o commit na branch
developpara acionar o deploy em homologação.
O que esperar
Após o commit na develop, você deve ver:
- Um pipeline criado automaticamente.
- O estágio
deploysendo executado no ambiente de homologação. - O job finalizando com sucesso (ícone verde ✓).
Se o job falhar, acesse o log do job clicando nele para investigar o erro.