Deployment de Postgres en Heroku: Configuración y Migraciones

Clase 25 de 27 • Curso de Backend con Node.js: Base de Datos con PostgreSQL

Resumen

¿Cómo lanzar una base de datos en producción con Heroku?

Llevar tu aplicación a producción requiere configuraciones cuidadosas, especialmente si deseas incorporar una base de datos. Hacerlo de manera segura y eficiente asegura que tu aplicación funcione de manera óptima con datos en tiempo real. Heroku ofrece una solución robusta, simplificada y gestionada para implementar bases de datos Postgres en la nube. Vamos a adentrarnos en los pasos necesarios para configurar tu base de datos en Heroku y lanzar tu aplicación a producción de manera exitosa.

¿Cómo gestionar bases de datos con Heroku?

Heroku es una opción atractiva para gestionar bases de datos debido a sus servicios de seguridad, copias de seguridad automáticas y una integración fluida con aplicaciones en la nube. Antes de lanzar una base de datos en producción, ten en cuenta los siguientes aspectos:

Proveedores existentes: Hay múltiples proveedores de bases de datos, cada uno con características específicas. Heroku es solo uno de ellos, pero también puedes considerar Amazon o DigitalOcean según tus necesidades.
Planes de precios: Heroku ofrece un plan gratuito para el desarrollo y planes pagos a partir de $9 al mes para producción. Elige según el nivel de seguridad y capacidad que tu proyecto requiere.

¿Cómo configurar la base de datos en Heroku?

Para integrar Postgres con tu aplicación en Heroku, sigue estos pasos prácticos:

Configuración inicial:
- Asegúrate de tener el cliente de comandos de Heroku instalado y configurado.
- Crea o selecciona un proyecto existente en Heroku al que quieras implementar.
Conexión del proyecto a Heroku:
- Si tu proyecto no está enlazado con Heroku, utiliza el comando:
```
heroku git:remote -a nombre-del-proyecto
```
Agregar el complemento de Postgres:
- Incorpora Postgres a tu aplicación con el comando:
```
heroku addons:create heroku-postgresql:hobby-dev
```
  Este comando crea una nueva base de datos y provee acceso a la URL de conexión mediante variables de entorno.

¿Cómo configurar variables de conexión en el código?

Una vez la base de datos está configurada, ajusta tu código para que pueda conectarse a la base de datos de producción. Esto implica crear las condiciones para que tu aplicación lea variables de entorno necesarias, como el DATABASE_URL, que Heroku proporciona automáticamente.

Configuración del entorno: Identifica si estás en un entorno de producción o desarrollo usando una variable isProd.
Lectura de la URL de conexión: Define cómo tu aplicación leerá la URL en producción, usualmente almacenada como process.env.DATABASE_URL.

¿Cómo realizar despliegues adecuados en Heroku?

El despliegue correcto implica tanto la actualización del código como la migración de datos:

Realizar cambios en el código:
- Modifica tu archivo de configuración para apuntar a la base de datos de producción usando las variables adecuadas.
- Configura SSL si es necesario para la conexión segura habilitando el parámetro requireSSL.
Despliegue del código a Heroku:
- Confirma tus cambios y asegúrate de que la rama sea compatible.
- Usa:
```
git push heroku main
```
Ejecución de migraciones:
- Asegúrate de correr todas las migraciones de la base de datos para que tu aplicación pueda crear las tablas necesarias.
- Ejecuta el comando en el entorno de producción:
```
heroku run npm run migrations:run
```

¿Cómo solucionar problemas comunes en migraciones con Heroku?

En ocasiones, podrías enfrentar problemas de conexión o migración por configuraciones incorrectas. Verifica los siguientes aspectos para solucionarlos:

Errores de SSL: Asegúrate de que la configuración de SSL esté habilitada correctamente, cambiando el valor del parámetro rejectUnauthorized.
Instalación de dependencias: Heroku por defecto instala solo las dependencias de producción. Si una herramienta de migración está en tus dependencias de desarrollo, trasládala a las de producción para garantizar que esté disponible.

Adoptar estas prácticas asegura un entorno más robusto y preparado para los desafíos del lanzamiento en producción. Mantente siempre atento a la documentación y recomendaciones específicas de Heroku para optimizar tus despliegues y gestión de datos en la nube.

Cesar Gonzalez Groh

student•

Es muy bueno mostrar en los cursos lor errores. Esto demuestra que a todos nos pasa. Me siento mejor :)

add-role

Con respecto a la migracion de add-role, esta falla porque tenemos el userSchema ya actualizado con el campo role. Este campo ya fue agregado en la primer migracion que fue exitosa

