Presença
Registro de presença na sessão com o código informado pelo instrutor.
coleta fechada
Agenda
| Sessão | Data | Horário | Módulos |
|---|---|---|---|
| s1 | 25/05/2027 | 09:00–11:00 | Arquitetura e instalação da plataforma GitLab Self-Managed com o pacote Linux |
| s2 | 25/05/2027 | 11:00–13:00 | GitLab Runner: tipos, executores, registro e operação; Usuários, autenticação e restrições da instância |
| s3 | 27/05/2027 | 09:00–11:00 | Backup, restauração e upgrade |
| s4 | 27/05/2027 | 11:00–13:00 | Monitoramento, logs e diagnóstico da instância; Plataforma GitLab: organização, visibilidade e papéis |
Formulários
Avaliação pré
Questionário antes do primeiro módulo (mede o conhecimento inicial).
coleta fechada
Avaliação pós
O mesmo questionário ao final da turma (mede a evolução).
coleta fechada
Satisfação
Pesquisa anônima sobre a turma, o instrutor e os laboratórios.
coleta fechada
Módulos
Arquitetura e instalação da plataforma GitLab Self-Managed com o pacote Linux · Avançado · 3 h
Objetivos
- Identificar os componentes da plataforma GitLab e o fluxo de uma requisição (NGINX, Workhorse, Puma, Sidekiq, Redis, PostgreSQL, Gitaly).
- Dimensionar a instância com base em requisições por segundo e nas arquiteturas de referência.
- Instalar a versão 19.4 pelo pacote Linux e configurar external_url e HTTPS.
- Aplicar alterações do /etc/gitlab/gitlab.rb com gitlab-ctl reconfigure.
Pré-requisitos: Plataforma GitLab: organização, visibilidade e papéis
Conteúdo
| Tópico | Tier | Fonte |
|---|---|---|
| Componentes: NGINX, GitLab Workhorse, Puma, Sidekiq, Redis, PostgreSQL, Gitaly, GitLab Shell | Free | documentação |
| Requisitos: 8 vCPU e 16 GB de memória como base em nó único; PostgreSQL 17 para GitLab 19.x; Redis ou Valkey (Redis Cluster não suportado) | Free | documentação |
| Arquiteturas de referência: RPS como métrica principal; tamanhos de 1.000 a 50.000 usuários (pacote Linux) e S/M/L/XL (Cloud Native); arquiteturas a partir de 3.000 usuários com HA incorporada | Free | documentação |
| Configuração em /etc/gitlab/gitlab.rb, external_url e gitlab-ctl reconfigure | Free | documentação |
| HTTPS: Let's Encrypt habilitado por padrão com external_url https sem outro certificado; certificado próprio em /etc/gitlab/ssl/ | Free | documentação |
| gitlab-ctl status, restart e tail | 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: ci-fundamentos
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 |
Usuários, autenticação e restrições da instância · Avançado · 2 h
Objetivos
- Configurar restrições de cadastro (desabilitar cadastro, aprovação pelo administrador).
- Configurar 2FA obrigatório com período de carência.
- Configurar autenticação LDAP no gitlab.rb e verificá-la com gitlab-rake gitlab:ldap:check.
- Identificar usuários auditores e papéis administrativos customizados.
Pré-requisitos: Arquitetura e instalação da plataforma GitLab Self-Managed com o pacote Linux
Conteúdo
| Tópico | Tier | Fonte |
|---|---|---|
| Restrições de novos usuários: cadastro aberto por padrão; aprovação do administrador habilitada por padrão em novas instâncias; domínios permitidos/negados | Free | documentação |
| 2FA obrigatório para todos os usuários ou para administradores, com período de carência em horas | Free | documentação |
| LDAP: gitlab_rails['ldap_servers']; verificação de status a cada hora em sessões ativas e sincronização diária; estado ldap_blocked | Free | documentação |
| SAML SSO para a instância Self-Managed | Free | documentação |
| Usuários auditores (somente leitura em toda a instância) | Premium | documentação |
| Papéis administrativos customizados (GA 18.3) | Ultimate | 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: Arquitetura e instalação da plataforma GitLab Self-Managed com o pacote Linux
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 |
Monitoramento, logs e diagnóstico da instância · Avançado · 2 h
Objetivos
- Configurar a allowlist de IPs dos endpoints de monitoramento.
- Consultar os endpoints de health, readiness e liveness.
- Localizar logs da aplicação em /var/log/gitlab e acompanhar com gitlab-ctl tail.
- Executar gitlab-rake gitlab:check e gitlab:env:info no diagnóstico.
Pré-requisitos: Arquitetura e instalação da plataforma GitLab Self-Managed com o pacote Linux
Conteúdo
| Tópico | Tier | Fonte |
|---|---|---|
| Endpoints /-/health, /-/readiness (com all=1 valida banco, Redis e Gitaly) e /-/liveness; HTTP 503 em falha | Free | documentação |
| Allowlist de monitoramento gitlab_rails['monitoring_whitelist'] | Free | documentação |
| Prometheus e exporters incluídos no pacote Linux, ativos por padrão, em localhost:9090, sem autenticação | Free | documentação |
| Logs: production_json.log, api_json.log, application_json.log em /var/log/gitlab/gitlab-rails/ | Free | documentação |
| Rake tasks gitlab:check e gitlab:env:info | Free | documentação |
Plataforma GitLab: organização, visibilidade e papéis · Básico · 2 h
Objetivos
- Criar grupo, subgrupo e projeto na hierarquia de um grupo de nível superior.
- Configurar a visibilidade de grupo e projeto respeitando a restrição do grupo pai.
- Atribuir papéis padrão a membros e identificar o papel efetivo herdado.
- Distinguir as permissões dos papéis Guest, Planner, Reporter, Developer, Maintainer e Owner.
Conteúdo
| Tópico | Tier | Fonte |
|---|---|---|
| Grupos, subgrupos (até 20 níveis de aninhamento) e projetos | Free | documentação |
| Visibilidade private, internal e public; visibilidade do projeto igual ou mais restritiva que a do grupo pai | Free | documentação |
| Visibilidade internal disponível apenas em GitLab Self-Managed e GitLab Dedicated | Free | documentação |
| Papéis padrão (Minimal Access, Guest, Planner, Reporter, Developer, Maintainer, Owner) e prevalência do papel mais alto na herança | Free | documentação |
| Papel Security Manager (beta desde 18.11) | Free | documentação |
| Membros de projeto e de grupo, membros herdados e diretos | 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.
| Exercício | Título | Objetivo | Tier | Duração |
|---|---|---|---|---|
| lab-plataforma-01 | Estruturar grupo, subgrupo e projeto com papéis | Criar a hierarquia de um time e atribuir papéis padrão a membros. | Free | 40 min |