Code and Bytes

Hace poco me encontré con un error bastante común (pero frustrante) al ejecutar tests de PHPUnit en GitHub Actions usando Laravel. Localmente todo funcionaba perfecto, pero en CI los tests fallaban inmediatamente con un error de conexión a la base de datos.

El problema

Al ejecutar los tests en GitHub Actions, aparecía el siguiente error:

Illuminate\Database\QueryException: SQLSTATE[08006] [7] connection to server at "127.0.0.1", port 5432 failed: Connection refused
Is the server running on that host and accepting TCP/IP connections?

Esto ocurría al intentar correr un test básico:

Tests\Feature\Auth\AuthenticationTest::test_login_screen_can_be_rendered

Si estás montando un proyecto Laravel y quieres una base de datos PostgreSQL aislada con Docker, esta configuración te deja todo listo en pocos pasos, incluyendo:

¿Qué vas a tener al final?

• Laravel conectado a PostgreSQL por DB_CONNECTION=pgsql
• Contenedor Docker con la imagen pgvector/pgvector:pg16
• Script de inicialización que:
  • Habilita la extensión vector
  • Crea la base de datos