Gustavo Gonzalez Montero

student•

Make all the sense of the world

Rodrigo Ramos Xochiteotzin

student•

de hecho me pasó muchas veces y lo que hacía era ir borrando las migraciones que no hacían match con la versión actualizada,. funcionó pero no sugiero hacerlo, algo me dice que es una muy mala práctica

Juan Carlos Aguilar

student•

R.I.P heroku free :'( 2022

Raúl Mamani Cusi

student•

Hay alguna otra alternativa a Heroku?

Larry Finol

student•

Te recomiendo Railway, te ofrece 500 horas gratuitas de uso al mes y en este tendrás la posibilidad de alojar tanto la api en Express como la base de datos de PostgreSQL. También te permite conectarte a tu api a través de la terminal y poder correr tus migraciones una vez hayas realizado el deploy (cosa que otros servicios como Render no permiten en su capa gratuita).

Juan Jiménez

student•

Agregar a Heroku un proyecto existente: heroku git:remote -a nombre-del-repositorio

Crear un nuevo proyecto de Heroku: heroku create

Crear BD en Heroku: heroku addons:create heroku-postgresql:hobby-dev

Documentación de la BD postgresql en Heroku: heroku addons:docs heroku-postgresql

Información de la base de datos elegida: heroku pg:info

Se debe establecer la variable de entorno DATABASE_URL que da Heroku para poder conectarnos a la BD, sin embargo, también podemos usar la misma variable en el entorno de producción y para ello se agrega al archivo .env.

PORT=3000
DB_USER='john'
DB_PASSWORD='admin123'
DB_HOST='localhost'
DB_NAME='my_store'
DB_PORT='5432'
DATABASE_URL='postgres://john:admin123@localhost:5432/my_store'

En config/config.js se establece una nueva variable llamada isProd la cual será verdadera únicamente si la variable es production, es decir, va identificar si estamos en producción. También se agrega dbUrl donde se leerá DATABASE_URL que envía Heroku o que también podemos establecer en entorno de desarrollo.

require('dotenv').config();

const config = {
  env: process.env.NODE_ENV || 'dev',
  isProd: process.env.NODE_ENV === 'production',
  port: process.env.PORT || 3000,
  dbUser: process.env.DB_USER,
  dbPassword: process.env.DB_PASSWORD,
  dbHost: process.env.DB_HOST,
  dbName: process.env.DB_NAME,
  dbPort: process.env.DB_PORT,
  dbUrl: process.env.DATABASE_URL,
};

module.exports = { config };

Con esto se puede modificar postgres.pool.js haciendo una condición en la URI si estamos en desarrollo o producción:

const { Pool } = require('pg');
const { config } = require('../config/config');

const options = {};

if (config.isProd) {
  options.connectionString = config.dbUrl;
  options.ssl =  {
    rejectUnauthorized: false
  };
} else {
  const USER = encodeURIComponent(config.dbUser);
  const PASSWORD = encodeURIComponent(config.dbPassword);
  const URI = `postgres://${USER}:${PASSWORD}@${config.dbHost}:${config.dbPort}/${config.dbName}`;
  options.connectionString = URI;
}

const pool = new Pool(options);

module.exports = pool;

En el archivo libs/sequelize.js también se puede hacer la modificación de URI cambiándola a **config.dbUrl**. Además se agregar la configuración de ssl cuando se encuentre en producción haciendo la validación correspondiente y es importante utilizar dialectOptions ya que es una configuración respectiva de postgres.

const { Sequelize } = require('sequelize');

const { config } = require('../config/config');
const setupModels = require('../db/models/');

const options = {
  dialect: 'postgres',
  logging: config.isProd ? false : true,
}

if (config.isProd) {
  options.dialectOptions = {
    ssl: {
      rejectUnauthorized: false
    }
  }
}

const sequelize = new Sequelize(config.dbUrl, options); // Se crea una instancia de Sequelize, gestiona el pooling.

setupModels(sequelize);
// sequelize.sync();

module.exports = sequelize;

En el archivo de migraciones también se deben hacer las modificaciones necesarias para poder correrlas, db/config.js:

const { config } = require('../config/config');

module.exports = {
  development: {
    url: config.dbUrl,
    dialect: 'postgres',
  },
  production: {
    url: config.dbUrl,
    dialect: 'postgres',
    dialectOptions: {
      ssl: {
        rejectUnauthorized: false,
      },
    },
  },
};

Para realizar el deploy creamos y nos movemos a una nueva rama llamada production, y después ejecutamos git push heroku production:main.

