Меню Рубрики

Установка django из архива

Блог на Django #1: Установка Django 2.0

  • Если Django уже установлен, можете пропустить этот раздел и переходить к части «Создание первого проекта». Django — это пакет Python, поэтому он может быть установлен в любой среде Python. Вот как установить фреймворк для локальной разработки.
    Для Django 2.0 обязательны Python 3.4 или старше. Дальше будет использоваться Python 3.6.5. Для Linux или macOS, то Python, вероятно уже установлен. Если Windows — то инструкция по установке здесь.

    Проверить установлен ли Python на компьютере можно, введя python в командной строке. Если в ответ отобразится что-то подобное, то Python установлен:

    Если он не установлен или установлена версия Python 3.4 или младше, то нужно перейти в раздел “Скачать и установить Python”, найти руководство под свою OS и следовать инструкциям.

    Для Python 3 не нужна база данных. Эта версия Python поставляется со встроенной базой данных SQLite. Это облегченная база данных, которая подходит для разработки на Django. Если же нужно будет разворачивать приложение в производственной среде, то понадобится более продвинутое решение: PostgreSQL, MySQL или Oracle. Больше узнать о том, как заставить базу данных работать с Django, можно по этой ссылке: https://docs.djangoproject.com/en/2.0/topics/install/#database-installation.

    Создание виртуальной среды Python

    Рекомендуется использовать virtualenv для создания виртуальной среды Python так, чтобы можно было спокойно использовать разные версии пакетов для разных проектов. Это практичнее, чем устанавливать пакеты в Python напрямую в систему. Еще одно преимущество virtualenv — для установки пакетов Python не нужны права администратора. Запустите следующую команду в командной строке для установки virtualenv :

    После установки virtualenv , создайте виртуальную среду с помощью следующей команды:

    Это создаст папку my_env вместе со средой Python. Любые библиотеки Python, установленные с активированной виртуальной средой Python, будут установлены в папку my_env/lib/python3.7/site-packages .

    Если в системе была предустановлена Python 2.X, а вы установили Python 3.X, то нужно указать virtualenv , чтобы он работал с последней версией.

    Можно указать путь, по которому установлен Python 3 и использовать его для создания виртуальной среды с помощью следующих команд:

    Используйте следующую команду для активации виртуальной среды:

    Командная строка будет включать название активной виртуальной среды в скобках:

    Отключить виртуальную среду можно с помощью команды deactivate .

    Больше о virtualenv можно узнать по ссылке https://virtualenv.pypa.io/en/latest/.

    Поверх virtualenv можно также использовать virtualenvwrapper . Этот инструмент предоставляет оболочки, с помощью которых проще создавать и управлять виртуальной средой. Загрузить его можно здесь: https://virtualenvwrapper.readthedocs.io/en/latest/.

    Установка Django с помощью pip

    Система управления пакетами pip — рекомендуемый способ установки Django. В Python 3.6+ она предустановлена, а инструкции для установки можно найти по ссылке https://pythonru.com/baza-znanij/ustanovka-pip-dlja-python-i-bazovye-komandy.

    Используйте следующую команду в оболочке, чтобы установить Django с помощью pip:

    Django установится в папку Python под названием site-packages/ активной виртуальной среды.

    Теперь нужно проверить, успешно ли прошла установка. Для этого в командной строке необходимо ввести python , импортировать Django и проверить его версию следующим образом:

    Если вывод такой, как вверху, значит Django был успешно установлен на компьютере:

    источник

    Документация Django 1.7

    Этот документ призван проинструктировать вас о том, как получить и запустить Django.

    Установка Python¶

    Изначально написанный на Python, Web-фреймворк Django требует установки самого Python. Подойдет Python 2.7, 3.2 или 3.3.

    Последнюю версию Python можно скачать на http://www.python.org/download/ или используя системный пакетный менеджер.

    Если вы используете Jython (реализация языка Python на языке Java), вам необходимо пройти несколько дополнительных шагов. См. Запускаем Django на Jython для получения более подробной информации.

    Если вы только начали изучать Django и используете Windows, советуем почитать How to install Django on Windows.

    Установка Apache и mod_wsgi¶

    Если вы просто хотите поэкспериментировать с Django, пропустите этот раздел и перейдите к следующему; Django включает в себя легковесный web-сервер, предназначенный для тестирования, поэтому вы вправе не устанавливать Apache до тех пор, пока ваш проект не будет готов для развёртывания на “боевом”-сервере.

    Если вам нужно использовать Django на публичном, производственном сайте, используйте Apache и mod_wsgi ; mod_wsgi может работать в одном из двух режимов: во встроенном режиме и в режиме демона. Во встроенном режиме mod_wsgi очень похож на mod_perl – он “встраивает” Python в Apache и загружает код Python в память при запуске сервера. Код остаётся в памяти в течение жизни процесса Apache, что даёт значительный рост производительности по сравнению с другими механизмами. В режиме демона mod_wsgi порождает независимый процесс-демон, который обрабатывает запросы. Процесс-демон может работать от имени различных пользователей Web-сервера, что может весьма повысить уровень безопасности. Кроме того, процесс-демон может быть перезапущен без останова и перезапуска самого Apache. Обратитесь к документации mod_wsgi, чтобы определить какой режим подходит вам в большей степени. Убедитесь, что Apache установлен и модуль mod_wsgi активирован. Django будет работать с любой версией Apache, которая имеет поддержку mod_wsgi.

    См. Использование Django и mod_wsgi для получения информации о настройке mod_wsgi сразу после того, как он будет установлен.

    Если по какой-либо причине вы не можете использовать mod_wsgi, не волнуйтесь: Django поддерживает множество других вариантов развёртывания. Один из них – uWSGI; он отлично работает с nginx . Дополнительно Django следует WSGI спецификации (PEP 3333), которая позволяет ему работать на различных серверных платформах.

    Читайте также:  Установка программного обеспечения для сервера

    Создание рабочей базы данных¶

    Если вы планируете использовать функционал API баз данных Django, вам нужно удостовериться, что сервер баз данных запущен. Django поддерживает много различных СУБД. В частности к ним относятся PostgreSQL, MySQL, Oracle и SQLite.

    Если вы заняты разработкой простого проекта или чего-то, что вы не планируете развернуть в производственной среде, SQLite в целом является наипростейшим вариантом, поскольку он вообще не требует установки отдельного веб-сервера. Однако, SQLite очень отличается от других баз данных, поэтому, если вы работаете над чем-то существенным, рекомендуется выбрать ту же базу данных, которая будет использована на “боевом” сервере.

    В дополнение к официально поддерживаемым базам данных есть бэкэнды, поставляемые третьими сторонами, которые позволяют использовать другие БД с Django.

    В дополнение к установке необходимой БД вы также должны убедиться, что вами выбран и установлен соответствующий модуль Python.

    При использовании PostgreSQL, вам понадобится пакет postgresql_psycopg2. Вы можете обратиться к PostgreSQL notes для получения дальнейших инструкций, специфичных для этой БД.

    Пользователям Windows следует проверить наличие неофициальной скомпилированной для Windows версии.

    При использовании MySQL, вам понадобится пакет MySQL-python версии 1.2.1p2 или выше. Вы также можете получить инструкции, специфичные для этой БД.

    Если вы используете SQLite, вам следует прочитать про особенности использования SQLite.

    При использовании Oracle, вам понадобится копия cx_Oracle, но, пожалуйста, обязательно ознакомьтесь с инструкцией notes for the Oracle backend , которая содержит информацию о поддерживаемых версиях Oracle и cx_Oracle .

    При использовании неофициальных бэкендов от сторонних разработчиков смотрите соответствующую документацию о дополнительных требованиях.

    Если вы планируете использовать команду manage.py migrate для автоматической генерации таблиц БД для ваших моделей (после первого запуска Django и создания проекта), вам нужно убедиться, что Django имеет разрешение на создание и изменение таблиц БД; если же вы хотите создавать таблицы вручную, вам надо просто предоставить Django разрешения SELECT , INSERT , UPDATE и DELETE . После создания пользователя БД с указанными привилегиями, вам понадобится изменить настройки вашего проекта, см. DATABASES .

    Если вы используете среду тестирования Django для проверки запросов к базе данных, Django понадобится разрешение на создание тестовой БД.

    Удаление предыдущей версии Django¶

    Вам нужно полностью удалить предыдущую версию Django перед установкой новой версии.

    В случае, если Django предварительно установлен с помощью pip или easy_install , вам не понадобится удалять предыдущую версию вручную: просто запустите pip или easy_install снова, это приведёт к обновлению текущей версии на более новую.

    В случае, если вы устанавливали Django, используя python setup.py install , его удаление будет заключаться в удалении самой директории django из site-packages . Чтобы найти нужную директорию вы должны запустить следующую команду в командной оболочке (не в интерактивной оболочке Python):

    Установка Django¶

    Инструкции по установке несколько различаются в зависимости от того, каким способом вы устанавливаете пакет: установка для конкретного дистрибутива, загрузка последней официальной версии или получение текущей разрабатываемой версии.

    Это просто, независимо от того, какой вариант будет вами выбран.

    Установка пакета для конкретного дистрибутива¶

    Проверьте наличие готового пакета, если ваша операционная система предоставляет возможность получить пакет/установщик Django. Как правило, этот способ удобен автоматическим разрешением зависимостей и обновлением версии Django.

    Установка официальной версии с помощью pip ¶

    Это рекомендуемый способ установки Django.

    Установите pip. Самым простым способом сделать это является использование автономного установщика pip. Если ваш дистрибутив уже включает установленную версию pip , возможно, вам потребуется обновить её до более свежей. (Если версия устарела, вы сразу поймёте это, поскольку установка не будет работать.)

    (опционально) Взгляните на virtualenv и virtualenvwrapper. Эти программы предоставляют изолированное окружение Python, что намного более практично, чем установка общесистемных пакетов. Такой подход также позволяет провести установку без административных прав. Это информация для размышления, если вы захотите использовать их.

    Если вы используете Linux, Mac OS X или иные Unix-подобные системы, введите команду sudo pip install Django в терминале. При использовании Windows запустите командную оболочку с правами администратора и впишите pip install Django . Эта команда установит Django в системную директорию site-packages .

    При использовании virtualenv вам не нужны административные полномочия или запуск программ через sudo , Django будет установлен в окружении virtualenv в директорию site-packages .

    Установка официальной версии вручную¶

    Скачайте последнюю стабильную версию со страницы загрузки.

    Распакуйте загруженный файл (например, командой tar xzvf Django-X.Y.tar.gz , где X.Y номер версии пакета). Если у вас установлена Windows, вы должны прежде загрузить инструмент командной строки bsdtar для запуска вышеуказанной команды или использовать для распаковки графические утилиты наподобие 7-zip.

    Перейдите в каталог, созданный на шаге 2 (например, cd Django-X.Y ).

    Если вы используете Linux, Mac OS X или иные Unix-подобные системы, введите команду sudo python setup.py install в терминале. Если у вас установлена Windows, запустите командную оболочку с правами администратора и впишите python setup.py install . Эта команда установит Django в системную директорию site-packages .

    Читайте также:  Установка клиент сервера для 1с

    Удаление предыдущей версии Django

    При использовании данного метода установки очень важно удалить предыдущую версию Django, если она была установлена ранее. В противном случае вы можете столкнуться с невозможностью установки новой версии.

    Установка разрабатываемой версии¶

    Следим за разработкой Django

    Если вы приняли решение использовать текущую разрабатываемую версию Django, вам нужно следить за информацией о выпуске новых исправлений на the development timeline. Это поможет вам оставаться в курсе происходящих изменений , таких как включение новой функциональности. Для получения изменений вы должны будете обновить вашу копию Django. (Для стабильных релизов, все необходимые изменения описаны в примечаниях к выпуску.)

    Если вы хотите обновить Django до разрабатываемой версии, чтобы иметь возможность использовать последние, возможно, нестабильные изменения и улучшения, следуйте этой инструкции:

    Убедитесь, что у вас установлен Git и вы можете запустить его из командной оболочки. (Введите git help в командной оболочке, чтобы проверить это.)

    Склонируйте разрабатываемую ветку Django (‘trunk’ или ‘master’) вот так:

    Эта команда создаст каталог django-trunk в вашей текущей директории.

    Убедитесь, что интерпретатор Python может загрузить код Django. Самый удобный способ сделать это – использовать pip. Запустите следующую команду:

    (При использовании virtualenv можно опустить sudo .)

    Это сделает код Django импортируемым, а также сделает доступным запуск django-admin.py . Иначе говоря, всё готово!

    Если у вас нет возможности установить pip, смотрите альтернативные инструкции по установке разрабатываемой версии без pip.

    Не запускайте команду sudo python setup.py install , поскольку вы уже провели эквивалентные действия на шаге 3.

    Когда вам понадобится обновить вашу копию Django, просто запустите команду git pull в директории django-trunk .После того, как вы сделаете это, Git автоматически загрузит изменения.

    Установка разрабатываемой версии без pip¶

    Если у вас не установлен pip, вы можете вручную изменить путь поиска Python.

    Сначала следуйте шагам 1 и 2, данным выше, так вы получите директорию django-trunk , включающую последнюю разрабатываемую версию Django. Теперь добавьте файл .pth , содержащий полный путь к django-trunk в каталоге site-packages . Например, для Unix-like систем:

    В строке, данной выше, измените WORKING-DIR/django-trunk на полный путь к вашей новой директории django-trunk , также измените SITE-PACKAGES-DIR на полный путь к системной директории с site-packages .

    Местонахождение каталога site-packages зависит от используемой вами операционной системы и места, куда был установлен Python. Чтобы определить, где находится site-packages запустите следующую команду:

    (запуск осуществляется в командной оболочке, а не в интерактивной оболочке Python)

    Некоторые Debian-based дистрибутивы Linux имеют обособленную директорию site-packages для пакетов, установленных пользователем, например, при установке Django из загруженного архива (tarball). Команда, указанная выше, отобразит местонахождение каталога site-packages , пользовательские директории можно найти в /usr/local/lib/ вместо /usr/lib/ .

    Далее вам нужно сделать утилиту django-admin.py доступной для системной переменной окружения PATH .

    В Unix-like системах для этого создаётся символьная ссылка на файл django-trunk/django/bin/django-admin.py в директории, содержащей системные пути, такой как /usr/local/bin . К примеру так:

    (В строке, данной выше, измените WORKING-DIR на полный путь к вашей новой директории django-trunk .)

    источник

    Документация Django 3.0

    Этот документ призван проинструктировать вас о том, как получить и запустить Django.

    Установка Python¶

    Django is a Python Web framework. See Какие версии Python можно использовать с Django? for details.

    Последнюю версию Python можно скачать на https://www.python.org/downloads/ или используя пакетный менеджер вашей операционной системы.

    Если вы только начали изучать Django и используете Windows, советуем почитать How to install Django on Windows .

    Установка Apache и mod_wsgi ¶

    Если вы просто хотите поэкспериментировать с Django, пропустите этот раздел и перейдите к следующему; Django включает в себя легковесный web-сервер, предназначенный для тестирования, поэтому вы вправе не устанавливать Apache до тех пор, пока ваш проект не будет готов для развёртывания на «боевом»-сервере.

    If you want to use Django on a production site, use Apache with mod_wsgi. mod_wsgi operates in one of two modes: embedded mode or daemon mode. In embedded mode, mod_wsgi is similar to mod_perl – it embeds Python within Apache and loads Python code into memory when the server starts. Code stays in memory throughout the life of an Apache process, which leads to significant performance gains over other server arrangements. In daemon mode, mod_wsgi spawns an independent daemon process that handles requests. The daemon process can run as a different user than the Web server, possibly leading to improved security. The daemon process can be restarted without restarting the entire Apache Web server, possibly making refreshing your codebase more seamless. Consult the mod_wsgi documentation to determine which mode is right for your setup. Make sure you have Apache installed with the mod_wsgi module activated. Django will work with any version of Apache that supports mod_wsgi.

    См. Использование Django и mod_wsgi для получения информации о настройке mod_wsgi сразу после того, как он будет установлен.

    Читайте также:  Установка вконтакте рабочий стол

    Если по какой-либо причине вы не можете использовать mod_wsgi, не волнуйтесь: Django поддерживает множество других вариантов развёртывания. Один из них – uWSGI ; он отлично работает с nginx . Дополнительно Django следует WSGI спецификации (PEP 3333), которая позволяет ему работать на различных серверных платформах.

    Создание рабочей базы данных¶

    If you plan to use Django’s database API functionality, you’ll need to make sure a database server is running. Django supports many different database servers and is officially supported with PostgreSQL, MariaDB, MySQL, Oracle and SQLite.

    If you are developing a small project or something you don’t plan to deploy in a production environment, SQLite is generally the best option as it doesn’t require running a separate server. However, SQLite has many differences from other databases, so if you are working on something substantial, it’s recommended to develop with the same database that you plan on using in production.

    В дополнение к официально поддерживаемым базам данных есть бэкэнды , поставляемые третьими сторонами, которые позволяют использовать другие БД с Django.

    В дополнение к установке необходимой БД вы также должны убедиться, что вами выбран и установлен соответствующий модуль Python.

    • При использовании PostgreSQL вам понадобится пакет psycopg2. Вы можете обратиться к заметкам о PostgreSQL для получения дальнейших инструкций, специфичных для этой БД.
    • If you’re using MySQL or MariaDB, you’ll need a DB API driver like mysqlclient . See notes for the MySQL backend for details.
    • Если вы используете SQLite, вам следует прочитать про особенности использования SQLite .
    • При использовании Oracle вам понадобится копия cx_Oracle, но, пожалуйста, обязательно ознакомьтесь с заметками для Oracle , которая содержит информацию о поддерживаемых версиях Oracle и cx_Oracle .
    • При использовании неофициальных бэкендов от сторонних разработчиков смотрите соответствующую документацию о дополнительных требованиях.

    If you plan to use Django’s manage.py migrate command to automatically create database tables for your models (after first installing Django and creating a project), you’ll need to ensure that Django has permission to create and alter tables in the database you’re using; if you plan to manually create the tables, you can grant Django SELECT , INSERT , UPDATE and DELETE permissions. After creating a database user with these permissions, you’ll specify the details in your project’s settings file, see DATABASES for details.

    Если вы используете среду тестирования Django для проверки запросов к базе данных, Django понадобится разрешение на создание тестовой БД.

    Установка Django¶

    Инструкции по установке несколько различаются в зависимости от того, каким способом вы устанавливаете пакет: установка для конкретного дистрибутива, загрузка последней официальной версии или получение текущей разрабатываемой версии.

    Установка официальной версии с помощью pip ¶

    Это рекомендуемый способ установки Django.

    Установите pip. Самым простым способом сделать это является использование автономного установщика pip. Если ваш дистрибутив уже включает установленную версию pip , возможно, вам потребуется обновить её до более свежей. (Если версия устарела, вы сразу поймёте это, поскольку установка не будет работать.)

    Взгляните на virtualenv и virtualenvwrapper. Эти программы предоставляют изолированное окружение Python, что намного более практично, чем установка общесистемных пакетов. Такой подход также позволяет провести установку без административных прав. Раздел о разработке Django описывает как создать виртуальное окружение

    After you’ve created and activated a virtual environment, enter the command:

    Установка пакета для конкретного дистрибутива¶

    Check the distribution specific notes to see if your platform/distribution provides official Django packages/installers. Distribution-provided packages will typically allow for automatic installation of dependencies and supported upgrade paths; however, these packages will rarely contain the latest release of Django.

    Установка разрабатываемой версии¶

    Следим за разработкой Django

    Если вы приняли решение использовать текущую разрабатываемую версию Django, вам нужно следить за информацией о выпуске новых исправлений на the development timeline. Это поможет вам оставаться в курсе происходящих изменений , таких как включение новой функциональности. Для получения изменений вы должны будете обновить вашу копию Django. (Для стабильных релизов, все необходимые изменения описаны в примечаниях к выпуску .)

    Если вы хотите обновить Django до разрабатываемой версии, чтобы иметь возможность использовать последние, возможно, нестабильные изменения и улучшения, следуйте этой инструкции:

    Убедитесь, что у вас установлен Git и вы можете запустить его из командной оболочки. (Введите git help в командной оболочке, чтобы проверить это.)

    Склонируйте разрабатываемую ветку Django вот так:

    Эта команда создаст каталог django в вашей текущей директории.

    Убедитесь, что интерпретатор Python может загрузить код Django. Самый удобный способ сделать это – использовать virtualenv, virtualenvwrapper и pip. Раздел о разработке Django описывает как создать виртуальное окружение.

    После того, как вы создали и активировали виртуальное окружение, выполните в консоли:

    Это сделает код Django импортируемым, а также сделает доступным запуск django-admin.py . Иначе говоря, всё готово!

    When you want to update your copy of the Django source code, run the command git pull from within the django directory. When you do this, Git will download any changes.

    источник