Python django ��������� linux

Установка Django

Примечание: если ты используешь Chromebook, пропусти эту главу, но выполни инструкции по настройке для Chromebook

Примечание: если ты уже выполнила установку — можешь пропустить эту часть и сразу перейти к следующей главе!

Отдельные части этой главы основаны на учебных пособиях Geek Girls Carrots (https://github.com/ggcarrots/django-carrots).

Отдельные части этой главы основаны на учебном пособии django-marcador, лицензированном под Creative Commons Attribution-ShareAlike 4.0 International License. Руководство django-marcador защищено авторским правом Markus Zapke-Gründemann et al.

Виртуальное окружение

Перед установкой Django мы попросим тебя установить крайне полезный инструмент, который поможет тебе содержать среду разработки в чистоте. Можно пропустить этот шаг, но мы очень советуем этого не делать. Использование лучших рекомендаций с самого начала убережёт от многих проблем в будущем!

Итак, давай создадим виртуальное окружение (оно также называется virtualenv). Virtualenv будет изолировать настройки Python/Django для каждого отдельного проекта. Это значит, что изменения одного сайта не затронут другие сайты, которые ты разрабатываешь. Удобно, правда?

Всё, что тебе нужно сделать — найти директорию, в которой мы создадим virtualenv ; домашний каталог вполне подойдёт. Для Windows адрес будет выглядеть так: C:\Users\Name (где Name — твоё имя пользователя).

Примечание: Если ты работаешь в Windows, удостоверься, что в названии директории нет специальных символов или символов с диакритическими знаками; если в твоём имени пользователя есть такие символы, выбери другую директорию, например, C:\djangogirls .

Мы будем использовать отдельную директорию djangogirls в домашнем каталоге:

Мы создадим виртуальное окружение под именем myvenv . В общем случае команда будет выглядеть так:

Чтобы создать новое virtualenv , тебе нужно открыть командную строку и набрать python -m venv myvenv . Это будет выглядеть так:

Здесь myvenv — имя твоего virtualenv . Ты можешь выбрать другое имя, но используй только строчные буквы, без пробелов и специальных символов. Имя виртуального окружения выбирай покороче — тебе придётся часто его набирать!

В Linux и OS X достаточно набрать python3 -m venv myvenv , чтобы создать virtualenv :

myvenv — имя виртуального окружения virtualenv . Можешь выбрать другое имя, но используй только строчные буквы и никаких пробелов. Имя виртуального окружения лучше выбирать покороче — набирать его предстоит не раз!

Примечание: В некоторых версиях Debian/Ubuntu может произойти следующая ошибка:

В таком случае следуй приведённым инструкциям и установи пакет python3-venv :

Примечание: В некоторых версиях Debian/Ubuntu при таком способе создания виртуального окружения ты можешь получить такую ошибку:

Чтобы обойти её, используй команду virtualenv .

Примечание: Если ты получаешь следующую ошибку

то запусти команду:

Работаем с virtualenv

Указанная выше команда создаст директорию myvenv (или другую, в зависимости от выбранного тобой имени), которая будет содержать виртуальное окружение (по сути — набор файлов и папок).

Запусти виртуальное окружение, выполнив:

ПРИМЕЧАНИЕ: в Windows 10 при работе в Windows PowerShell ты можешь получить ошибку вида execution of scripts is disabled on this system . В этом случае открой ещё одно окно Windows PowerShell, выбрав опцию «Запустить от имени Администратора». Затем перед использованием виртуального окружения попробуй запустить следующую команду:

Запусти виртуальное окружение, выполнив:

Не забудь поменять myvenv на выбранное тобой имя для virtualenv !

ПРИМЕЧАНИЕ: иногда команда source может быть недоступна. В таком случае используй следующий метод:

Ты поймёшь, что virtualenv запущено, когда увидишь префикс (myvenv) в начале приглашения командной строки.

При работе с виртуальным окружением команда python будет автоматически обращаться к правильной версии языка, так что ты можешь использовать просто python вместо python3 .

Отлично, теперь мы будем хранить все важные зависимости в одном месте. Наконец можно установить Django!

Установка Django

После запуска virtualenv ты можешь установить Django.

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

Установка библиотек через указание требований

Файл с требованиями (requirements) хранит список зависимостей, которые нужно установить с помощью pip install :

Для начала создай файл requirements.txt внутри директории djangogirls/ , используя текстовый редактор, который ты установила ранее. Просто создай в редакторе новый файл, а затем сохрани его под именем requirements.txt в директории djangogirls/ . После этого твоя директория будет выглядеть так:

В файл djangogirls/requirements.txt нужно добавить такой текст:

Теперь выполни команду pip install -r requirements.txt , чтобы установить Django.

Если при запуске pip в Windows ты получаешь сообщение об ошибке, проверь, что путь к директории с проектом не содержит пробелов или специальных символов ( C:\Users\User Name\djangogirls ). Если проблема в этом, то, пожалуйста, перенеси свой проект в другое место, адрес которого не будет содержать пробелов и специальных символов (предлагаем C:\djangogirls ). Создай новое виртуальное окружение в новой директории, после этого удали старое и попробуй запустить команды выше заново (перемещение виртуального окружения не сработает, поскольку в нём используются абсолютные пути).

При попытке установки Django твоя командная строка может зависнуть. Если это произошло, вместо приведённой выше команды используй:

Вот и всё! Теперь ты (наконец-то) готова создать своё Django-приложение!

Источник

Установка веб-фреймворка Django в Ubuntu 20.04

Django – это полноценный веб-фреймворк Python для создания приложений и динамических сайтов. Он позволяет значительно ускорить процесс разработки и развёртывания приложения, беря на себя общее структурирование кода.

Этот мануал поможет вам установить Django на сервер Ubuntu 20.04, а также научит работать с этим фреймворком.

Методы установки Django

Существует несколько методов установки Django, каждый из которых имеет свои преимущества в определённых ситуациях.

Вот основные методы:

• Глобальная установка Django из пакета. Официальный репозиторий Ubuntu предоставляет пакеты Django, которые можно быстро установить при помощи менеджера apt. Этот метод очень прост, но не так гибок, как другие. Кроме того, репозиторий может содержать устаревшую версию Django.
• Установка через pip в виртуальную среду. Пакеты venv и virtualenv позволяют создавать автономные среды для разных проектов. Благодаря этому выможете установить Django в каталог проекта, не повлияв на остальную систему, включая другие пользовательские настройки и проекты. В большинстве случаев это самый практичный и гибкий метод установки и работы с Django, потому рекомендуется использовать именно его.
• Установка разрабатываемой версии с помощью Git. Чтобы установить последнюю разрабатываемую версию вместо стабильного релиза, нужно клонировать код из репозитория git. Это предоставит новейшие функции и исправления программы; установить такую версию можно в виртуальную среду. Но имейте в виду: разрабатываемые версии нестабильны.

Выберите наиболее подходящий вариант установки Django и следуйте инструкциям соответствующего раздела этого мануала.

Требования

Для работы вам понадобится сервер Ubuntu 20.04, полностью настроенный по этому мануалу.

Глобальная установка Django из пакета

Установка Django из официального репозитория Ubuntu очень проста.

Для начала нужно обновить индекс пакетов при помощи apt:

sudo apt update

После этого нужно узнать, какая версия Python установлена на вашем сервере. Сервер 20.04 по умолчанию поставляется с Python 3.8. Вы можете проверить это:

python3 -V
Python 3.8.2

Теперь можно установить Django:

sudo apt install python3-django

Убедитесь, что установка прошла успешно:

django-admin —version
2.2.12

Если команда вернула версию установленного фреймворка, значит, установка прошла успешно. Обратите внимание: это не самая свежая версия Django. Стандартные репозитории системы обычно содержат немного устаревшие пакеты.

Теперь можете приступать к созданию тестового проекта.

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

Самым гибким вариантом установки является использование виртуальной среды. Это позволяет устанавливать любые необходимые пакеты изолированно, не влияя на систему в целом. Благодаря модулю venv вы можете выбирать для проектов пакеты Python на индивидуальной основе и не беспокоиться о конфликте зависимостей.

Для начала нужно обновить индекс пакетов:

sudo apt update

Проверьте версию Python:

python3 -V
Python 3.8.2

Теперь установите pip и venv из репозитория Ubuntu:

sudo apt install python3-pip python3-venv

Теперь нужно создать индивидуальную виртуальную среду для вашего проекта. Создайте каталог и перейдите в него (вместо newproject укажите название вашего проекта):

Создайте виртуальную среду в каталоге проекта с помощью команды python. Мы назовем ее условно my_env, но лучше использовать более описательное имя, например, имя вашего проекта.

python3 -m venv my_env

Эта команда создаст автономную среду, а затем установит Python и pip в изолированный каталог. Созданный каталог будет содержать файловую иерархию для установки пакетов.

Чтобы установить пакеты в изолированную среду, сначала её нужно включить:

После этого командная строка изменится. Это сообщает о том, что виртуальная среда была включена. Она будет выглядеть примерно так:

В новой среде используйте pip для установки Django. Вне зависимости от того, какую версию Python вы используете, в виртуальной среде нужно запускать команду pip, а не pip3. Кроме того, при локальной установке не нужно использовать sudo.

pip install django

Убедитесь, что программа установлена успешно.

django-admin —version
3.0.8

Ваша версия может отличаться.

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

После этого командная строка примет свой стандартный вид. Чтобы снова включить виртуальную среду, вернитесь в каталог проекта и введите эти команды:

/newproject
source my_env/bin/activate

Установка разрабатываемой версии Django с помощью Git

Чтобы установить разрабатываемую версию Django, загрузите её из репозитория Git.

Обновите индекс пакетов:

sudo apt update

Проверьте версию Python, установленную на сервере:

python3 -V
Python 3.8.2

А затем установите менеджер пакетов pip и пакет venv:

sudo apt install python3-pip python3-venv

После этого клонируйте репозиторий Django. Он содержит новейшие функции и исправления, но не является стабильным. Чтобы клонировать репозиторий в каталог

/django-dev в домашнем каталоге, введите:

git clone git://github.com/django/django

Перейдите в этот каталог:

Создайте виртуальную среду для вашего проекта:

python3 -m venv my_env

После этого установите репозиторий с помощью менеджера pip. Используйте флаг -e для установки в режиме editable, это необходимо при установке через систему контроля версий.

Убедитесь, что установка прошла успешно:

django-admin —version
3.2

Версия может отличаться.

Теперь у вас есть последняя (но нестабильная) версия Django в виртуальной среде.

Создание простого проекта Django

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

Для начала создайте каталог для проекта и перейдите в него.

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

python3 -m venv my_env

pip install django

Чтобы собрать проект, используйте команду django-admin и startproject. В мануале проект условно называется djangoproject (а вы укажите название своего проекта). Команда startproject сделает следующее:

• создаст каталог в текущем рабочем каталоге
• поместит в него скрипт управления manage.py и еще один каталог (с именем проекта) с текущим кодом.

Чтобы избежать большого количества вложенных каталогов, добавьте в команду точку – и тогда Django поместит скрипт и внутренние каталоги в текущий каталог.

django-admin startproject djangoproject .

Чтобы переместить БД (по умолчанию это SQLite), используйте команду migrate с manage.py. При перемещении все внесенные ранее изменения в модели Django будут применены к схеме БД.

Чтобы начать миграцию, введите:

python manage.py migrate

Вы получите такой вывод:

Operations to perform:
Apply all migrations: admin, auth, contenttypes, sessions
Running migrations:
Applying contenttypes.0001_initial. OK
Applying auth.0001_initial. OK
Applying admin.0001_initial. OK
Applying admin.0002_logentry_remove_auto_add. OK
Applying admin.0003_logentry_add_action_flag_choices. OK
Applying contenttypes.0002_remove_content_type_name. OK
Applying auth.0002_alter_permission_name_max_length. OK
Applying auth.0003_alter_user_email_max_length. OK
Applying auth.0004_alter_user_username_opts. OK
Applying auth.0005_alter_user_last_login_null. OK
Applying auth.0006_require_contenttypes_0002. OK
Applying auth.0007_alter_validators_add_error_messages. OK
Applying auth.0008_alter_user_username_max_length. OK
Applying auth.0009_alter_user_last_name_max_length. OK
Applying sessions.0001_initial. OK

Теперь нужно создать администратора для доступа к интерфейсу Djano.

python manage.py createsuperuser

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

Настройка ALLOWED_HOSTS

Чтобы успешно протестировать свое приложение, вы должны изменить одну из директив в параметрах Django.

Откройте конфигурационный файл:

Найдите директиву ALLOWED_HOSTS. Она определяет белый список адресов и доменов – все члены списка смогут получить доступ к экземпляру Django. Входящий запрос с заголовком Host, которого нет в этом списке, будет сброшен. С помощью этой директивы Django защищается от некоторых уязвимостей безопасности.

В квадратных скобках укажите IP-адреса или домены, которые связаны с вашим сервером Django. Каждый элемент должен быть указан в кавычках, отдельные записи разделяются запятой. Если вы хотите разрешить запросы для всего домена и любых поддоменов, добавьте в начало записи точку.

ALLOWED_HOSTS = [‘your_server_ip_or_domain’, ‘your_second_ip_or_domain’, . . .]

Сохраните и закройте файл.

Тестирование сервера разработки

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

Прежде чем запустить сервер разработки, убедитесь, что вы открыли соответствующий порт в брандмауэре. Если вы выполнили мануал по начальной настройке сервера и включили UFW, вы можете открыть порт 8000 с помощью команды:

sudo ufw allow 8000

Теперь запустите сервер:

python manage.py runserver your_server_ip:8000

Откройте свой IP-адрес с портом :8000 в брандмауэре:

Если все работает хорошо, вы увидите:

The install worked successfully! Congratulations!

Чтобы получить доступ к интерфейсу администратора, добавьте секцию /admin/:

На экране появится форма входа, которая запросит имя и пароль пользователя.

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

Поработав со своим тестовым проектом, остановите сервер разработки, введя в терминал CTRL-C. Этот стандартный проект Django в дальнейшем можно использовать как шаблон для разработки уникального сайта. Чтобы узнать, как создавать пользовательские приложения и настроить свой сайт, читайте документацию Django.

Заключение

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

Источник