Tu primer CI en GitHub Actions con matriz de versiones (explicado en español)
Si tu proyecto no tiene integración continua, cada push es una apuesta: "en mi máquina funciona". Con GitHub Actions puedes ejecutar tu linter y tus tests automáticamente en cada push y en cada pull request, gratis en repositorios públicos. En este tutorial armamos un workflow para Node.js que prueba tu código en dos versiones de Node a la vez, y explico cada línea para que lo adaptes a cualquier…
Para implementar una Integração Contínua (CI) en GitHub Actions utilizando una matriz de versiones, sigue estos pasos en español:
1. Crea un archivo llamado `.github/workflows/node-ci.yml` en tu repositorio. Esta ubicación indica a GitHub que este archivo será un workflow para la CI.
2. Configura el workflow para que se active en cada push y pull request a la rama principal (main). Esto se define en la sección `on` del archivo, especificando las ramas `branches: [main]`.
3. Establece una política de concurrencia para cancelar ejecuciones anteriores cuando se inicie una nueva, optimizando así el tiempo de ejecución y los minutos gratuitos disponibles. Esto se logra con la sección `concurrency:`.
4. Define una matriz (`strategy.matrix`) que incluya las versiones de Node.js a probar, en este caso, las versiones 20 y 22. Esto permite ejecutar los tests en ambas versiones de manera paralela, ahorrando tiempo y recursos.
5. Configura los pasos del workflow:
- Extrae el código del repositorio usando `actions/checkout@v4`.
- Configura Node.js usando `actions/setup-node@v4`, especificando la versión a utilizar de la matriz.
- Instala las dependencias del proyecto con `npm ci`, lo que asegura una instalación consistente utilizando el `package-lock.json`.
- Ejecuta la herramienta de análisis estático de código (lint) con `npm run lint`.
- Ejecuta los tests con `npm test`.
6. Implementa políticas de permisos para limitar el token del workflow, permitiendo solo lectura del código (`permissions: contents: read`), lo cual mejora la seguridad del repositorio.
7. Una vez que el CI está configurado, configura tus ramas para que solo se permitan merges después de que los checks de CI hayan aprobado la rama. Esto se hace en la sección de Settings > Branches o Rules, y asegura que solo se fusionen sistemas de código que cumplan con los estándares de tu equipo.
Este proceso te permite mantener un pipeline de CI eficiente y seguro para tu proyecto de Node.js utilizando GitHub Actions y una matriz de versiones de Node.js, sin requerir conocimientos adicionales más allá de lo proporcionado.
Written by urgent.news from Dev.to's reporting — not their text. Machine-written — may contain errors; check the original before relying on it.