Posteriormente se corre una migración con heroku run npm run migrations:run, cabe mencionar que Heroku solo instala las dependencias de producción (no de desarrollo). Es necesario que sequelize-cli sea dependencia de producción.

Alonso Jimenez Cucanan

student•

Seria de gran ayuda que al igual que en el curso anterior a este, se realizara una clase extra para realizar el correcto deploy ya sea a Vercel o alguna otra plataforma. Actualmente Heroku tuvo muchos problemas, incluso de seguridad y ahora es de paga obligatoria. La clase esta muy buena y entretenida, sin embargo Heroku ya no es una buena opcion.

Johan Camilo Lozano Ramirez

student•

Holi a todos.

He creado un tutorial paso a paso para el despliegue de nuestra api y base de datos en Vercel. La he echo con mucho cariño y espero que les sea útil :3

https://platzi.com/tutoriales/2507-backend-nodejs-postgres/36453-despliegue-de-api-y-base-de-datos-en-vercel-nodejs-postgresql/

Todo el despliegue me ha funcionado a la perfección. Sería genial que nuestro profe creara una clase explicando de forma mas técnica el despliegue en Vercel.

Jesus Marquez Martini

student•

gracias por tu aporte, use el deploy con vercel pero me indica error por que no puedo tener mas de "12 serverless functions" en el plan gratuito

Kyb3r Cipher

student•

Excelente tutorial

Oscar Adrián Martínez Cavazos

student•

Hacer deploy es fácil decian... Hacer deploy es felicidad decian... Hacer deploy te toma 1 minuto decian...

Andres Prieto

student•

En vercel le das play y te vas a dormir unas horas; regresas y pum; ya está

Jerson Orlando Perez Arenas

student•

Y por esto es que no se hace deploy el viernes a las 5 🤣

Bryan Enrique Garay Benavidez

student•

Hola comunidad estoy haciendo el curso en 2023, como parte de la ruta de Full Stack Developer, el curso fue muy bueno, pero como Heroku es de pago tuve que ver cómo desplegarlo en otra plataforma, intenté con Vercel pero tuve problemas. Al final la más sencilla fue Render, que incluso permite crear una base de datos Postgres gratutita. ¿Podrían actualizar el curso con una clase adicional para hacer el deploy en alguna plataforma gratuita? Sería de mucha utilidad, gracias.

Henry Raúl Palomino Martínez

student•

Podrían por favor actualizar el curso así como hicieron en el anterior de backend con node.js y express.js, para realizar el despliegue en Vercel, así también poder seguir con el despliegue para los que hicimos con vercel por el tema de que Heroku ya no tiene la versión gratuita. Creo es lo único que se debe actualizar porque el resto lo he podido seguir sin problemas solo faltaría esta parte

Gonzalo Espindola

student•

Para ir aprendiendo y enfrentándome a posibles errores decidí seguir el curso haciendo una api que no sea de una tienda. En mi caso hice una API de Dragon Ball, le hice también un pequeño front con documentación. Todavía quedan muchos detalles para pulir pero aprendí mucho haciéndola.

Kevin Riquelme Valdes

student•

Por favor actualicen esta clase de deploy. El curso es excelente, es una lastima que esta parte no esté al día.

Daniel Carmona

student•

Ya no lo subi pero estoy muy feliz por el curso.

EDGAR MERCADO GARCIA

student•

Al principio no me permitia iniciar los servicios ni la pagina me aceptaba conectarse, revisando lo que le faltaba era la dependencia de sequelize. donde revise el error fue con el comando: heroku logs --tail

ANDERSON LOSADA SILVA

student•

Hola a todos,

Quisiera compartir con ustedes una guía general sobre cómo desplegar una aplicación Node.js con una base de datos PostgreSQL en la plataforma Render. Render es un servicio de alojamiento que simplifica el proceso de despliegue de aplicaciones web. Aquí están los pasos que podrían ayudarte:

Registro en Render:

Si aún no tienes una cuenta en Render, puedes registrarte en https://render.com/. 2. Creación de un Nuevo Servicio:

Inicia sesión en Render y haz clic en "Add New", luego selecciona "Web Service". 3. Configuración del Servicio:

Completa los detalles básicos del servicio, como el nombre, el entorno (Node.js), y la rama de Git si tu aplicación está en un repositorio. 4. Configuración de la Base de Datos:

Si tu aplicación utiliza PostgreSQL, puedes configurar la base de datos en la sección "Databases" de Render. 5. Configuración de Variables de Entorno:

