Intro: English
Title: Initial setup of my own Django project using the django_base repository
Language: Spanish / Español
This is a step-by-step guide about how to configure a new Django project using the django_base repository. Previously I have added a detailed tutorial in Spanish about how was made this repository, and ecoinstant has translated it to English. You can find English tutorial here. In this tutorial we will study how to setup a new Django project quickly with Docker, Postgresql, Boostrap and Jquery, basic requirements for a lot of new project, using de django_base reopsitory and adapting it to our own project.
Hace unos días he creado el repositorio django_base, con el fin de proveer una forma sencilla de iniciar un nuevo proyecto Django utilizando Docker, PostgreSQL, Bootstrap 4 y Jquery en muy poco tiempo. Unos días después escribí un tutorial describiendo los pasos que seguí para construir este repositorio. En este tutorial voy a hablar sobre los pasos que debemos seguir para configurar nuestro propio proyecto Django después de clonar este repositorio. Es imporante tener en cuenta que debemos tener previamente Docker instalado y corriendo en nuestro computador.
Los comandos usados en la terminal se ejecutan para sistema operativo OSX o Linux.
1. Descargar el repositorio
Para clonar el repositorio, activamos una terminal y corremos el siguiente comando:
git clone https://github.com/roadhousestudio/django_base.git
2. Cambiar nombre del proyecto
Después del clonar el repositorio, podemos ver que la carpeta descargada se llama django_base. Lo primero que debemos hacer es cambiar el nombre de esta carpeta por el nombre que tendrá nuestro proyecto. Desde la terminal podemos cambiar el nombre de una crpeta con el siguiente comando:
mv django_base my_project
Así, el nuevo nombre para la carpeta será my_project.
3. Eliminar configuración de git
Cuando clonamos un repositorio utilizando git, clonamos los archivos de configuración del proyecto. COmo lo más probable es que debamos crear un nuevo repositorio para nuestro proyecto, estos archivos deben ser eliminados. Primero, en la terminal nos ubicamos en la raíz del proyecto con el siguiente comando:
cd my_project
Ejecutando el comando ls -la podremos ver todo el contenido del proyecto:
ls - la
Para eliminar la configuración de git, debemos eliminar la carpeta .git con el siguiente comando:
rm -rf .git/
4. Configurar servicios de Docker
Ahora debemos editar el nombre de las imagenes de los servicios que estamos activando en Docker. Para hacerlo, editamos el archivo docker-compose.yml, que actualmente se debe ver así:
Cambiamos el nombre del parametro image en el servicio web y en la migración de 'djangobase' a myproject. Yo siempre uso el mismo nombre de la carpeta principal del repositorio, removiendo simplemente los caractares que no sean letras (no uso my_project sino my_project).
5. Construir y levantar el contenedor Docker
Ahora debemos construir el contenedor Docker. A menos que modifiquemos los archivos Dockerfile o requirements.txt, solo es necesario correr el siguiente comando una vez.
docker-compose build
Este comando creará una imagen con los requerimientos indicado en el archivo Dockerfile e instalará las librerías Python listadas en el archivo requirements.py.
Si hacemos alguna modificación en el archivo Dockerfile, debemos correr el siguiente comando:
docker-compose --no-cache
Si modificamos el archivo requirements.txt, solo debemos correr de nuevo docker-compose build.
Una vez construido el contenedor, debemos levantarlo ejecutando el siguiente comando:
Docker-compose up
Una vez levantado el contenedor, podemos visitar la página del inicio del proyecto en la siguiente url localhost:8000.
Y esto es todo!!!. Ya tenemos la configuración necesaria para seguir trabajando en nuestro propio proyecto Django a partir del código del repositorio django_base. Seguiré citando este tutorial en próximos tutoriales en los que necesitemos un ambiente de Django corriendo listo para implementar mas funcionalidades.
Durante la creación de este tutorial si hizo una actualización de librerias Python al repositorio.
Felices días ✌
Posted on Utopian.io - Rewarding Open Source Contributors