Настройка django с postgres, nginx и gunicorn в ubuntu 20.04

Настройка Django через командную строку

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

В дальнейшем будет показано как установить и настроить Django через командную строку.

На системах Mac командную строку можно открыть через Terminal, что находится в . Откройте новое окно Finder, затем директорию Applications, в нижней части будет папка Utilities, из которой двойным нажатием клавиши можно запустить приложение Terminal.

В Windows есть две встроенные командные оболочки: Command shell и PowerShell. Рекомендуем использовать PowerShell, которая несколько мощнее.

Если в примере требуется обратиться к «командной строке», значит вы должны открыть новую консоль, используя Terminal или PowerShell.

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

— перейти на директорию;
— перейти на директорию выше;
— вывести список файлов в текущей директории;
— вывести название текущей директории;
— создать директорию;
— создать новый файл.

Запустите командную строку и посмотрите, как действует каждая команда. Знак доллара () является подсказкой, что перед вами командная строка. Все команды даны после знака . Предположим, вы работаете на Ubuntu Linux. Давайте поменяем директорию рабочего стола Desktop.

Shell

$ cd ~/Desktop

1	$cd~Desktop

Заметьте, что наше текущее местоположение, то есть , в командной строке было автоматически добавлено перед знаком . Для подтверждения верности отображаемой локации, можно использовать . Она выведет адрес текущей директории.

Shell

~/Desktop $ pwd
/home/wsv/Desktop

1 2	~Desktop$pwd homewsvDesktop

На Ubuntu полученная строчка будет значить, что сейчас работает пользователь , который использует данный аккаунт на рабочем столе .

Теперь создадим новую директорию при помощи , задействуем , после чего создадим новый файл , используя команду . Стоит отметить, что, к сожалению, в Windows нельзя использовать команду . Если дается инструкция к созданию нового файла, делайте это в выбранном текстовом редакторе.

Shell

~/Desktop $ mkdir new_dir && cd new_dir
~/Desktop/new_dir $ touch index.html

1 2	~Desktop$mkdirnew_dir&&cdnew_dir ~Desktopnew_dir$touchindex.html

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

Shell

~/Desktop/new_dir $ ls
index.html

1 2	~Desktopnew_dir$ls index.html

На финальном этапе вернемся в директорию Desktop, для чего используем команду и затем проверим верность локации с .

Shell

~/Desktop/new_dir $ cd ..
~/Desktop $ pwd
/home/wsv/Desktop

1
2
3

~Desktopnew_dir$cd..

~Desktop$pwd

homewsvDesktop

Некоторые разработчики обходятся без мышки, используя только командную строку. С практикой такой подход значительно ускоряет скорость работы.

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

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

Для создания проекта используется команда django-admin:

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

Примечание: Находясь в каталоге проекта, созданном при помощи virtualenv, Django может разместить скрипты управления и внутренние каталоги в текущем каталоге при помощи следующей команды (обратите внимание на точку в конце стоки):

Чтобы сгенерировать базу данных в более новых версиях Django (по умолчанию используется SQLite), введите:

Если команда migrate не работает, значит, текущая версия Django является более старой и не поддерживает её. В таком случае используйте:

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

При использовании команды migrate нужно создать учётную запись администратора вручную. Для этого наберите:

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

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

В браузере посетите IP-адрес, задав порт:

Это откроет приветственную страницу Django.

Если добавить в конец ссылки сегмент /admin, на экране появится страница входа для администратора.

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

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

Работаем с virtualenv

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

Работаем с virtualenv: Windows

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

command-line

Работаем с virtualenv: Linux и OS X

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

command-line

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

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

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

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

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

Чтобы протестировать работу установки Django, создайте тестовый проект.

Затем нужно создать каталог для хранения файлов проекта.

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

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

Теперь можно сгенерировать приложение с помощью django-admin, утилиты командной строки Python. Затем можно создать структуру каталогов для тестового веб-сайта с помощью команды startproject.

В каталоге test-django-app запустите команду:

Примечание: Команда django-admin startproject < projectname> создаст одноименный каталог и пакет проекта в каталоге, в котором она была запущена. Параметр <destination> позволяет задать целевой каталог, если команда запускается в другом каталоге.

