22
Desarrollo y deploy de un proyecto en Django con PostgreSQL en Heroku
Realizar este simple tareas a veces se vuelven algo complejas y confusas, ya que la tecnología es un medio constantemente, en cambio, por lo cual hay que lidiar con varias versiones de estas herramientas. Pero aquí presento un pequeño guía de como lidiar con ello.
Para empezar debemos prepara nuestro entorno de trabajo. Para lo cual vamos a tipear los siguientes comando en la terminal.
Nota: Estoy usando una terminal de Ubuntu con WSL.
Instalamos python y su gestor de paquetes.
sudo apt-get install python3 python3-pip
Luego instalamos la línea de comandos de Heroku.
curl https://cli-assets.heroku.com/install.sh | sh
Por último y no menos importante, vamos a instalar la línea de comando de Django para tareas Administrativas.
python3 pip3 install django-admin
Si en la instalación de este último, no se encuentra el comando django-admin, se es necesario agregar la ruta del script al $PATH de la terminal.
export PATH="/home/[user]/.local/bin:$PATH"
# Cambiar la variable '[user]' por el nombre correspondiente de su nombre de usuario de la pc.Ok, ya hemos instalado todas dependencias necesarias en nuestro entorno de trabajo.
Instalamos PostgreSQL y dependencias para trabajar con django.
sudo apt-get install postgresql python-dev libpq-dev
Configuramos la contraseña del usuario postgres y cambiar a dicho usuario.
passwd postgres
# Ingresa la contraseña cuando te lo pida.
su postgresCreamos la base de datos y su usuario correspondiente, ademas de establecer su contraseña.
createdb [django]
createuser [django]
psql
ALTER USER [django] WITH PASSWORD '[anytoken]';
# Cambiar las variable '[django]' y '[anytoken]' por cualquier valor correspondiente.
Ahora vamos a crear nuestro proyecto con django-admin, con el siguiente comando.
django-admin startproject [django_postgres]
cd [django_postgres]
# Cambiar la variable '[django_postgres]' por el nombre real de tu proyecto.el cual nos va a generar los archivos base de un proyecto a desarrollar con django.
django_postgres
|-- django_postgres
| |-- __init__.py
| |-- asgi.py
| |-- settings.py
| |-- urls.py
| |-- wsgi.py
|-- manage.pyPara tener un entorno controlado y no tener problemas con dependencias externas, creamos un entorno virtual con python usando el siguiente comando.
python3 -m venv venv
source venv/bin/activate# En caso de querer desactivar el entorno virtual, se es necesario usar el siguiente comando.
(venv) deactivateDjango, es la librería central de la app y su dependencia principal.
(venv) pip3 install Django
Psycopg2, no permite conectarnos a cualquier motor de base de datos, y por lo tanto debemos instalarlo para poder conectarnos con nuestra base de datos con PostgreSQL.
(venv) pip3 install psycopg2
(venv) pip3 install gunicorn
(venv) pip3 install django-heroku
Conectar nuestro proyecto con la base de datos de forma local, debemos establecer las credenciales, que se gestiono anteriormente en el archivo django_postgres/settings.py
# django_postgress/settings.py
...
# Database
# https://docs.djangoproject.com/en/3.0/ref/settings/#databases
DATABASES = {
'default': {
'ENGINE': 'django.db.backends.postgresql_psycopg2',
'NAME': '[django]',
'USER': '[django]',
'PASSWORD': '[anytoken]',
'HOST': 'localhost',
'PORT': '5432'
}
}
...
# Cambiar las variable '[django]' y '[anytoken]' por cualquier valor correspondiente.Comprobamos el correcto funcionamiento del proyecto hasta ahora.
(venv) python3 manage.py runserver
Lo que nos dará como resultado al visitar la siguiente link.
Django nos ofrece una administración por defecto, la cual para acceder a ellas, tendremos que crear un usuario.
(venv) python3 manage.py createsuperuser
# Ingrese los datos que le pida el programa.Ya realizado la operación anterior con éxito, nos dirigiremos al siguiente link.
Ingresamos nuestras credenciales.
y vualá, ya tenemos nuestra administración funcionando.
Llegamos a la mejor parte, donde nuestro trabajo sera accesible al publico. Para ello necesitamos modificar el proyecto para producción, y crear los archivos necesario para hacer el deploy en Heroku.
Lo primero que debemos hacer es volcar todas las dependencias de librerías que usa nuestro proyecto en un archivo requirements.txt, con la ayuda del manejador de paquetes Python pip.
(venv) pip3 freeze > requirements.txt
Cual es el motivo para hacer esto, bueno muy sencillo, heroku necesita instalar las dependencias poder correr el proyecto en un dyno (así se denomina los contenedores en heroku).
Nota: En algunas ocasiones, se puede presentar un error con la librería pkg-resource, por lo que en tal caso se debe eliminar del requirements.txt
# requirements.txt
...
dj-database-url==0.5.0
Django==3.0.4
django-heroku==0.3.1
gunicorn==20.0.4
--pkg-resources==0.0.0
psycopg2==2.8.4
pytz==2019.3
sqlparse==0.3.1
...Luego, vamos a modificar nuestro archivo django_postgres/settings.py, y así prepara nuestro proyecto para producción, cambiando algunas variables globales.
El primer cambio va hacer agregar la librería django_heroku, para que se encargue de gestionar las variables globales.
# django_postgress/settings.py
...
import os
+++ import django_heroku
...# Al final del archivo.
...STATIC_URL = '/static/'+++ django_heroku.settings(locals())
...El siguiente cambio va hacer, cambiar el comportamiento del proyecto a producción, para ellos necesitamos cambiar la variable global DEBUG = False.
# django_postgress/settings.py
...
# SECURITY WARNING: don't run with debug turned on in production!
+++ DEBUG = False
...Otro archivo que tenemos que modificar es el archivo de rutas django_postgres/urls.py, al cual por conceptos de no extender tanto esta guía, vamos a usar como pages de inicio o index la misma que trae por defecto django en desarrollo. Ya que django en producción oculta dicha vista.
# django_postgress/urls.py
...from django.contrib import admin
from django.urls import path
+++ from django.views import debug
urlpatterns = [
path('admin/', admin.site.urls),
+++ path('', debug.default_urlconf)
]
...En este antepenúltimo paso, vamos a crear los archivos necesario para hacer el deploy, para ello vamos crear dos archivos más Procfile y runtime.txt.
Procfile, contiene los comando necesario para ejecutar el proyecto y herramientas.
# Procfile
...web: gunicorn django_postgres.wsgi --log-file -
release: python3 manage.py migrate...El primer comando web, ejecuta el proyecto. El segundo release ejecuta la migración hacia la base de datos de PostgreSQL en Heroku.
runtime.txt, le especifica a Heroku que versión de Python debe ejecutar el código Python para mantener su integridad.
# runtime.txt
...python-3.6.9
...Por ultimo, llegamos al deploy en Heroku. Para ello necesitamos tener creado una cuenta en Heroku.
Ya teniendo creada una cuenta en Heroku, procedemos a crear un app en Heroku, lo podremos hacer por medio del panel de control de la interfaz de Heroku, o por medio de su linea de comando.
Para lo cual vamos a iniciar sesión en la linea de comando de Heroku, de la siguientes manera.
(venv) heroku login
Luego vamos a crear nuestra app.
(venv) heroku create --app [django_postgres]
# Cambiar las variable '[django_postgres] por el nombre de tu proyecto.Heroku usa Git para administra las implementaciones de aplicaciones, para lo cual necesitamos inicializar un repositorio local con Git.
(venv) git init
Ahora debemos agregar un archivo .gitignore para ignorar los archivos de cache que genera python de forma automática y las dependencias venv.
(venv) echo 'venv/\n.py[cod]\n' > .gitignore
Creamos nuestro primer commit.
(venv) git add .
(venv) git commit -m 'Primer commit'Agregar el repositorio remoto a Git para hacer el push a Heroku.
(venv) heroku git:remote --app [django_postgres]
# Cambiar las variable '[django_postgres] por el nombre de tu proyecto.Ahora realizamos el push a Heroku.
(venv) git push heroku master
Este sera el resultado, el deploy del proyecto.
Para abrir el proyecto al navegador desde la terminal, solo debemos ejecutar el siguiente comando.
(venv) heroku open
22