Cómo usar: Generador GitLab CI
- Elige tu stack (Node.js, Python, Go, una imagen Docker o un sitio estático en GitLab Pages) y define la versión.
- Marca los jobs que quieras: lint, test, build y cobertura. Deja activadas las reglas de merge request para probar cada MR.
- Opcionalmente, añade un job de deploy a un servidor por SSH o a Pages, con aprobación manual si lo prefieres.
- Guarda el archivo como
.gitlab-ci.ymlen la raíz del repositorio. El pipeline arranca con el siguiente push.
Cómo está montado el pipeline
- workflow:rules ejecuta el pipeline para merge requests y para los push a la rama principal, y omite el pipeline duplicado de la rama cuando hay un MR abierto.
- cache usa como clave el archivo de bloqueo (
package-lock.json,pnpm-lock.yaml,requirements.txt,go.sum), así las dependencias se instalan rápido y la caché se renueva cuando cambian. - artifacts pasa la salida del build a los jobs siguientes y conserva los informes de tests y cobertura, que GitLab muestra en el merge request.
- interruptible: true junto con “cancelar pipelines redundantes automáticamente” detiene los pipelines obsoletos cuando vuelves a hacer push.
Secretos
Nunca pongas contraseñas ni claves en el YAML. Añádelas en Settings → CI/CD → Variables (enmascaradas y protegidas). El job de deploy espera SSH_PRIVATE_KEY y SSH_KNOWN_HOSTS ahí. El job de Docker usa las variables integradas CI_REGISTRY de GitLab, así que no necesita configuración.
¿Prefieres GitHub? Prueba el Generador de GitHub Actions. Relacionados: Generador de Dockerfile, Validador de YAML.
También se busca como: generador gitlab-ci.yml, ejemplo gitlab ci yml, generador pipeline gitlab, gitlab ci node, gitlab ci docker build, gitlab pages ci, plantilla gitlab ci.
Herramientas que combinan con: Generador GitLab CI
- Validador de GitHub Actions — Pega un workflow de .github/workflows y encuentra los problemas antes que CI: triggers no válidos, runs-on que falta, needs rotos, expresiones incorrectas, acciones obsoletas y riesgos de inyección de scripts.
- Generador de Docker Compose — Marca los servicios que necesites —aplicación, base de datos, caché, interfaz de administración, receptor de correo— y obtén un archivo `compose.yaml` limpio con imágenes fijadas, volúmenes con nombre, comprobaciones de estado y depends_on condiciones, además de un archivo .env a juego con contraseñas generadas.
- Generador de YAML de Kubernetes — Indica el nombre de tu app, la imagen y el puerto, y obtén YAML de Kubernetes listo para producción: un Deployment con probes, límites de recursos y un contexto de seguridad reforzado, además del Service, el Ingress con TLS, el ConfigMap, el Secret y el HorizontalPodAutoscaler que marques, todo en un solo archivo listo para kubectl apply.
- Generador de servicios systemd — Ejecuta tu app como un servicio de Linux que arranca con el sistema y se reinicia si falla.
Preguntas frecuentes
¿Dónde va el .gitlab-ci.yml?
En la raíz del repositorio. GitLab lo lee en cada push. También puedes revisarlo en Build → Pipeline editor, que valida la sintaxis.
¿Por qué mi pipeline se ejecuta dos veces en un merge request?
Sin reglas de workflow, GitLab crea un pipeline de rama y otro de merge request. El bloque workflow:rules generado deja solo uno.
¿Cómo construyo y subo una imagen Docker en GitLab CI?
Elige el stack de imagen Docker. Inicia sesión con las variables integradas CI_REGISTRY, construye con Docker-in-Docker y sube una etiqueta con el commit y latest para la rama principal.
¿Cómo publico en GitLab Pages?
Elige GitLab Pages. El job construye tu sitio y mueve la salida a la carpeta public, que GitLab publica automáticamente.
¿Puedo instalar Generador GitLab CI como aplicación web y utilizarla sin conexión?
Sí. Generador GitLab CI es una aplicación web instalable (PWA): se instala desde el navegador, no se descarga desde una tienda de aplicaciones. Haz clic en «Instalar aplicación» en la parte superior de esta página en Chrome o Edge (Windows, macOS, Linux, ChromeOS) o, en Android, utiliza «Compartir» → «Añadir a la pantalla de inicio» en iPhone y iPad, o «Archivo» → «Añadir al Dock» en Safari 17+ en un Mac. A continuación, se abrirá en su propia ventana con su propio icono y, como se ejecuta íntegramente en tu navegador, seguirá funcionando sin conexión. Firefox en el ordenador de sobremesa no permite instalar aplicaciones web. Cómo funciona la instalación.