Теперь можно просмотреть полученные файлы проекта. Перейдите в каталог testsite и просмотрите его содержимое:

Как видите, в каталоге есть файл manage.py и каталог testsite. Файл manage.py работает как django-admin и помещает пакет проекта в sys.path. Также он устанавливает переменную среды DJANGO_SETTINGS_MODULE, которая указывает на файл проекта settings.py.

Просмотрите сценарий manage.py в терминале.

Чтобы закрыть сценарий, просто нажмите q.

Перейдите в каталог testsite, чтобы просмотреть другие файлы проекта.

Команда выведет такие файлы:

Давайте рассмотрим подробнее каждый файл:

__init__.py работает как точка входа в проект Python.
settings.py содержит настройки установки Django.
urls.py содержит список urlpatterns, который обрабатывает URL-адреса и связывает их с видами.
wsgi.py содержит настройки WSGI (Web Server Gateway Interface), стандарта платформы Python для развертывания веб-серверов и приложений.

Примечание: Файл wsgi.py можно в любой момент настроить в соответствии с потребностями приложения.

Запуск и просмотр проекта

Теперь можно запустить сервер и просмотреть полученный веб-сайт.

Сначала нужно добавить ip-адрес сервера в список ALLOWED_HOSTS в файле settings.py, который находится в ~/test_django_app/testsite/testsite/.

Согласно документации Django, переменная ALLOWED_HOSTS содержит список имен хостов и доменов, которые может обслуживать этот сайт Django. Это мера безопасности, предотвращающая атаки подмены HTTP-заголовков Host.

Откройте файл в текстовом редакторе и добавьте свой адрес.

Найдите раздел Allowed Hosts и добавьте свой IP-адрес в квадратных скобках.

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

Затем вернитесь в каталог, где находится manage.py:

Запустите следующую команду:

Затем перейдите по этой ссылке, чтобы просмотреть скелет тестового сайта:

Вы увидите такую страницу:

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

Теперь вы можете использовать тестовый проект в качестве шаблона для разработки более сложного сайта.

Debian 8DjangoUbuntu 16.04

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

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

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

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

Активируйте ее:

Установите Django:

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

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

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

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

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

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

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

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

Настройка ALLOWED_HOSTS

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

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

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

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

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

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

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

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

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

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

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

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

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

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

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

Development Version Install through git

If you need a development version of Django, you will have to download and install Django from its repository.

To do so, you will need to install on your system with . Refresh your local package index by typing:

Now, we can install . We will also install the Python package manager. We will use this to handle the installation of Django after it has been downloaded. If you are using Python 2, you can type:

If you are using Python 3 instead, you should type this:

Once you have , you can clone the Django repository. Between releases, this repository will have more up-to-date features and bug fixes at the possible expense of stability. You can clone the repository to a directory called within your home directory by typing:

Once the repository is cloned, you can install it using . We will use the option to install in “editable” mode, which is needed when installing from version control. If you are using version 2 of Python, type:

If you are using Python 3, type:

You can verify that the installation was successful by typing:

Note that you can also combine this strategy with the use of above if you wish to install a development version of Django in a single environment.

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

Виртуальные окружения является незаменимыми аспектами программирования на Python. Это изолированные контейнеры, которые состоят из необходимых для рассматриваемого проекта программных инструментов. Они крайне важны, так как по умолчанию Python и Django устанавливаются в одну и ту же директорию. По этой причине могут возникнуть проблемы, когда пользователь хочет работать сразу с несколькими проектами на одном компьютере. Что, если использует Django 3.0, а прошлогодний все еще на Django 1.11?

Существует огромное количество отраслей программирования, где не утихают дискуссии касательно применения тех или иных инструментов. Однако, в отношении виртуальных окружений Python спорить нет нужды. Вы должны использовать отдельное виртуальное окружение для каждого нового проекта Python.

Для управления управления виртуальными окружениями мы будем использовать Pipenv. Pipenv похож на и из JavaScript/Node экосистем: он создает , в котором находятся необходимые программные инструменты, а также для обеспечения детерминированных сборок. «Детерминирование» предполагает, что при каждой загрузке программы в новое виртуальное окружение конфигурация будет оставаться прежней.