Si tu aplicación requiere variables de entorno, configúralas en la sección "Environment" de Render. 6. Configuración de Build Command:

Especifica el comando para construir tu aplicación. Para Node.js, generalmente es "npm install" para las dependencias y "npm run build" o "npm start" para iniciar la aplicación. 7. Configuración de Puertos:

Asegúrate de que Render esté configurado para escuchar en el puerto correcto utilizado por tu aplicación. 8. Configuración de Rutas:

Si tu aplicación tiene rutas específicas, puedes configurarlas en la sección "Paths". 9. Despliegue Inicial:

Realiza un despliegue inicial haciendo clic en "Create Web Service". Render clonará tu repositorio, instalará dependencias y ejecutará los comandos de construcción. 10. Monitoreo y Logs:

Después de que la aplicación esté desplegada, verifica los logs y utiliza las herramientas de monitoreo proporcionadas por Render para asegurarte de que todo funcione correctamente. Recuerden que estos son pasos generales y los detalles pueden variar según la configuración específica de sus aplicaciones. ¡Espero que les sea de utilidad! ¿Alguna pregunta o sugerencia adicional? Estoy aquí para ayudar.

Miguel de la Rosa

student•

Starting November 28th, 2022, free Heroku Dynos, free Heroku Postgres, and free Heroku Data for Redis® will no longer be available.

Juan sebastian suarez contreras

student•

min 22:22 hasta el 22:32 hay un error de edicion

juan camilo valencia

student•

para que configuras el pool si usa sequelize?

Nicolas Molina

teacher•

El objetivo de configurar el pool es precisamente enseñar a configurar un pool sin necesidad de un ORM luego también enseñamos a hacer conexiones por medio de Sequelize, entonces tú debes elegir cuál de las dos funciona mejor para tu proyecto.

Por si acaso con Sequelize también puedes configurar un Pool

Henry Sebastian Eraso Lasso

student•

Heroku tiene soporte para base de datos MySQL?

Nicolas Molina

teacher•

Hola si existe un addon por medio de Cleardb tambien hay un servidio de Digital Ocean para Mysql

Rodrigo Ramos Xochiteotzin

student•

¿Soy el único que vio una pantalla negra del min 22:23 al 22:33?

Joalin Pineda

student•

Hola! Muchas gracias por la observación, efectivamente la clase presenta unos segundos en negro. Ya estamos atendiéndolo.

Cristopher Sahagún

student•

Si les da error la migración "role" pueden hacer lo siguiente:

async up (queryInterface) {
    const userTable = await queryInterface.describeTable(USER_TABLE);
    if(!userTable.role) {
      await queryInterface.addColumn(USER_TABLE, 'role', UserSchema.role);
    }
  },

Lo que hace es comprobar si ya existe la columna, en caso de que no exista entonces la añade :)

Deployment de Postgres en Heroku: Configuración y Migraciones

Introducción

Manejo de Bases de Datos Relacionales con Node.js y Postgres

Persistencia de Datos con Node.js y PostgreSQL usando Docker

Base de datos

Instalación de Docker en Windows, macOS y Ubuntu

Configuración de Postgres en Docker con Docker Compose

Conexión a Bases de Datos en Contenedores con Docker y PgAdmin

Conexión de Node.js a PostgreSQL usando Node PostgreSQL Driver

Manejo de conexiones con pool en Node.js y Postgres

Manejo Seguro de Variables de Entorno en Node.js

Sequelize

Introducción a ORMs con Sequelize y Node.js

Creación y Gestión de Modelos con ORM en Node.js

CRUD con ORM: Crear, Leer, Actualizar y Eliminar Datos

Conexión de ORM a MySQL usando Docker y phpMyAdmin

Migraciones

Migraciones de Bases de Datos con SQLite: Configuración Inicial

Migraciones Manuales en SQLite: Creación y Ejecución

Migraciones en SQL: Modificar Tablas y Agregar Campos

Relaciones

Relaciones uno a uno en bases de datos relacionales

Relaciones Uno a Uno y Migraciones en Bases de Datos SQL

Relaciones Uno a Muchos en Bases de Datos con SQLite

Relaciones Uno a Muchos en API Rest con SQLite

Consultas

Relaciones Muchos a Muchos en SQL: Órdenes y Productos

Relaciones Muchos a Muchos en SQLite con Tablas Ternarias

Gestión de Relaciones Muchos a Muchos en Base de Datos

Paginación de Datos con SQL: Uso de Limit y Offset

Filtros Avanzados en Consultas SQL con SQLite

Despliegue