Infraestrutura — integração com Kubernetes, runners, gestão de ambientes e automações

← 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

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: ci-variaveis-artefatos

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

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: ci-variaveis-artefatos, ci-regras-dag

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

Infraestrutura como código e Kubernetes: estado OpenTofu gerenciado e agente GitLab para Kubernetes · Avançado · 2 h

Objetivos

• Configurar o componente OpenTofu (validate-plan-apply) com estado gerenciado pela plataforma GitLab.
• Registrar e instalar o agente GitLab para Kubernetes com arquivo de configuração no repositório.
• Configurar ci_access para que jobs de CI/CD usem o contexto do agente.
• Identificar as versões de Kubernetes suportadas na versão 19.4.

Pré-requisitos: Entrega contínua: ambientes, deploys, releases e proteção de produção

Conteúdo

Tópico	Tier	Fonte
Estado OpenTofu/Terraform gerenciado pela plataforma GitLab, criptografado em repouso	Free	documentação
Componente OpenTofu do CI/CD Catalog (validate-plan-apply)	Free	documentação
Agente GitLab para Kubernetes: um agente por cluster, registrado em projeto, .gitlab/agents/<nome>/config.yaml	Free	documentação
Fluxo CI/CD com o agente: ci_access (projects, groups) e contexto <caminho/projeto>:<agente>	Free	documentação
GitOps com Flux e agentk	Free	documentação
Versões de Kubernetes suportadas: 1.34, 1.35 e 1.36	Free	documentação

Backup, restauração e upgrade · Avançado · 3 h

Objetivos

• Executar backup com gitlab-backup create e salvar separadamente gitlab-secrets.json e gitlab.rb.
• Restaurar backup em instância da mesma versão e tipo (CE/EE).
• Planejar o caminho de upgrade com as paradas obrigatórias da versão 19.
• Verificar a conclusão das batched background migrations antes do próximo upgrade.

Pré-requisitos: adm-arquitetura-instalacao

Conteúdo

Tópico	Tier	Fonte
gitlab-backup create: conteúdo do arquivo (banco, repositórios, artefatos, registries, uploads, estados Terraform)	Free	documentação
Dados fora do backup: /etc/gitlab (gitlab-secrets.json, gitlab.rb), object storage, Redis, chaves TLS e SSH	Free	documentação
Diretório padrão /var/opt/gitlab/backups (gitlab_rails['backup_path']); STRATEGY=copy; SKIP=	Free	documentação
Restauração: mesma versão e tipo, parada de Puma e Sidekiq, gitlab-backup restore BACKUP=<id>	Free	documentação
Paradas obrigatórias de upgrade em x.2, x.5, x.8 e x.11 (19.2, 19.5, 19.8, 19.11); última versão de patch	Free	documentação
Batched background migrations: Admin > Monitoring > Background migrations e API administrativa	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.