GitLab CI/CD — turma 1

← Todas as turmas

Agenda

Formulários

Módulos

Fundamentos de pipelines GitLab CI/CD · Básico · 3 h

Objetivos

• Criar um arquivo .gitlab-ci.yml com stages e jobs e validá-lo no pipeline editor.
• Executar um pipeline e interpretar o log e o status de cada job.
• Configurar execução condicional básica com when e allow_failure.
• Diagnosticar falhas de sintaxe e de script em pipelines.

Pré-requisitos: repositorio-git

Conteúdo

Tópico	Tier	Fonte
Estrutura do .gitlab-ci.yml: palavras-chave globais (default, include, stages, variables, workflow) e de job	Free	documentação
Stages padrão (.pre, build, test, deploy, .post); job sem stage vai para test	Free	documentação
Jobs, script, before_script, after_script, image, jobs ocultos iniciados por ponto	Free	documentação
when (on_success padrão, on_failure, always, manual, delayed, never) e allow_failure	Free	documentação
Pipeline editor e validação de configuração (CI Lint)	Free	documentação
Tipos e estados de pipeline	Free	documentação

GitLab Runner: tipos, executores, registro e operação · Intermediário · 2 h

Objetivos

• Criar e registrar um runner com token de autenticação (prefixo glrt-).
• Configurar tags, execução de jobs sem tag e runner protegido.
• Distinguir runners de instância, grupo e projeto e os executores ativos e em manutenção.
• Interpretar os status de runner (online, offline, stale, never_contacted).

Pré-requisitos: Fundamentos de pipelines GitLab CI/CD

Conteúdo

Tópico	Tier	Fonte
Runners de instância, grupo e projeto; fila de uso justo dos runners de instância	Free	documentação
Fluxo de criação de runner com token de autenticação glrt-; token de registro legado	Free	documentação
Executores Kubernetes, Docker, Docker Autoscaler e Instance; SSH, Shell, Parallels, VirtualBox e Custom em modo de manutenção	Free	documentação
Tags, Run untagged jobs, runners protegidos	Free	documentação
config.toml (/etc/gitlab-runner/ como root), concurrent e recarga automática a cada 3 segundos	Free	documentação
Status de runner: online (contato nas últimas 2 h), offline, stale (mais de 7 dias), never_contacted	Free	documentação

Pipelines avançados: pai-filho, multiprojeto, merged results e merge trains · Avançado · 2 h

Objetivos

• Configurar pipelines filhos com trigger:include e pipelines multiprojeto com trigger:project.
• Configurar trigger:strategy para refletir o status do pipeline downstream.
• Configurar pipelines de merged results e merge trains.
• Configurar a allowlist do CI/CD job token para acesso entre projetos.

Pré-requisitos: Controle de execução: rules, workflow, needs e paralelismo

Conteúdo

Tópico	Tier	Fonte
Pipelines downstream: pai-filho (mesmo projeto, ref e SHA; profundidade máxima de dois níveis de filhos) e multiprojeto	Free	documentação
trigger:strategy mirror; hierarquia de até 1000 pipelines downstream por padrão	Free	documentação
Pipelines de merge request	Free	documentação
Pipelines de merged results (commit temporário de merge)	Premium	documentação
Merge trains (até 20 pipelines em paralelo por merge train por padrão)	Premium	documentação
CI/CD job token e allowlist (por padrão a allowlist contém apenas o próprio projeto)	Free	documentação

Controle de execução: rules, workflow, needs e paralelismo · Intermediário · 2 h

Objetivos

• Configurar rules com if, changes e exists e prever a inclusão de jobs no pipeline.
• Configurar workflow:rules para pipelines de merge request e da branch padrão.
• Configurar dependências com needs para execução fora da ordem de stages.
• Configurar parallel e parallel:matrix.

Pré-requisitos: Fundamentos de pipelines GitLab CI/CD

Conteúdo

Tópico	Tier	Fonte
rules: avaliação em ordem, primeira correspondência, job fora do pipeline sem correspondência	Free	documentação
workflow:rules e CI_PIPELINE_SOURCE == merge_request_event	Free	documentação
needs (até 50 jobs por padrão), needs: [] e grafo acíclico dirigido	Free	documentação
parallel (1 a 200) e parallel:matrix (até 200 permutações)	Free	documentação
interruptible e auto-cancelamento de pipelines redundantes; retry e timeout	Free	documentação

Variáveis, artefatos, cache e relatórios de teste · Intermediário · 3 h

Objetivos

• Configurar variáveis de CI/CD protegidas, mascaradas e ocultas em projeto e grupo.
• Aplicar a ordem de precedência de variáveis para prever o valor usado por um job.
• Configurar artefatos com expiração e dependências entre jobs.
• Configurar cache com chave e política.
• Publicar relatório de testes JUnit e cobertura de código no merge request.

Pré-requisitos: Fundamentos de pipelines GitLab CI/CD

Conteúdo

Tópico	Tier	Fonte
Variáveis no .gitlab-ci.yml e na interface (projeto, grupo, instância); variáveis predefinidas	Free	documentação
Visibilidade Visible, Masked (padrão) e Masked and hidden; requisitos de mascaramento (linha única, 8 caracteres ou mais)	Free	documentação
Variáveis protegidas (apenas branches e tags protegidas) e variáveis do tipo arquivo	Free	documentação
Precedência de variáveis e restrição de pipeline variables por papel mínimo	Free	documentação
Artefatos: paths, expire_in (padrão da instância, 30 dias), manter artefatos mais recentes, dependencies	Free	documentação
Cache: key, fallback keys, policy pull/push; cache x artefatos; branches protegidas e não protegidas não compartilham cache por padrão	Free	documentação
Relatórios de testes unitários JUnit (arquivo até 30 MB, total até 100 MB por job)	Free	documentação
Cobertura: palavra-chave coverage (percentual) e artifacts:reports:coverage_report (Cobertura ou JaCoCo)	Free	documentação

