Configuración de Conexiones a Base de Datos en Heroku y Entorno Local

Curso de NestJS: Autenticación con Passport y JWT

Contenido del curso

Introducción

Protección con guardianes

Autenticación con Passport

Autenticación con JSON Web Tokens

Deployment

Próximos pasos

22
Implementación de Autenticación y Autorización en NestJS
00:41 min

Tomar examen

Cursos Empresas Blog Live Conf Eventos Precios

0:0011:23

Configuración de Conexiones a Base de Datos en Heroku y Entorno Local

Curso de NestJS: Autenticación con Passport y JWT

Clase 20 de 22

Clase 20 / 22

Recursos

Cuando desplegamos una aplicación en Heroku con una base de datos Postgres, la forma de conectarse cambia por completo. Ya no recibiremos variables separadas como host, puerto, usuario o contraseña, sino una única variable de entorno llamada DATABASE_URL que contiene toda la cadena de conexión. Adaptar nuestro proyecto a este formato es fundamental para que funcione tanto en desarrollo local como en producción sin romper nada.

¿Por qué Heroku envía una sola variable de entorno para la conexión?

Heroku administra sus bases de datos de forma automática y proporciona una variable llamada DATABASE_URL [0:41] que incluye protocolo, usuario, contraseña, host, puerto y nombre de la base de datos en un solo string. El formato sigue esta estructura:

postgres://usuario:password@host:puerto/nombre_base_datos

Esto significa que debemos estandarizar nuestra configuración local para usar el mismo formato. En lugar de mantener variables separadas como DB_HOST, DB_PORT, DB_USER y DB_PASSWORD, creamos una sola variable DATABASE_URL en nuestro archivo de entorno con los datos locales [1:30]:

DATABASE_URL=postgres://root:123@localhost:5432/mydb

De esta manera, tanto en desarrollo como en producción, la aplicación lee la misma variable de ambiente y la lógica de conexión se simplifica enormemente.

¿Cómo adaptar el módulo de base de datos en NestJS?

El módulo de base de datos del proyecto leía cada variable por separado desde el objeto config. Ahora solo necesitamos leer postgres_url [2:28]. Los cambios principales son:

Crear una variable postgres_url que reciba el valor de DATABASE_URL.
En la configuración de TypeORM, reemplazar las propiedades individuales (host, port, username, database) por la propiedad url y asignarle directamente la cadena de conexión [3:08].
Agregar la configuración de SSL que Heroku exige, estableciendo rejectUnauthorized en false [3:35].

Para la conexión con el driver nativo usando Client de pg, el cambio es similar: en lugar de pasar cada parámetro, se utiliza connectionString apuntando a postgres_url [3:55] y se replica la misma configuración SSL.

typescript // Configuración TypeORM { type: 'postgres', url: configService.get('postgres_url'), ssl: { rejectUnauthorized: false, }, }

// Conexión nativa con pg const client = new Client({ connectionString: postgres_url, ssl: { rejectUnauthorized: false }, });

¿Qué pasa con las validaciones en el app module?

En el AppModule se validaban las variables de entorno una a una. Ahora debemos remover las validaciones del puerto de base de datos, host y demás variables individuales, y en su lugar validar únicamente que DATABASE_URL llegue correctamente [5:12]. Esto asegura que Heroku provea la conexión antes de iniciar la aplicación.

¿Qué variables de entorno necesitamos configurar en Heroku?

Desde la interfaz web de Heroku, en la sección de settings, configuramos las variables necesarias [5:50]:

DATABASE_URL: Heroku la proporciona automáticamente al agregar el addon de Postgres.
DATABASE_NAME: si tu aplicación la utiliza internamente.
PORT: Heroku la asigna dinámicamente.
API_KEY: para autenticación de la API.
JWT_SECRET: la llave secreta para firmar tokens, que solo el equipo de infraestructura debería conocer [6:15].

¿Cómo hacer deployment a Heroku desde la terminal?

Cuando creamos el proyecto en Heroku, se agregó un remote adicional a Git. Mientras origin apunta a GitHub, heroku apunta directamente a los servidores de Heroku [6:40]. El proceso de despliegue sigue estos pasos:

Guardar cambios y hacer commit en la rama de trabajo.
Cambiar a la rama master con git checkout master.
Hacer merge de la rama de desarrollo.
Ejecutar git push heroku master [7:05].

Una vez completado el push, la aplicación queda disponible en la URL asignada. Al acceder a /docs, la documentación autogenerada con Swagger se muestra correctamente [7:25].

¿Por qué aparece el error "relation products does not exist"?

Al consultar el endpoint de productos, Heroku devuelve un error porque las tablas no existen en la base de datos remota [7:40]. Revisando los logs con heroku logs --tail [7:52], el mensaje confirma que la relación products no se encuentra. Esto ocurre porque el proyecto utiliza un sistema de migraciones y estas aún no se han ejecutado en el entorno productivo.

La base de datos está conectada y funcionando, pero las migraciones que crean las tablas todavía deben correrse en la instancia de Heroku. ¿Has tenido que adaptar cadenas de conexión similares en tus proyectos? Comparte tu experiencia y cómo resolviste los desafíos de configuración en producción.

Introducción

Autenticación de Usuarios en APIs con Nest.js y JWT

Configuración de Autenticación en Proyectos Mongo y TimeORM

Implementación de Autentificación y Autorización en API Node.js

Protección con guardianes

Creación y Uso de Guardianes en NestJS para Autorización de Endpoints

Decoradores para Control de Acceso en Controladores NETJS

Gestión de Variables de Entorno en Aplicaciones Node.js

Autenticación con Passport

Hashing de Contraseñas en Bases de Datos con Node.js

Implementación de Hashing en Proyecto Mongo con Node.js

Autenticación con Passport.js en Nest.js: Estrategias Locales

Implementación de Controlador de Login con NestJS y Estrategia Local

Autenticación con JSON Web Tokens

Implementación de JSON Web Tokens en APIs para Autenticación Segura

Implementación de JWT en Módulo de Autenticación con Variables de Entorno

Estrategia y Guardia de Autenticación con JWT en NestJS

Extensión de Guardianes JWT en NestJS para Endpoints Públicos

Control de Roles y Permisos con JSON Web Tokens en TypeScript

Creación de Endpoints Seguros con JWT en NestJS

Deployment

Configuración y Despliegue de MongoDB Atlas en Heroku

Configuración de Variables de Entorno en Heroku para MongoDB

Configuración de PostgreSQL en Heroku para Node.js

Configuración de Conexiones a Base de Datos en Heroku y Entorno Local

Migraciones con TimeORM en Producción: Configuración y Ejecución

Próximos pasos

Implementación de Autenticación y Autorización en NestJS

Configuración de Conexiones a Base de Datos en Heroku y Entorno Local

Progreso del curso

Introducción

Protección con guardianes

Autenticación con Passport

Autenticación con JSON Web Tokens

Deployment

Próximos pasos

Recursos

Recursos