CI/CD para proyectos JavaScript: GitHub Actions de la A a la Z

Introducción: Por qué CI/CD es necesario para proyectos JavaScript

El desarrollo web moderno es impensable sin automatización. Cada día, los desarrolladores de JavaScript (Node.js) se enfrentan a tareas rutinarias: ejecutar pruebas, verificar el código con linter, compilar y desplegar la aplicación. Realizar estas operaciones manualmente no solo consume tiempo, sino que también es propenso a errores. Aquí es donde CI/CD (Continuous Integration / Continuous Deployment) viene al rescate: una metodología que permite automatizar todas las etapas del ciclo de vida del software.

GitHub Actions es una herramienta de automatización integrada en la plataforma GitHub, ideal para configurar pipelines de CI/CD. En este artículo, analizaremos cómo configurar desde cero un ciclo completo de automatización para un proyecto JavaScript (Node.js): desde la ejecución de pruebas hasta el despliegue en un servidor. Aprenderá a crear un flujo de trabajo, escribir archivos de configuración y evitar errores típicos.

Fundamentos de GitHub Actions: Estructura y componentes

Antes de escribir código, comprendamos los conceptos clave de GitHub Actions. Todo el pipeline se describe en archivos YAML, que se almacenan en el directorio .github/workflows de su repositorio.

Elementos clave de un flujo de trabajo (Workflow)

• Workflow — es un proceso automatizado que consta de uno o más Job (tareas).
• Job — un conjunto de pasos (Step) que se ejecutan en un mismo Runner (máquina virtual).
• Step — un comando o acción individual (Action).
• Event — el desencadenante que inicia el workflow (por ejemplo, push, pull request).

Para proyectos JavaScript, un workflow estándar se ve así:

name: CI/CD para Node.js

on:  push:    branches: [ main ]  pull_request:    branches: [ main ]

jobs:  build-and-test:    runs-on: ubuntu-latest        strategy:      matrix:        node-version: [18.x, 20.x]        steps:    - uses: actions/checkout@v4    - name: Instalación de Node.js      uses: actions/setup-node@v4      with:        node-version: ${{ matrix.node-version }}    - name: Instalación de dependencias      run: npm ci    - name: Linting      run: npm run lint    - name: Pruebas      run: npm test

Observe strategy.matrix — esto permite probar el código en múltiples versiones de Node.js simultáneamente, lo cual es crítico para bibliotecas y paquetes.

Configuración paso a paso de CI/CD para un proyecto Node.js

Consideremos un ejemplo completo de configuración de un pipeline para una aplicación web típica en Express.js. Comenzaremos con el archivo base .github/workflows/node-ci.yml.

Paso 1: Verificación básica del código

name: Node.js CI

on:  push:    branches: [ develop, main ]  pull_request:    branches: [ main ]

jobs:  quality:    runs-on: ubuntu-latest        steps:    - uses: actions/checkout@v4        - name: Setup Node.js      uses: actions/setup-node@v4      with:        node-version: '20'        cache: 'npm'        - name: Install dependencies      run: npm ci        - name: Lint code      run: npm run lint        - name: Run unit tests      run: npm run test:unit        - name: Build project      run: npm run build

Puntos clave:

• cache: 'npm' — almacena en caché node_modules, acelerando ejecuciones posteriores.
• npm ci — instalación limpia de dependencias, más rápida y confiable que npm install.
• Separar las pruebas en unit e integration (opcional) permite obtener retroalimentación más rápidamente.

Paso 2: Pruebas de integración con base de datos

Para probar con una base de datos real, use los servicios de GitHub Actions:

jobs:  integration-tests:    runs-on: ubuntu-latest