Como usar: Gerador de GitLab CI
- Escolha sua stack — Node.js, Python, Go, uma imagem Docker ou um site estático no GitLab Pages — e defina a versão.
- Marque os jobs que você quer: lint, teste, build, cobertura; mantenha as regras de merge request ativadas para testar cada MR.
- Se quiser, adicione um job de deploy para um servidor via SSH ou para o Pages, com aprovação manual se preferir.
- Faça commit do arquivo como
.gitlab-ci.ymlna raiz do repositório — o pipeline começa no próximo push.
Como o pipeline é montado
- workflow:rules executa o pipeline para merge requests e para pushes na branch padrão, e pula o pipeline duplicado da branch quando existe um MR aberto.
- cache é baseado no arquivo de lock (
package-lock.json,pnpm-lock.yaml,requirements.txt,go.sum), então as dependências instalam rápido e o cache é atualizado quando elas mudam. - artifacts passam a saída do build para os jobs seguintes e guardam os relatórios de teste e cobertura, que o GitLab mostra no merge request.
- interruptible: true com “auto-cancel redundant pipelines” interrompe pipelines desatualizados quando você faz um novo push.
Segredos
Nunca coloque senhas ou chaves no YAML. Adicione-as em Settings → CI/CD → Variables (mascaradas e protegidas) — o job de deploy espera SSH_PRIVATE_KEY e SSH_KNOWN_HOSTS ali. O job Docker usa as variáveis nativas CI_REGISTRY do GitLab, então não precisa de configuração.
Usa GitHub? Experimente o Gerador de GitHub Actions. Relacionados: Gerador de Dockerfile, Validador de YAML.
Também pesquisado como: gerador gitlab ci, gerador gitlab-ci.yml, exemplo gitlab ci yml, gerador de pipeline gitlab, gitlab ci node, gitlab ci docker build, gitlab pages ci, template gitlab ci.
Ferramentas que combinam com: Gerador de GitLab CI
- Validador de Workflow do GitHub Actions — Cole um workflow de .github/workflows e encontre problemas antes que o CI encontre — triggers inválidos, runs-on ausente, needs quebrado, expressões incorretas, actions desatualizadas e riscos de injeção de script.
- Gerador do Docker Compose — Marque os serviços que você precisa — aplicativo, banco de dados, cache, interface de administração, captador de e-mails — e receba um arquivo `compose.yaml` limpo com imagens fixadas, volumes nomeados, verificações de integridade e depends_on condições, além de um arquivo .env correspondente com senhas geradas.
- Gerador de YAML Kubernetes — Preencha o nome, a imagem e a porta do seu app e receba YAML do Kubernetes pronto para produção: um Deployment com probes, limites de recursos e contexto de segurança reforçado, além do Service, do Ingress com TLS, do ConfigMap, do Secret e do HorizontalPodAutoscaler que você marcar, tudo em um arquivo pronto para kubectl apply.
- Gerador de systemd Service — Rode seu app como um serviço Linux de verdade, que inicia com o sistema e reinicia quando trava.
Perguntas frequentes
Onde o .gitlab-ci.yml deve ficar?
Na raiz do repositório. O GitLab lê o arquivo a cada push; você também pode conferi-lo em Build → Pipeline editor, que valida a sintaxe.
Por que meu pipeline roda duas vezes para um merge request?
Sem regras de workflow, o GitLab cria um pipeline da branch e um pipeline do merge request. O bloco workflow:rules gerado mantém apenas um.
Como faço build e push de uma imagem Docker no GitLab CI?
Escolha a stack Docker image: ela faz login com as variáveis nativas CI_REGISTRY, faz o build com Docker-in-Docker e envia uma tag para o commit e a tag latest para a branch padrão.
Como publico no GitLab Pages?
Escolha GitLab Pages: o job gera seu site e move a saída para a pasta public, que o GitLab publica automaticamente.
Posso instalar o Gerador de GitLab CI como um aplicativo da web e usá-lo offline?
Sim. O Gerador de GitLab CI é um aplicativo da web instalável (PWA) — instalado a partir do seu navegador, não baixado de uma loja de aplicativos. Clique em “Instalar aplicativo” na parte superior desta página no Chrome ou no Edge (Windows, macOS, Linux, ChromeOS) ou, no Android, use “Compartilhar” → “Adicionar à tela inicial” no iPhone e no iPad, ou “Arquivo” → “Adicionar ao Dock” no Safari 17+ em um Mac. Em seguida, ela se abre em uma janela própria com seu próprio ícone e, como é executada inteiramente no seu navegador, continua funcionando offline. O Firefox no desktop não permite a instalação de aplicativos da web. Como funciona a instalação.