Себастиан МакКензи, создатель Yarn, в котором был введен концепт пакетирования JavaScript, сделал небольшой пост о детерминирования и его важности. C Pipenv мы будем создавать новое виртуальное окружение для каждого проекта Django

Для инсталляции можно использовать , который Homebrew (Mac) установил автоматически, как и Python 3. Если у вас любая другая операционная система, то команда та же.

Shell

$ python3 -m pip install pipenv

1	$python3-mpip install pipenv

Установка Django в Ubuntu 18.04

В следующих разделах представлены пошаговые инструкции по установке Django в виртуальной среде Python в Ubuntu 18.04.

Установка Python 3 и venv

Ubuntu 18.04 по умолчанию поставляется с Python 3.6. Вы можете убедиться, что Python 3 установлен в вашей системе, набрав:

Результат должен выглядеть так:

Начиная с Python 3.6, рекомендуемый способ создания виртуальной среды — использовать модуль . Чтобы установить пакет , который предоставляет модуль выполните следующую команду:

После установки модуля мы готовы создать виртуальную среду для нашего приложения Django.

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

Начните с перехода в каталог, в котором вы хотите хранить виртуальные среды Python 3. Это может быть ваш домашний каталог или любой другой каталог, в котором ваш пользователь имеет права на чтение и запись.

Создайте новый каталог для вашего приложения Django и перейдите в него:

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

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

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

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

Установка Django

Теперь, когда виртуальная среда активирована, вы можете использовать пакет диспетчера пакетов Python для установки Django:

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

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

На момент написания этой статьи последняя официальная версия Django — 2.1.2.

Ваша версия Django может отличаться от версии, показанной здесь.

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

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

Приведенная выше команда создаст каталог в вашем текущем каталоге.

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

Давайте перенесем базу данных и создадим пользователя с правами администратора.

Начните с каталог :

По умолчанию Django использует базу данных SQLite. Для производственных приложений вы можете использовать PostgreSQL , MariaDB , Oracle или MySQL Database.

Выполните следующую команду, чтобы перенести базу данных:

Результат будет выглядеть примерно так:

После переноса базы данных создайте пользователя с правами администратора, чтобы вы могли использовать интерфейс администратора Django:

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

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

Запустите веб-сервер разработки, используя сценарий за которым параметр :

Вы увидите следующий результат:

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

Откройте в своем веб-браузере, и вам будет представлена целевая страница Django по умолчанию:

Вы можете получить доступ к интерфейсу администратора Django, добавив в конец URL-адреса ( ). Это приведет вас к экрану входа в систему администратора:

Введите свое имя пользователя и пароль, и вы будете перенаправлены на страницу администратора Django:

Чтобы остановить сервер разработки, введите в терминале .

Step 5 — Accessing the Django Web App

With our configuration completed, be sure to navigate back to the directory where is located:

Now, run the following command replacing the your-server-ip text with the IP of your server:

Finally, you can navigate to the below link to see what your skeleton website looks like, again replacing the highlighted text with your server’s actual IP:

Once the page loads, you’ll see the following:

This confirms that Django was properly installed and our test project is working correctly.

To access the admin interface, add to the end of your URL:

This will take you to a login screen:

If you enter the admin username and password that you just created, you will have access to the main admin section of the site:

For more information about working with the Django admin interface, please see “How To Enable and Connect the Django Admin Interface.”

When you are done with testing your app, you can press + to stop the command. This will return you to your programming environment.

When you are ready to leave your Python environment, you can run the command:

Deactivating your programming environment will put you back to the terminal command prompt.

Установка Django через pipenv

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

Shell

$ cd ~/Desktop
$ mkdir django
$ cd django

1
2
3

$cd~Desktop

$mkdirdjango

$cddjango

Теперь используем Pipenv для инсталляции Django.

Shell

$ pipenv install django==3.0

1	$pipenv install django==3.0

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

Shell

$ pipenv shell

1	$pipenv shell

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

Стоит иметь в виду, что из-за в системе Windows, сейчас нет возможности получить визуальное подтверждение об активации виртуального окружения. Однако в следующей секции можно запустить — тогда станет ясно, что виртуальное окружение Django установлено должным образом.

