Lección 12 de 12 · Lectura y práctica
CI basico con GitHub Actions (conceptos)
Prepara una integración continua mínima para Node.js: instalación reproducible, scripts explícitos y una prueba de fallo en una rama.
Del concepto a la práctica
Taller de esta lección
La integración continua es una secuencia reproducible de checks, no una garantía total. El diseño debe declarar el evento, preparar el código, instalar con el lockfile y ejecutar scripts que ya existen. Las referencias de acciones y la versión de Node deben ser revisadas contra el proyecto antes de activar el archivo.
Ejemplo resuelto
Para un proyecto npm que ya tiene test y build, un archivo .github/workflows/ci.yml puede ser:
name: CI
on: [pull_request]
permissions:
contents: read
jobs:
checks:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: '24'
- run: npm ci
- run: npm test
- run: npm run buildLa documentación oficial consultada muestra checkout v6 y setup-node v7. Este ejemplo exige Node 24 compatible, package-lock.json confirmado y scripts test/build existentes. Revisa versiones y requisitos de runner antes de activarlo; en un equipo fija las acciones por SHA revisado según su política.
Pruébalo
Lista scripts y lockfile existentes.
Ordena checkout, entorno, instalación y checks.
Introduce un fallo controlado en una branch de prueba.
Verifica que la ejecución falla por la razón esperada.
Error frecuente: interpretar una ejecución verde como prueba de toda la aplicación. Corrección: enumera explícitamente qué checks cubre y qué queda fuera.
Comprueba tu resultado
Tu diseño debe señalar los scripts reales, conservar un único lockfile y mostrar una ejecución roja ante un fallo reproducible, sin publicar ni desplegar nada.

Mapa de prácticaLos cambios se preparan en una rama y se registran en commits pequeños. Las pruebas y la revisión del pull request comprueban el cambio antes de integrarlo. El historial permite entender qué se modificó y recuperar una versión anterior.
Ver la infografía en tamaño completo ↗Fuentes para profundizar
Conserva el objetivo del pipeline
La integración continua ejecuta comprobaciones cuando cambia el código. Conservamos el orden instalación, pruebas y build del ejemplo anterior, pero ahora declaramos el entorno y usamos el archivo de bloqueo. Una ejecución verde solo demuestra que pasaron los checks configurados; no garantiza que toda la aplicación esté correcta.
Ejemplo para un proyecto npm
Este ejemplo requiere un package-lock.json y scripts test, typecheck y build existentes. Adáptalo si el repositorio utiliza otro gestor; no crees un segundo lockfile.
# .github/workflows/ci.yml
name: CI
on: [pull_request]
permissions:
contents: read
jobs:
check:
runs-on: ubuntu-latest
steps:
- uses: actions/checkout@v6
- uses: actions/setup-node@v7
with:
node-version: "24"
cache: npm
- run: npm ci
- run: npm test
- run: npm run typecheck
- run: npm run build
Las acciones corresponden a la documentación oficial consultada; comprueba compatibilidad y política de versiones de tu repositorio. Una organización puede exigir referencias a commits completos en lugar de etiquetas. Elige una versión de Node soportada por tu proyecto y úsala también al desarrollar.
Prueba útil: que el check detecte un error
- Ejecuta esos mismos scripts localmente y guarda las versiones de Node y npm.
- En una rama de práctica, cambia una expectativa de una prueba para provocar un fallo conocido.
- Abre un PR y verifica que el job falla en ese paso, con un mensaje que puedas explicar.
- Restaura la expectativa y comprueba que vuelve a pasar.
- Revisa las reglas de la rama: ejecutar CI no significa que el check sea obligatorio para fusionar.
Lee un fallo antes de reintentar
Si falla npm ci, revisa lockfile y versión antes de culpar a las pruebas. Si falla una prueba, mira su primer error. Si falla el build, comprueba variables requeridas sin imprimir secretos. Una caché acelera la instalación; no debe reemplazar la instalación ni ocultar dependencias no declaradas.
- El pipeline utiliza el gestor y lockfile reales.
- Cada script existe y un error devuelve salida distinta de cero.
- Una prueba intencional roja y su corrección quedan registradas.
- La configuración no publica credenciales ni despliega automáticamente.
Referencias para comprobar la implementación
Documentación consultada el 2 de octubre de 2026. Comprueba también las versiones y condiciones de tu proyecto.
Sigue con Git y GitHub Pro
Esta lección forma parte de un curso de Cursalo. Revisa su programa y elige entre la compra individual o el acceso a toda la escuela.
Si ya tenías acceso a este curso, entra con tu cuenta: tus derechos y tu progreso se conservan. No necesitas comprarlo de nuevo.