|
|
|
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](https://docs.gitlab.com/runner/install/)
|
|
|
|
2. **Configurar o Runner**.<br>
|
|
|
|
Isso pode ser feito executando o comando `sudo gitlab-runner register` na máquina,
|
|
|
|
e preenchendo as informações pedidas pela interface.<br>
|
|
|
|
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](introdução-ao-gitlab-ci), e ficarão a critério do desenvolvedor, conforme a necessidade do mesmo.
|
|
|
|
|
|
|
|
:warning: **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!**.<br>
|
|
|
|
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**
|
|
|
|
|
|
|
|
:track_previous: **Anterior:** [Habilitar CI/CD para o projeto no GitLab](habilitar-ci-cd-para-o-projeto-no-gitLab) <br>
|
|
|
|
:track_next: **Próximo:** [Criar uma imagem base](criar-uma-imagem-base)
|
|
|
|
|
|
|
|
|
|
|
|
|
