Saltar al contenido

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:

yaml
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 build

La 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

  1. Lista scripts y lockfile existentes.

  2. Ordena checkout, entorno, instalación y checks.

  3. Introduce un fallo controlado en una branch de prueba.

  4. 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.

Rama de trabajo con commits, pruebas y revisión antes de integrarla en la rama principal.
CursaloMapa de práctica
Cambios pequeños, revisión clara

Los 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

  1. Ejecuta esos mismos scripts localmente y guarda las versiones de Node y npm.
  2. En una rama de práctica, cambia una expectativa de una prueba para provocar un fallo conocido.
  3. Abre un PR y verifica que el job falla en ese paso, con un mensaje que puedas explicar.
  4. Restaura la expectativa y comprueba que vuelve a pasar.
  5. 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.

01 / ELEGIR UNA RUTA

El próximo paso

Aprende IA mientras construyes algo que sí necesitas.

Empieza por el curso inicial o explora el catálogo para encontrar una práctica alineada con tu trabajo.