Reuso de configuração: include, extends, inputs e componentes do CI/CD Catalog · Avançado · 3 h

Objetivos

• Configurar include dos tipos local, project, remote, template e component.
• Reutilizar configuração com extends, jobs ocultos e !reference.
• Criar um componente com spec:inputs tipados.
• Publicar uma versão semântica do componente no CI/CD Catalog e consumi-la em outro projeto.

Pré-requisitos: Variáveis, artefatos, cache e relatórios de teste, Controle de execução: rules, workflow, needs e paralelismo

Conteúdo

Tópico	Tier	Fonte
include (component, local, project, remote, template); até 150 includes por pipeline; mesclagem com precedência do .gitlab-ci.yml	Free	documentação
extends (até 11 níveis de herança), jobs ocultos, âncoras YAML restritas ao próprio arquivo e !reference	Free	documentação
spec:inputs: tipos string (padrão), array, number e boolean; interpolação $[[ inputs.id ]]; input obrigatório sem default	Free	documentação
Inputs x variáveis de CI/CD (valor fixo na criação do pipeline x valor em tempo de execução)	Free	documentação
Projeto de componentes: diretório templates/, até 100 componentes por projeto, referência FQDN/caminho/componente@versão, ~latest e versão semântica parcial	Free	documentação
Publicação no CI/CD Catalog: projeto de catálogo (Owner), descrição, README.md e job com release	Free	documentação

Container registry e package registry · Intermediário · 2 h

Objetivos

• Construir e publicar imagem no container registry a partir do pipeline.
• Autenticar no registry com CI_REGISTRY_USER, CI_REGISTRY_PASSWORD ou CI_JOB_TOKEN.
• Publicar pacote genérico no package registry.
• Configurar política de limpeza do container registry.

Pré-requisitos: Variáveis, artefatos, cache e relatórios de teste

Conteúdo

Tópico	Tier	Fonte
Nome de imagem <registry>/<namespace>/<projeto>[/caminho] com até dois níveis adicionais	Free	documentação
Autenticação no pipeline com CI_REGISTRY_USER/CI_REGISTRY_PASSWORD ou CI_JOB_TOKEN	Free	documentação
Política de limpeza (name_regex e name_regex_keep)	Free	documentação
Package registry: formatos (Maven, npm, NuGet, PyPI, Terraform, entre outros)	Free	documentação
Pacotes genéricos: PUT /projects/:id/packages/generic/:nome/:versão/:arquivo	Free	documentação

Entrega contínua: ambientes, deploys, releases e proteção de produção · Intermediário · 3 h

Objetivos

• Configurar ambientes estáticos e dinâmicos com deployment tier.
• Configurar review apps com parada automática.
• Configurar deploy manual com resource_group e bloqueio de jobs de deploy desatualizados.
• Configurar ambiente protegido com aprovação de deploy.
• Criar release por pipeline e consultar a evidência da release.

Pré-requisitos: Variáveis, artefatos, cache e relatórios de teste

Conteúdo

Tópico	Tier	Fonte
environment, deployment tiers (production, staging, testing, development, other) e atribuição automática pelo nome	Free	documentação
Review apps: ambiente dinâmico por branch, on_stop com environment:action stop, auto_stop_in	Free	documentação
resource_group, Prevent outdated deployment jobs e deploy freeze (variável CI_DEPLOY_FREEZE)	Free	documentação
Ambientes protegidos	Premium	documentação
Aprovações de deploy; autoaprovação desabilitada por padrão para quem disparou o pipeline	Premium	documentação
Releases com a palavra-chave release; evidência da release em JSON	Free	documentação
Artefatos de relatório incluídos na evidência da release	Ultimate	documentação

Varreduras de segurança no pipeline: SAST, segredos, dependências, contêiner e IaC · Intermediário · 3 h

Objetivos

• Habilitar SAST, detecção de segredos no pipeline, varredura de contêiner e de IaC com templates CI/CD.
• Habilitar secret push protection e identificar as formas de ignorá-la e o registro em auditoria.
• Habilitar dependency scanning por SBOM.
• Identificar os resultados de varredura disponíveis por tier.

Pré-requisitos: Fundamentos de pipelines GitLab CI/CD

Conteúdo

Tópico	Tier	Fonte
SAST com analisadores open source, relatório JSON; exige stage test e runner Linux com executor Docker ou Kubernetes	Free	documentação
GitLab Advanced SAST e resultados de SAST no merge request	Ultimate	documentação
Detecção de segredos no pipeline (template Jobs/Secret-Detection.gitlab-ci.yml)	Free	documentação
Secret push protection (GA 17.5): bloqueio do push, [skip secret push protection], push option secret_push_protection.skip_all, evento de auditoria	Ultimate	documentação
Dependency scanning por SBOM CycloneDX (GA 19.0; template Jobs/Dependency-Scanning.v2.gitlab-ci.yml); Gemnasium depreciado em 17.9	Ultimate	documentação
Container scanning com Trivy (template Jobs/Container-Scanning.gitlab-ci.yml, variável CS_IMAGE)	Free	documentação
Varredura de IaC com KICS (template Jobs/SAST-IaC.gitlab-ci.yml)	Free	documentação

Laboratórios

Cada aluno recebe um subgrupo com os projetos dos exercícios; a correção é automática, pela API da plataforma GitLab.