GitLab

Agora que o CI/CD foi habilitado no projeto, deve ser possível realizar configurações no projeto para rodar as pipelines.

Uma dessas configurações é os Runners do projeto.

Como dito anteriormente, as pipelines do gitlab-ci precisam de um Runner para executá-las. Um projeto pode ter vários Runners disponíveis, que podem ser configurados de maneiras diferentes:

Utilizar Runners providos pelo GitLab

Caso o projeto não precise ter algum Runner específico instalado, o GitLab provê máquinas automaticamente para que as pipelines possam ser executadas.

E o GQS já possui algumas dessas máquinas prontas para serem utilizadas!

Estas máquinas utilizam o executor docker, não possuem tags específicas, são compartilhados entre os projetos, e são bastante úteis para realizar pipelines simples, principalmente de testes.

Caso o desenvolvedor opte por utilizar estes Runners, nenhuma configuração é necessária, além de habilitá-los.

Isso pode ser feito nas configurações de CI/CD, e Settings > CI/CD > Runners, na aba Shared runners clicar em Enable shared runners for this project.

Por padrão, para projetos novos, esta funcionalidade já está habilitada!

Configurar Runners específicos

É possível também configurar um Runner em uma máquina específica. Isso é útil quando existe uma máquina externa que possa lidar com essas pipelines.

Como por exemplo, quando temos uma máquina de testes que deva rodar um servidor de uma aplicação, poderíamos instalar um Runner nesta máquina e configurar no projeto.

Para fazer isso, o desenvolvedor pode seguir os seguintes passos:

1. Instalar o gitlab-runner na máquina desejada, seguindo o passo a passo da documentação oficinal
2. Configurar o Runner.
   Isso pode ser feito executando o comando sudo gitlab-runner register na máquina, e preenchendo as informações pedidas pela interface.
   A interface pedirá uma série de informações, mas as mais importantes são:
   • url e token: URL e token do projeto do GitLab, é possível achar essas informações na página Settings > CI/CD > Runners, na aba Specific runners.
     
   • descrição, tags, e executor: Essas informações foram explicadas na página introdução ao gitlab ci, e ficarão a critério do desenvolvedor, conforme a necessidade do mesmo.

⚠ Aviso: se o desenvolvedor quiser configurar um Runner em uma das máquinas providas ao GQS pela SeTIC, ele precisará solicitar ao administrador do laboratório que faça o registro!.
O administrador precisará das seguintes informações, dentre as que foram listadas:

• token;
• executor;
• tags (opcional);

Ao final da execução, o Runner deverá estar disponível para lidar com as pipelines do projeto!

Vale ressaltar que, caso o desenvolvedor queira que este Runner específico seja o único capaz de lidar com as pipelines, ele deverá desabilitar os runners compartilhados, em Settings > CI/CD > Runners, na aba Shared runners e desabilitar a opção Enable shared runners for this project

⏮ Anterior: Habilitar CI/CD para o projeto no GitLab
⏭ Próximo: Criar uma imagem base