blog | ||
djangogirls_jjas | ||
img | ||
.gitignore | ||
manage.py | ||
README.md | ||
requirements.txt |
Práctica Django Girls
📝 Tabla de contenidos
🏁 Cómo empezar
Requisitos previos
Para poder ejecutar este proyecto, necesitarás tener instalado las siguientes herramientas:
- Git
- Python
- pip
- virtualenv
El tutorial del proyecto está documentado sobre Ubuntu por lo que será el sistema operativo en el que se enfocará este repositorio.
Las instrucciones serán similares para otras distribuciones de Linux, variando únicamente en los pasos en los que se haga uso del gestor de paquetes (apt
).
-
Comenzamos actualizando la base de datos de los paquetes:
sudo apt update
-
Instalamos
git
:sudo apt install git
-
Instalamos python3, pip y virtualenv:
sudo apt install python3 python3-pip python3-venv
Entorno virtual
Para poder instalar las dependencias del proyecto sin afectar a las del sistema, se recomienda el uso de entornos virtuales:
-
Creamos un entorno virtual:
python3 -m venv myvenv
-
Activamos el entorno virtual:
source myvenv/bin/activate
-
Clonamos el repositorio y nos ubicamos en él:
git clone https://github.com/JuanJesusAlejoSillero/CETI-PPS-Practica-Django-Girls.git cd CETI-PPS-Practica-Django-Girls
-
Instalamos las dependencias del proyecto en el entorno virtual:
pip install -r requirements.txt
-
Realizamos las migraciones de la base de datos:
python manage.py migrate
-
Ejecutamos el servidor en local:
python manage.py runserver 0.0.0.0:8000 --insecure
-
Accedemos a http://127.0.0.1:8000 en nuestro navegador para ver la página:
🔧 Añadir posts
Tras el apartado anterior tendremos la web funcionando pero vacía. Para añadir contenido, primero debemos crear un usuario administrador. Pulsamos Ctrl + C
para detener el servidor y ejecutamos el siguiente comando (la contraseña no será visible mientras la escribimos):
python manage.py createsuperuser
Ejecutamos el servidor de nuevo:
python manage.py runserver 0.0.0.0:8000 --insecure
Y accedemos a http://127.0.0.1:8000/admin para iniciar sesión con el usuario que acabamos de crear:
Una vez dentro, podemos crear nuevos posts:
Debemos asegurarnos de que tenga fecha de creación y publicación anterior a la actual, de lo contrario no aparecerá en la página principal:
Tras crear un par de ellos, podemos verlos en la página principal:
Si nos fijamos en la esquina superior derecha veremos que podremos editarlo, y también crear otro nuevo:
🚀 Despliegue
Para desplegar este proyecto, usaremos PythonAnywhere para alojar la página y se asume que ya contamos con un repositorio de GitHub para almacenar el código.
-
Creamos una cuenta en PythonAnywhere, con el plan gratuito es suficiente.
-
Tras crearla, accedemos a nuestro panel de cuenta y creamos un Token para la API:
-
Una vez que tengamos el token, vamos al dashboard de la página principal y seleccionamos la opción de crear una nueva consola de Bash:
-
En ella, ejecutamos el helper de PythonAnywhere:
pip3 install --user pythonanywhere
-
Una vez veamos el mensaje de que se ha instalado correctamente, ejecutamos el siguiente comando para clonar nuestro repositorio:
pa_autoconfigure_django.py https://github.com/<usuario>/<repositorio>.git
-
Al finalizar, nos indicará que nuestra web está disponible en <https://<usuario>.pythonanywhere.com>.
-
Para poder acceder a la página de administración, debemos crear un superusuario igual que hicimos en local en el apartado anterior:
python manage.py createsuperuser
-
Al igual que el usuario administrador no se ha creado automáticamente, tampoco lo harán los posts. Para ello, seguimos los mismos pasos que antes.
-
Una vez creados, podremos verlos en la página principal de <https://<usuario>.pythonanywhere.com>, el panel de administración se encontrará en <https://<usuario>.pythonanywhere.com/admin>.
⛏️ Hecho con
- 📖 Tutorial: Django Girls
- 🌐 Hosting: PythonAnywhere
- 📦 Repositorio para el código fuente: GitHub