Shell

(django) $

(django)$

Все работает! Теперь создаем новый проект Django под названием при помощи следующей команды. Не забудьте в конце поставить точку.

Shell

(django) $ django-admin startproject test_project .

1	(django)$django-admin startproject test_project.

Немного остановимся на причине использования точки (.) в предыдущей команде. Если вы просто запустите то Django по умолчанию создаст следующую структуру:

Структура

Shell

└── test_project
├── manage.py
└── test_project
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py

1
2
3
4
5
6
7

└──test_project

├──manage.py

└──test_project

├──__init__.py

├──settings.py

├──urls.py

└──wsgi.py

Как видите, создается новая директория , в ней файл и еще одна директория . Чувствуется повторение, ведь ранее мы уже создали директорию на рабочем столе и переместились в нее. Будет лучше выполнить команду с точкой на конце. Это нужно для установки в данную конкретную папку — на сей раз результат будет таков:

Структура

Shell

├── manage.py
└── test_project
├── __init__.py
├── settings.py
├── urls.py
└── wsgi.py

1
2
3
4
5
6

├──manage.py

└──test_project

├──__init__.py

├──settings.py

├──urls.py

└──wsgi.py

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

Осталось убедиться, что все работает. Для этого запустим локальный веб-сервер Django.

Shell

(django) $ python manage.py runserver

1	(django)$python manage.pyrunserver

Мы получим такой ответ:

Shell

Watching for file changes with StatReloader
Performing system checks…

System check identified no issues (0 silenced).

You have 17 unapplied migration(s). Your project may not work properly until you apply the migrations for app(s): admin, auth, contenttypes, sessions.
Run ‘python manage.py migrate’ to apply them.

May 05, 2020 — 12:36:09
Django version 3.0, using settings ‘test_project.settings’
Starting development server at http://127.0.0.1:8000/
Quit the server with CONTROL-C.

1
2
3
4
5
6
7
8
9
10
11
12

Watching forfilechanges with StatReloader

Performing system checks…

System check identified no issues(silenced).

You have17unapplied migration(s).Your project may notwork properly untilyou apply the migrations forapp(s)admin,auth,contenttypes,sessions.

Run’python manage.py migrate’toapply them.

May05,2020-123609

Django version3.0,using settings’test_project.settings’

Starting development server athttp127.0.0.18000

Quit the server with CONTROL-C.

При посещении откроется следующая страница:

Приветственная страница Django

Для остановки локального сервера используйте комбинацию . После этого выйти из виртуального окружения можно при помощи команды .

Shell

(django) $ exit

1	(django)$exit

Вновь активировать виртуальное окружение можно в любое время. — для этого используется команда в терминале.

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

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

Step 1 — Installing Django

There are several ways to install Django, the Python package manager pip within a virtual environment.

While in the server’s home directory, we’ll create the directory that will contain our Django application. Run the following command to create a directory called , or another name of your choice. Then navigate to the directory.

While inside the directory, create your virtual environment. We’ll call it the generic , but you should use a name that is meaningful for you and your project.

Now, activate the virtual environment with the following command:

You’ll know it’s activated once the prefix is changed to , which will look similar to the following, depending on what directory you are in:

Within the environment, install the Django package using pip. Installing Django allows us to create and run Django applications.

Once installed, verify your Django installation by running a version check:

This, or something similar, will be the resulting output:

With Django installed on your server, we can move on to creating a test project to make sure everything is working correctly. We’ll be creating a skeleton web application.

Заключение

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

Использование такого мощного веб-фреймворка,как Django, может ускорить процесс разработки, а также сосредоточить внимание исключительно на уникальных аспектах ваших приложений

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

Настройка Django через командную строку

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

Работаем с virtualenv

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

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

Запуск и просмотр проекта

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

Настройка ALLOWED_HOSTS

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

Development Version Install through git

Популярные веб-фреймворкина основе Python:

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

Установка Django в Ubuntu 18.04

Установка Python 3 и venv

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

Установка Django

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

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

Step 5 — Accessing the Django Web App

Установка Django через pipenv

Step 1 — Installing Django

Заключение