Este documento le ayudará a tener Django instalado y funcionando.
\nDjango es un framework web de Python. Visite ref:faq-python-version-support para más detalles.
\nObtenga la última versión de Python en https://www.python.org/download/ o con el administrador de paquetes de su sistema operativo.
\n\nmod_wsgiLink to this heading#Si solo desea experimentar con Django salte a la siguiente sección; Django incluye une servidor web ligero que puede utilizar para testing, así que no será necesario configurar Apache hasta que esté listo para hacer el despliegue de Django en producción.
\nSi desea usar Django en un sitio en producción, utilice Apache con mod_wsgi. mod_wsgi opera en uno de dos modos: modo embebido o modo daemon. En el modo embebido, mod_wsgi es similar a mod_perl: incrusta Python dentro de Apache y carga el código Python en memoria cuando el servidor se inicia. El código permanece en memoria durante la vida del proceso de Apache, lo que conduce a mejoras significativas de rendimiento frente a otras configuraciones de servidor. En el modo daemon, mod_wsgi genera un proceso daemon independiente que se encarga de manejar las peticiones. Este proceso daemon puede ejecutarse como un usuario diferente al del servidor web, lo que puede mejorar la seguridad. Además, el proceso daemon puede reiniciarse sin necesidad de reiniciar todo el servidor web Apache, lo que facilita la actualización de la base de código. Consulte la documentación de mod_wsgi para determinar qué modo es el más adecuado para su configuración. Asegúrese de tener Apache instalado con el módulo mod_wsgi activado. Django funcionará con cualquier versión de Apache que sea compatible con mod_wsgi.
\nVisite How to use Django with mod_wsgi para obtener más información sobre como configurar mod_wsgi una vez lo instale.
\nSi no puede usar mod_wsgi por alguna razón, no tema: Django tiene soporte para otras opciones de despliegue, Una es uWSGI la cual funciona muy bien con nginx. Adicionalmente, Django sigue la especificación WSGI (PEP 3333), lo que le permite ejecutarse en una variedad de plataformas de servidores.
\nSi planea usar las funcionalidades que ofrece la API de bases de datos de Django, entonces necesitará estar seguro de que un servidor de bases de datos esté en ejecución. Django admite muchos tipos diferentes de servidores de base de datos y tiene soporte oficial con PostgreSQL, MariaDB, MySQL, Oracle y SQLite.
\nSi está desarrollando un proyecto pequeño o algo que no planea desplegar en un entorno de producción, SQLite es generalmente la mejor opción dado que no requiere ejecutar un servidor por separado. Sin embargo, SQLite tiene muchas diferencias con otras bases de datos, por lo que si está trabajando en algo sustancial, se recomienda desarrollar con la misma base de datos que planea usar en producción.
\nAdemás de las bases de datos con soporte oficial, existen :ref:`backends ofrecidos por terceros <third-party-notes> ` que le permiten utilizar otras bases de datos con Django.
\nPara utilizar una base de datos diferente a SQLite , deberá asegurarse de que estén instaladas las bibliotecas de enlace de Python correspondientes para la base de datos.
\nSi está utilizando PostgreSQL, necesitará el paquete psycopg o el psycopg2. Visite PostgreSQL notes para más detalles.
Si está utilizando MySQL o MariaDB, necesitará un DB API driver como mysqlclient. Visite notes for the MySQL backend para más detalles.
Si utilizá SQLite quizá desee leer SQLite backend notes.
Si está usando Oracle, necesitará instalar oracledb, por favor lea antes las notas para el backend de Oracle para más detalles sobre el soporte de versiones tanto de Oracle como de oracledb.
Si está usando algún backend no oficial de terceros, por favor consulte la documentación provista para otros requisitos adicionales.
Y asegúrese de que las siguientes claves en el item ``”default”` del diccionario DATABASES coincidan con sus configuraciones de conexión de base de datos.
ENGINE – bien sea 'django.db.backends.sqlite3', 'django.db.backends.postgresql_psycopg2', 'django.db.backends.mysql', o 'django.db.backends.oracle'. Otros backends también están disponibles.
NAME – El nombre de tu base de datos. Si utiliza SQLite, la base de datos será un archivo en su ordenador. En ese caso, NAME deberá ser la ruta absoluta completa, incluyendo el nombre del archivo. No necesita crear nada de antemano; el archivo de la base de datos se creará automáticamente cuando sea necesario. El valor por default, BASE_DIR / 'db.sqlite3', guardará el archivo en el directorio de su proyecto.
Si planea utilizar el comando manage.py migrate para automáticamente crear las tablas de la base de datos para sus modelos (después de haber instalado Django y creado un proyecto), se tendrá que asegurar de que Django tenga permiso de crear y alterar tablas en la base de datos que esté utilizando; si planea crear manualmente las tablas , puede también dar a Django permisos de SELECT, INSERT, UPDATE y` DELETE` . Después de crear un usuario en la base de datos con estos permisos, usted especificará estos detalles en el archivo settings del proyecto, visite DATABASES para más detalles.
Si utiliza el testing framework de Django para probar queries a la base de datos, Django necesitará permiso para crear una base de datos de prueba.
\nInstallation instructions are slightly different depending on whether you’re\ninstalling a distribution-specific package, downloading the latest official\nrelease, or fetching the latest development version.
\npipLink to this heading#This is the recommended way to install Django.
\nInstall pip. The easiest is to use the standalone pip installer. If your\ndistribution already has pip installed, you might need to update it if\nit’s outdated. If it’s outdated, you’ll know because installation won’t\nwork.
Take a look at venv. This tool provides\nisolated Python environments, which are more practical than installing\npackages systemwide. It also allows installing packages without\nadministrator privileges. The contributing tutorial walks through how to create a virtual environment.
After you’ve created and activated a virtual environment, enter the command:
\nLinux / macOS
$ python -m pip install Django\nWindows
...\\> py -m pip install Django\nCheck the distribution specific notes to see if\nyour platform/distribution provides official Django packages/installers.\nDistribution-provided packages will typically allow for automatic installation\nof dependencies and supported upgrade paths; however, these packages will\nrarely contain the latest release of Django.
\nIf you’d like to be able to update your Django code occasionally with the\nlatest bug fixes and improvements, follow these instructions:
\nMake sure that you have Git installed and that you can run its commands\nfrom a shell. (Enter git help at a shell prompt to test this.)
Check out Django’s main development branch like so:
\nLinux / macOS
$ git clone https://github.com/django/django.git\nWindows
...\\> git clone https://github.com/django/django.git\nThis will create a directory django in your current directory.
Make sure that the Python interpreter can load Django’s code. The most\nconvenient way to do this is to use a virtual environment and pip. The\ncontributing tutorial walks through how to\ncreate a virtual environment.
After setting up and activating the virtual environment, run the following\ncommand:
\nLinux / macOS
$ python -m pip install -e django/\nWindows
...\\> py -m pip install -e django\\\nThis will make Django’s code importable, and will also make the\ndjango-admin utility command available. In other words, you’re all\nset!
When you want to update your copy of the Django source code, run the command\ngit pull from within the django directory. When you do this, Git will\ndownload any changes.