Instalación y Configuración de Django

Instalación y Configuración de Django

¿Qué es Django?

Django es un framework de backend basado en Python que facilita el desarrollo rápido y seguro de aplicaciones web. Esta guía te mostrará paso a paso cómo instalarlo, configurarlo en tu computadora o en un servidor, y resolver problemas comunes.

+ info: documentación

Instalación Entorno de Producción

Instalación Entorno de Pruebas Locales

Instalar Python

¿De qué trata?

¿Cómo instalar?

¿De qué trata?

crear Primer Proyecto Django

Instalar Django

Configurar Base de Datos

Comenzar

¿Cómo hacerlo?

¿Como instalarlo?

Problemas comunes

Diferencias Local vs Producción

¿Cual es mejor?

¿Cuales son?

Recursos adicionales: Video de instalación Django

Entorno de Pruebas Locales

1. Django incluye un servidor web ligero integrado → suficiente para desarrollo.
2. No necesitas instalar Apache, Nginx ni mod_wsgi.
3. Ideal para:
4. Aprender Django.
5. Probar nuevas funcionalidades.
6. Desarrollo rápido en tu propia PC.

Configuración mínima

Comando: python manage.py runserver Correr en: URL por defecto: http://127.0.0.1:8000 Tip: Usa siempre un entorno virtual (venv) para evitar conflictos de dependencias.

Instalación de python

1. Django requiere Python (3.10+ recomendado).
2. Descárgalo en python.org/downloads
3. Si usas Windows, consulta la guía: “Cómo instalar Django en Windows”.
4. En Linux/Mac, usa el gestor de paquetes de tu sistema.

Entorno de Producción

Para sitios en línea o aplicaciones con usuarios reales, necesitas un servidor web robusto. Opción recomendada: Apache + mod_wsgi Modo integrado: Python incrustado en Apache (alto rendimiento). Modo demonio: proceso independiente → mayor seguridad, reiniciable sin apagar Apache.

Consideraciones extra en producción:

1. Desactivar DEBUG.
2. Configurar ALLOWED_HOSTS.
3. Optimizar base de datos y cachés.
4. Configurar logs y seguridad.

Enlace útil: Cómo usar Django con mod_wsg https://docs.djangoproject.com/en/5.2/howto/deployment/wsgi/modwsgi/

Alternativas: uWSGI + Nginx → muy usado en grandes proyectos. Cualquier servidor compatible con WSGI (PEP 3333).

Instalar Django

Versión oficial con pip (recomendada):

Paquete específico de distribución: útil si tu sistema lo provee.

• python -m venv venv
• source venv/bin/activate # Linux/Mac
• venv\Scripts\activate # Windows
• python -m pip install Django

Versión de desarrollo (con Git):

• git clone https://github.com/django/django.git
• python -m pip install -e django/

Primer Proyecto Django

Pasos

1. Crear proyecto: django-admin startproject mi_proyecto cd mi_proyecto

5. Ejecutar servidor: python manage.py runserver

2. Migrar base de datos inicial: python manage.py migrate

4. Abrir navegador en: http://127.0.0.1:8000

Configurar base de datos

Ejemplo configuración en settings.py:DATABASES = { 'default': { 'ENGINE': 'django.db.backends.postgresql', 'NAME': 'mi_base', 'USER': 'usuario', 'PASSWORD': 'password', 'HOST': 'localhost', 'PORT': '5432', } }

Bases de datos compatibles: SQLite (ideal para pruebas y proyectos pequeños). PostgreSQL, MySQL/MariaDB, Oracle (para producción). Para PostgreSQL necesitas psycopg2, para MySQL mysqlclient, para Oracle oracledb.

Diferencias Local vs Producción

Producción:Apache/Nginx + mod_wsgi/uWSGI. Base de datos externa (PostgreSQL/MySQL). DEBUG=False, configurar ALLOWED_HOSTS. Manejo de usuarios y permisos. ✅ Requiere servidor web robusto: Apache/Nginx con mod_wsgi o uWSGI. ✅ Se recomienda base de datos externa: PostgreSQL, MySQL o MariaDB. ✅ DEBUG=False → evita mostrar errores al usuario. ✅ Configuración de seguridad: ALLOWED_HOSTS, HTTPS, permisos.

Local: Servidor integrado. Base de datos SQLite. DEBUG=True. ✅ Usa el servidor integrado de Django → no requiere Apache o Nginx. ✅ Base de datos ligera por defecto: SQLite. ✅ DEBUG=True → muestra errores detallados para facilitar la depuración. ❌ No recomendado para usuarios reales → bajo rendimiento y poca seguridad.

Problemas comunes

Problemas:

• django-admin no encontrado → activa el entorno virtual.
• Error en migraciones → ejecuta python manage.py migrate.
• Servidor no arranca en producción → revisa logs y ALLOWED_HOSTS.
• Conexión a base de datos rechazada → revisa credenciales y permisos.