Home Projects Portfolio Dashboard Export PDF Log in

Automatizando Pruebas de Integración con GitHub Actions y PostgreSQL en OpsMind

Introducción

En el proyecto OpsMind, la calidad del software y la estabilidad de las ramas principales son pilares fundamentales. Para asegurar que cada cambio de código mantenga o mejore estos estándares, hemos integrado un robusto pipeline de Integración Continua (CI) utilizando GitHub Actions. Este flujo de trabajo automatiza verificaciones esenciales, permitiendo a nuestro equipo desarrollar con mayor confianza y rapidez.

Lo que Logramos

Recientemente, hemos configurado un pipeline de CI completo que se activa automáticamente con cada push y pull request dirigido a las ramas main y develop. Esta implementación es crucial para detectar regresiones y problemas de integración tempranamente en el ciclo de desarrollo. Los puntos clave de este logro incluyen:

  • Entorno de Ejecución Automatizado: Se estableció un runner de Ubuntu-latest con Node.js v20 para asegurar un ambiente consistente y actualizado para nuestras pruebas.
  • Base de Datos Aislada para Pruebas: Se integró un contenedor de servicio de PostgreSQL 15 dedicado exclusivamente para las pruebas de integración. Esto garantiza que las pruebas se ejecuten en un entorno limpio y predecible, sin afectar bases de datos de desarrollo o producción. Se utiliza pg_isready para verificar la disponibilidad de la base de datos antes de proceder con los scripts.

Detalles de Implementación Clave

Para garantizar la hermeticidad y fiabilidad de nuestras pruebas de integración, se implementaron los siguientes detalles técnicos:

  • Configuración de Variables de Entorno: Se inyectaron variables de entorno aisladas y claves API de prueba ("dummy") que son esenciales para la ejecución de las pruebas. Esto evita la dependencia de servicios externos reales durante la fase de CI.
    // Ejemplo de cómo se podrían usar variables de entorno en un script de prueba
    if (!process.env.DATABASE_URL) {
      console.error('DATABASE_URL no está configurada. ¿Estás en un entorno de CI?');
      process.exit(1);
    }
    
    // Configuración de la conexión a la base de datos de pruebas
    const { Pool } = require('pg');
    const pool = new Pool({
      connectionString: process.env.DATABASE_URL
    });
    
    async function runDatabaseCheck() {
      try {
        await pool.query('SELECT 1');
        console.log('Conexión a la base de datos exitosa.');
      } catch (error) {
        console.error('Fallo al conectar a la base de datos:', error);
        process.exit(1);
      }
    }
    
    runDatabaseCheck();
    
  • Sincronización de Prisma y Ejecución de Pruebas: El flujo de trabajo automatiza la sincronización del esquema de la base de datos utilizando npx prisma db push, lo que asegura que el esquema esté actualizado antes de ejecutar las pruebas. Inmediatamente después, se ejecuta la suite completa de 22 pruebas de integración con npm test.

El Impacto y Siguientes Pasos

La implementación de este pipeline de CI tiene un impacto directo en la robustez de nuestro proceso de desarrollo. Nos permite:

  • Protección de Ramas: Al ejecutar pruebas automáticamente en main y develop, aseguramos que solo el código que pasa las pruebas se fusione, manteniendo la estabilidad de las ramas críticas.
  • Retroalimentación Rápida: Los desarrolladores reciben retroalimentación instantánea sobre la calidad de su código, lo que facilita la corrección temprana de errores.
  • Mayor Confianza: Aumenta la confianza en la base de código, sabiendo que las funcionalidades clave están siendo probadas de forma continua.

Actualmente, el flujo de trabajo ha sido auditado localmente y su comportamiento en vivo se verificará con esta Pull Request. Mirando hacia adelante, buscaremos optimizar los tiempos de ejecución de las pruebas y expandir la cobertura cuando sea necesario.

Conclusión

Establecer un pipeline de Integración Continua con GitHub Actions y PostgreSQL para nuestras pruebas de integración es un paso significativo para OpsMind. Nos equipa con las herramientas necesarias para mantener un alto estándar de calidad de código y un proceso de desarrollo eficiente y fiable. Es una inversión clave en la salud a largo plazo de nuestro proyecto.


Generated with Gitvlg.com

Automatizando Pruebas de Integración con GitHub Actions y PostgreSQL en OpsMind
Lenin Moreno

Lenin Moreno

Author

Share: