Guía de despliegue de Heroku

febrero 06, 2024
Available in English

En esta guía, se revisan los pasos para desplegar una aplicación en Heroku usando la CLI de Heroku.

Si no tiene una cuenta Heroku o si aún no ha instalado la CLI de Heroku, consulte Cómo instalar la CLI de Heroku antes de continuar.

Configuración del proyecto

Probablemente ya haya desplegado una aplicación front end en una plataforma como GitHub Pages. Pero para desplegar una aplicación con un back end, necesitará una plataforma como Heroku que pueda manejar la configuración adicional para que su aplicación pueda aceptar conexiones entrantes de Internet.

Para comenzar, asegúrese de que su proyecto esté inicializado como un repositorio de Git. Puede verificar esto ejecutando el siguiente comando en la raíz de su proyecto:

git status

Si encuentra un error, significa que su proyecto aún no es un repositorio de Git. Puede inicializar el repositorio ejecutando el siguiente comando:

git init

Las aplicaciones que cuentan con un back end de Express.js pueden usar la variable de entorno PORT de Heroku. Para configurar eso, cree una variable port con un valor de process.env.PORT. También puede agregar un valor predeterminado para las instancias locales de su servidor utilizando la sintaxis “||”, como se muestra en el siguiente ejemplo:

const port = process.env.PORT || 3001

Ahora que hemos creado el repositorio y configurado el servidor, podemos crear una aplicación en Heroku sin siquiera abrir el navegador.

Crear una aplicación Heroku

La CLI de Heroku es una utilidad que sirve para crear y administrar sus aplicaciones web alojadas de forma remota. Puede usarla para crear fácilmente una aplicación Heroku una vez que haya configurado el repositorio que desea desplegar.

Cree una nueva aplicación Heroku ejecutando el siguiente comando en la raíz de su proyecto:

heroku create

Nota La CLI de Heroku generará aleatoriamente un nombre de aplicación, pero puede especificar un nombre usando la sintaxis heroku create <app name>.

Una vez que haya creado la aplicación, puede ejecutar git remote -v para verificar que la CLI de Heroku haya agregado la URL remota de Heroku, como se muestra en el siguiente ejemplo:

git remote -v

heroku  https://git.heroku.com/<heroku-app-name>.git (fetch)
heroku  https://git.heroku.com/<heroku-app-name>.git (push)

La URL remota se agrega automáticamente a su repositorio de Git sin necesidad de comandos adicionales, lo cual es muy bueno. Ahora puede prepararse para el despliegue.

Desplegar en Heroku 🚀

¡Es hora de desplegar su aplicación! El despliegue permite que otros desarrolladores le brinden comentarios más detallados y permite que usted exhiba las últimas características en su aplicación.

Primero, debe agregar y guardar todos los archivos de su proyecto y luego enviarlos a Heroku, de la siguiente manera:

git add -A
git commit -m "Pushing to Heroku"
git push heroku main

Para confirmar que la aplicación se desplegó correctamente, visite la URL de la aplicación proporcionada en la terminal. A veces, el resultado indicará que la compilación fue exitosa, pero aún debe abrir su aplicación en el navegador para verificarlo, como se muestra en el siguiente ejemplo:

remote: -----> Build succeeded!
remote: -----> Discovering process types
remote:        Procfile declares types     -> (none)
remote:        Default types for buildpack -> web
remote:
remote: -----> Compressing...
remote:        Done: 33.8M
remote: -----> Launching...
remote:        Released v9
remote:        https://lit-retreat-65972.herokuapp.com/ deployed to Heroku

Nota También puede ejecutar heroku open para abrir automáticamente la página web.

Resolución de problemas

A veces, los errores en su aplicación no serán evidentes desde la terminal. En ese caso, puede ver los registros de Heroku ejecutando el siguiente comando:

heroku logs --tail

Nota Salga del resultado del registro presionando Ctrl+C.

Puede utilizar el siguiente comando para acceder a la línea de comando del contenedor remoto que ejecuta su aplicación:

heroku run bash

¡Felicitaciones por desplegar su primera aplicación con un servidor en Heroku! Se podrá acceder al enlace siempre que su aplicación exista en Heroku. Dicho esto, Heroku abre un nuevo contenedor para ejecutar su aplicación después de un período prolongado de inactividad, así que tenga paciencia si tarda más de lo habitual en cargarse.

Si encuentra problemas, recuerde que el despliegue rara vez ocurre sin problemas. Los errores de descifrado y la lectura de la documentación son partes clave del proceso de despliegue.

Recursos

Heroku ofrece numerosos recursos útiles que puede consultar a lo largo de este proyecto. También puede encontrar otras características de Heroku para usar en proyectos futuros. Visite los siguientes enlaces para complementar esta guía:

Category: heroku

Tagged under: heroku, deployment, guide,