Como usar: GitLab CI Generator
- Choose your stack — Node.js, Python, Go, a Docker image or a static site on GitLab Pages — and set the version.
- Tick the jobs you want: lint, test, build, coverage; keep merge request rules on to test every MR.
- Optionally add a deploy job to a server over SSH or to Pages, with manual approval if you like.
- Commit the file as
.gitlab-ci.ymlin the repository root — the pipeline starts on the next push.
How the pipeline is put together
- workflow:rules run the pipeline for merge requests and for pushes to the default branch, and skip the duplicate branch pipeline when an MR is open.
- cache is keyed on the lock file (
package-lock.json,pnpm-lock.yaml,requirements.txt,go.sum) so dependencies install quickly and the cache refreshes when they change. - artifacts pass the build output to later jobs and keep test and coverage reports, which GitLab shows in the merge request.
- interruptible: true with “auto-cancel redundant pipelines” stops outdated pipelines when you push again.
Secrets
Never put passwords or keys in the YAML. Add them under Settings → CI/CD → Variables (masked and protected) — the deploy job expects SSH_PRIVATE_KEY and SSH_KNOWN_HOSTS there. The Docker job uses GitLab’s built-in CI_REGISTRY variables, so it needs no setup.
Using GitHub instead? Try the GitHub Actions Generator. Related: Dockerfile Generator, YAML Validator.
Também pesquisado como: gitlab-ci.yml generator, gitlab ci yml example, gitlab pipeline generator, gitlab ci node, gitlab ci docker build, gitlab pages ci, gitlab ci template.
Ferramentas que combinam com: GitLab CI Generator
- GitHub Actions Workflow Validator — Paste a workflow from .github/workflows and find problems before CI does — invalid triggers, missing runs-on, broken needs, bad expressions, outdated actions and script-injection risks.
- 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.
- Kubernetes YAML Generator — Fill in your app’s name, image and port and get production-ready Kubernetes YAML: a Deployment with probes, resource limits and a hardened security context, plus the Service, Ingress with TLS, ConfigMap, Secret and HorizontalPodAutoscaler you tick — in one file ready for kubectl apply.
- systemd Service Generator — Run your app as a proper Linux service that starts on boot and restarts when it crashes.
Perguntas frequentes
Where does .gitlab-ci.yml go?
In the root of the repository. GitLab reads it on every push; you can also check it under Build → Pipeline editor, which validates the syntax.
Why does my pipeline run twice for a merge request?
Without workflow rules GitLab creates a branch pipeline and a merge request pipeline. The generated workflow:rules block keeps only one.
How do I build and push a Docker image in GitLab CI?
Choose the Docker image stack: it logs in with the built-in CI_REGISTRY variables, builds with Docker-in-Docker and pushes a tag for the commit and latest for the default branch.
How do I publish to GitLab Pages?
Choose GitLab Pages: the job builds your site and moves the output into the public folder, which GitLab publishes automatically.
Posso instalar o GitLab CI Generator como um aplicativo da web e usá-lo offline?
Sim. O GitLab CI Generator é 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.