Вступление
Django - это полнофункциональный веб-фреймворк Python для разработки динамических веб-сайтов и приложений. Используя Django, вы можете быстро создавать веб-приложения Python и полагаться на среду, чтобы выполнить большую часть тяжелой работы.
В этом руководстве мы покажем вам, как настроить Django и запустить его на сервере Debian 8. После установки мы покажем вам, как начать новый проект, который будет использоваться в качестве основы для вашего сайта.
Предпосылки
Прежде чем начать, у вас должен быть пользователь без полномочий root с привилегиями + sudo +, доступный на вашем сервере Debian 8. Чтобы настроить это, следуйте нашему Debian 8 первоначальному руководству по установке сервера.
Когда вы будете готовы продолжить, прочитайте ниже, чтобы решить, какой метод установки лучше всего подходит для вашей ситуации.
Доступные способы установки
Существует множество различных способов установки Django в зависимости от ваших потребностей и способа настройки среды разработки. Они имеют разные преимущества, и один метод может лучше подойти для вашей конкретной ситуации, чем другие.
Некоторые из различных методов приведены ниже:
-
* link: # global-install-from-packages [Глобальная установка из пакетов] *: Официальные репозитории Debian содержат пакеты Django, которые можно легко установить с помощью обычного менеджера пакетов
+ apt +. Это очень просто, но не так гибко, как некоторые другие методы. Кроме того, версия, содержащаяся в репозиториях, может отставать от официальных версий, доступных в проекте. -
* link: # global-install-through-pip [Глобальная установка через pip] *: Инструмент
+ pip +- это менеджер пакетов для пакетов Python. Если вы установите+ pip +, вы можете легко установить Django на системном уровне для использования любым пользователем. Это всегда должно содержать последнюю стабильную версию. Несмотря на это, глобальные установки по своей природе менее гибки. -
* link: # virtualenv-install-through-pip [Установить через pip в Virtualenv] *: пакет Python
+ virtualenv +позволяет создавать автономные среды для различных проектов. Используя эту технологию, вы можете установить Django в каталог проекта, не затрагивая пакеты системного уровня. Это позволяет легко предоставлять индивидуальные настройки и пакеты для каждого проекта. Виртуальные среды по сравнению с общедоступной установкой вносят небольшие накладные расходы и затраты на процессы, но обеспечивают максимальную гибкость. -
* ссылка: # development-version-install-through-git [Версия разработки Установите через git] *: Если вы хотите установить последнюю версию разработки вместо стабильного выпуска, вам придется получить код из
+ git +Сделки рЕПО. Это может быть необходимо для получения последних функций / исправлений и может быть сделано глобально или локально. Однако версии для разработки не имеют одинаковых гарантий стабильности.
Принимая во внимание вышеупомянутые предостережения и качества, выберите метод установки, который наилучшим образом соответствует вашим потребностям, из приведенных ниже инструкций. После этого обязательно ознакомьтесь с разделом по ссылке: # creation-a-sample-project [создание примера проекта], чтобы узнать, как начать работу.
Глобальная установка из пакетов
Если вы хотите установить Django с помощью репозиториев Debian, процесс очень прост.
Сначала обновите локальный индекс пакета с помощью + apt +:
sudo apt-get updateЗатем выберите, какую версию Python вы хотите использовать с Django. Для * Python 2 * введите:
sudo apt-get install python-djangoЕсли вместо этого вы хотите использовать * Python 3 * с Django, введите:
sudo apt-get install python3-djangoВы можете проверить, что установка прошла успешно, набрав:
django-admin --versionOutput1.7.11Это означает, что программное обеспечение было успешно установлено. Вы также можете заметить, что версия Django не самая последняя стабильная. Чтобы немного узнать о том, как использовать программное обеспечение, перейдите вперед, чтобы узнать https://www.digitalocean.com/community/tutorials/how-to-install-the-django-web-framework-on-debian-8#creating -a-sample-project [как создать пример проекта].
Глобальная установка через пипс
Если вы хотите установить последнюю версию Django глобально, лучшим вариантом будет использование + pip +, менеджера пакетов Python. Во-первых, нам нужно установить менеджер пакетов + pip +. Обновите индекс пакета + apt +:
sudo apt-get updateТеперь вы можете установить соответствующие пакеты и завершить установку. Необходимые вам пакеты и команды зависят от версии Python, которую вы планируете использовать в своих проектах.
Python 2
Если вы планируете использовать Python 2, установите + pip +, менеджер пакетов Python, используя следующую команду:
sudo apt-get install python-pipТеперь, когда у вас есть + pip +, вы можете легко установить Django, набрав:
sudo pip install djangoВы можете убедиться, что установка прошла успешно, набрав:
django-admin --versionOutput1.10.4Как вы можете видеть, версия, доступная через + pip +, более актуальна, чем версия из репозиториев Debian (ваша, вероятно, будет отличаться от описанной выше).
Python 3
Если вы планируете использовать * Python3 *, установите + pip с помощью этой команды:
sudo apt-get install python3-pipЗатем мы можем использовать менеджер пакетов + pip + для установки Django, набрав:
sudo pip3 install djangoЧтобы убедиться, что установка завершена правильно, введите:
django-admin --versionOutput1.10.4Версия, установленная через + pip +, должна быть последней стабильной версией (конкретная версия может отличаться от показанной выше).
Virtualenv Установить через пипс
Возможно, наиболее гибкий способ установки Django в вашей системе - это инструмент + virtualenv +. Этот инструмент позволяет вам создавать виртуальные среды Python, где вы можете устанавливать любые пакеты Python, которые вы хотите, не затрагивая остальную часть системы. Это позволяет вам выбирать пакеты Python для каждого отдельного проекта независимо от конфликтов с требованиями других проектов.
Мы начнем с установки + pip + из репозиториев Debian. Обновите локальный индекс пакета перед запуском:
sudo apt-get updateПакеты и команды, необходимые для установки Django, различаются в зависимости от версии Python, которую вы хотите использовать для своих проектов. Следуйте инструкциям ниже для версии Python, которую вы планируете использовать.
Python 2
Первым шагом является глобальная установка + pip +. При использовании Python 2, команда для этого:
sudo apt-get install python-pipПосле установки + pip + вы можете использовать его для установки пакета + virtualenv +, набрав:
sudo pip install virtualenvТеперь, когда вы начинаете новый проект, вы можете создать для него виртуальную среду. Начните с создания и перемещения в новый каталог проекта:
mkdir ~/
cd ~/Теперь создайте виртуальную среду в каталоге проекта, набрав:
virtualenvЭто установит автономную версию Python, а также + pip +, в изолированную структуру каталогов внутри директории вашего проекта. Мы решили назвать нашу виртуальную среду ++, но вы можете назвать ее чем-то описательным. Будет создан каталог с выбранным вами именем, в котором будет храниться файловая иерархия, в которую будут установлены ваши пакеты.
Чтобы установить пакеты в изолированной среде, вы должны активировать его, набрав:
cd ~/
source /bin/activateВаше приглашение должно измениться, чтобы отразить, что вы сейчас находитесь в своей виртуальной среде. Это будет выглядеть примерно так: + () username @ hostname: ~ / projectname $ +.
В вашей новой среде вы можете использовать + pip + для установки Django. Вам не нужно использовать + sudo +, так как вы устанавливаете локально:
pip install djangoВы можете проверить установку, набрав:
django-admin --versionOutput1.10.4Как видите, Django был установлен в виртуальной среде.
Python 3
Первым шагом является глобальная установка + pip +. Чтобы сделать это с Python 3, введите:
sudo apt-get install python3-pipЗатем используйте менеджер пакетов, который вы только что установили, для установки пакета Python `+ virtualenv +:
sudo pip3 install virtualenvЗатем создайте виртуальную среду для хранения пакетов для вашего нового проекта. Начните с создания и перемещения в новый каталог проекта:
mkdir ~/
cd ~/Создайте виртуальную среду в каталоге проекта, набрав:
virtualenvЭто установит автономную версию Python, а также + pip +, в изолированную структуру каталогов внутри директории вашего проекта. Будет создан каталог с именем, переданным в качестве аргумента. Мы выбрали ++ здесь. Этот каталог будет содержать файловую иерархию, в которую будут установлены ваши пакеты.
Перед установкой пакетов в виртуальную среду вы должны активировать ее, набрав:
cd ~/
source /bin/activateВаша командная строка должна теперь начинаться с имени вашей виртуальной среды. Это будет выглядеть примерно так: + () username @ hostname: ~ / projectname $ +.
В вашей новой среде используйте + pip + для установки Django. Обратите внимание, что хотя мы используем Python 3, команда within в виртуальной среде имеет вид + pip + (не + pip3 +). Также обратите внимание, что вам не нужно использовать + sudo +, так как вы устанавливаете локально:
pip install djangoВы можете проверить установку, набрав:
django-admin --versionOutput1.10.4Как видите, Django был установлен в виртуальной среде.
Версия для разработки Установите через git
Если вам нужна версия Django для разработки, вам придется скачать и установить Django из репозитория проекта + git +.
Для этого сначала необходимо установить + git + в вашей системе с помощью + apt +. Нам также понадобится + pip +, который используется для установки из загруженного исходного кода. Имена пакетов и команды зависят от версии Python, которую вы планируете использовать с Django.
Python 2
Если вы используете Python 2, вы можете обновить свой индекс пакетов и установить необходимые пакеты, набрав:
sudo apt-get update
sudo apt-get install git python-pipЕсли у вас есть + git +, вы можете клонировать репозиторий Django. Между выпусками этот репозиторий будет иметь более современные функции и исправления ошибок за счет возможной стабильности. Вы можете клонировать репозиторий в каталог с именем + django-dev + в вашем домашнем каталоге, набрав:
git clone git://github.com/django/django ~/django-devКак только репозиторий будет клонирован, вы можете установить его с помощью + pip +. Мы будем использовать опцию + -e + для установки в «редактируемом» режиме, который необходим при установке из системы контроля версий. Если вы используете версию 2 Python, введите:
sudo pip install -e ~/django-devВы можете убедиться, что установка прошла успешно, набрав:
django-admin --versionOutput1.11.dev20161220175814Помните, что вы можете комбинировать эту стратегию с + virtualenv, если хотите установить версию разработки Django в одной среде.
Python 3
Если вы используете * Python 3 *, обновите индекс вашего пакета и установите + git + и + pip +, набрав:
sudo apt-get update
sudo apt-get install git python3-pipЗатем вы можете клонировать репозиторий Django в каталог с именем + django-dev + в вашем домашнем каталоге, набрав:
git clone git://github.com/django/django ~/django-devВы можете установить Django прямо из каталога + git + с помощью + pip +. Опция + -e + позволяет нам устанавливать в «редактируемом» режиме, который необходим при установке из репозиториев контроля версий:
sudo pip3 install -e ~/django-devВы можете убедиться, что установка прошла успешно, набрав:
django-admin --versionOutput1.11.dev20161220175814Если вы хотите установить версию для разработки в изолированной среде, вы можете объединить эту стратегию со стратегией + virtualenv +.
Создание примера проекта
После установки Django мы можем показать вам, как начать работу над проектом.
Создание основ проекта
Используйте команду + django-admin + для создания проекта. Это создаст каталог с именем ` в вашем текущем каталоге. В этом новом каталоге будет создан сценарий управления, а другой каталог с именем ` будет создан с реальным кодом.
Чтобы создать полную структуру каталогов (каталог родительского проекта, сценарий управления и внутренний каталог проекта), введите:
django-admin startproject
cdЧтобы загрузить базу данных (по умолчанию используется SQLite), введите:
./manage.py migrateЗатем создайте пользователя с правами администратора, набрав:
./manage.py createsuperuserВам будет предложено выбрать имя пользователя, адрес электронной почты и пароль для пользователя.
Изменение ALLOWED_HOSTS в настройках Django
Прежде чем вы сможете протестировать свое приложение, вам нужно изменить одну из директив в настройках Django.
Откройте файл настроек, набрав:
nano ~///settings.pyВнутри найдите директиву + ALLOWED_HOSTS +. Это определяет белый список адресов или доменных имен, которые могут использоваться для подключения к экземпляру Django. Любые входящие запросы с заголовком * Host *, которого нет в этом списке, вызовут исключение. Django требует, чтобы вы установили это, чтобы предотвратить определенный класс уязвимости безопасности.
В квадратных скобках укажите IP-адреса или доменные имена, связанные с вашим сервером Django. Каждый элемент должен быть указан * в кавычках * с записями *, разделенными запятой *. Если вы хотите ответить на запросы о домене и каких-либо поддоменах, добавьте точку к началу записи. В приведенном ниже фрагменте есть несколько закомментированных примеров, используемых для демонстрации правильного способа форматирования записей:
~ / MyProject / MyProject / settings.py
. . .
# The simplest case: just add the domain name(s) and IP addresses of your Django server
# ALLOWED_HOSTS = [ 'example.com', '203.0.113.5']
# To respond to 'example.com' and any subdomains, start the domain with a dot
# ALLOWED_HOSTS = ['.example.com', '203.0.113.5']
ALLOWED_HOSTS = ['', '', ]Когда вы закончите, сохраните и закройте файл.
Тестирование с вашим сервером разработки
Затем запустите сервер разработки Django, чтобы увидеть, как выглядит свежий проект Django. Вы должны использовать это только в целях разработки.
Запустите сервер разработки, набрав:
~//manage.py runserver 0.0.0.0:8000Перейдите на IP-адрес вашего сервера, а затем в браузере введите «+: 8000 +»
http://:8000Вы должны увидеть что-то похожее на это:
изображение: https: //assets.digitalocean.com/articles/django_1404/django_default.png [Публичная страница Django]
Теперь добавьте + / admin + в конец вашего URL, чтобы попасть на страницу входа администратора:
:8000/adminизображение: https: //assets.digitalocean.com/articles/django_1404/django_admin_login.png [логин администратора Django]
Если вы введете имя пользователя и пароль администратора, которые вы только что создали, вы должны перейти в раздел администратора сайта:
изображение: https: //assets.digitalocean.com/articles/django_1404/django_admin_page.png [Страница администратора Django]
Когда вы закончите просматривать сайт по умолчанию, вы можете остановить сервер разработки, набрав + CTRL-C + в своем терминале.
Созданный вами проект Django обеспечивает структурную основу для разработки более полного сайта. Посетите https://docs.djangoproject.com [документация Django] для получения дополнительной информации о том, как создавать приложения и настраивать свой сайт.
Заключение
Теперь на вашем сервере Debian 8 должен быть установлен Django, предоставляющий основные инструменты, необходимые для создания мощных веб-приложений. Вы также должны знать, как начать новый проект и запустить сервер разработчика. Использование полной веб-инфраструктуры, такой как Django, может ускорить разработку, позволяя вам сосредоточиться только на уникальных аспектах ваших приложений.