Как использовать PostgreSQL с Django в Ubuntu 22.04

Django — гибкий фреймворк для быстрого создания приложений на Python. По умолчанию в качестве базы данных он использует SQLite. Это хорошо работает при небольших нагрузках, однако традиционная система управления базами данных может повысить производительность в рабочей среде. Команда курса Слёрм «Python-разработчик» подготовила перевод, как использовать PostgreSQL с Django.

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

Сначала обновим кэш менеджера пакетов с помощью apt:

Затем установим необходимые компоненты: pip (менеджер пакетов Python), Postgres и связанные с ним библиотеки:

Теперь можем переходить к созданию базы данных.

По умолчанию Postgres использует схему «одноранговой аутентификации» для локальных подключений. Это значит, что если имя пользователя операционной системы совпадает с действительным именем пользователя Postgres, этот пользователь может войти в систему без дополнительной аутентификации.

Во время установки Postgres был создан пользователь операционной системы с именем postgres, соответствующий пользователю-администратору postgres. Нужно использовать этот пользовательский postgres для выполнения административных задач. Применим sudo для передачи имени пользователя postgres вместе с параметром -u.

Войдём в интерактивную строку Postgres:

Затем создадим базу данных для проекта Django. По соображениям безопасности каждый проект должен иметь собственную изолированную базу данных. В этой статье база данных называется myproject, но в работе рекомендуем давать ей более описательные названия. Также обращаем внимание на то, что важно не забывать заканчивать команды в командной строке SQL точкой с запятой — ; :

Создадим пользователя базы данных, который будет подключаться к БД и взаимодействовать с ней. Установим надёжный пароль:

После изменим несколько параметров подключения для созданного пользователя. Это позволит ускорить операции с базой данных, благодаря чему не придётся запрашивать и устанавливать правильные значения каждый раз при установлении соединения. Сначала установим кодировку по умолчанию на UTF-8:

Затем установим схему изоляции транзакций по умолчанию на чтение с фиксацией, блокирующее чтение из незафиксированных транзакций:

Установим часовой пояс. По умолчанию в проекте Django настроено использование UTC:

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

Выйдем из командной строки SQL, чтобы вернуться в сеанс пользователя postgres:

Теперь можем переходить к установке Django.

Для большей гибкости установим Django и все его зависимости в виртуальной среде Python.

Virtualenv — инструмент, который позволяет создавать изолированные среды для отдельных проектов Python и тем самым решает проблему зависимостей и совместимости приложений разных версий. Установим его с помощью команды:

Затем создадим каталог для хранения проекта Django:

И переместимся в каталог:

Теперь можем создать виртуальную среду для хранения зависимостей Python проекта Django:

Команда установит локальную копию Python и pip в каталог с именем myprojectenv в каталоге вашего проекта.

Прежде чем устанавливать приложения виртуальной среде, её нужно активировать. Это можно сделать с помощью команды:

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

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

Теперь можем запустить проект Django в каталоге myproject. Это создаст дочерний каталог с тем же именем для хранения кода, а также сценарий управления в текущем каталоге.

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

В нижней части файла есть раздел DATABASES, который в настоящее время настроен на использование SQLite:

Нужно изменить это, чтобы использовать Postgres.

Во-первых, изменим движок так, чтобы он использовал адаптер postgresql вместо серверной части sqlite3. В качестве NAME укажем имя базы данных. Затем добавим учётные данные для входа — имя пользователя, пароль и хост для подключения. Параметр port оставим пустым, чтобы было выбрано значение по умолчанию:

Также необходимо настроить директиву ALLOWED_HOSTS. Она определяет список адресов или доменных имен, разрешённых для подключения к инстансу Django. Любые входящие запросы с заголовком Host, которых нет в этом списке, будут исключены. Это необходимо для предотвращения уязвимостей в системе безопасности.

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

Добавим доменные имена и IP-адреса сервера Django следующим образом: ALLOWED_HOSTS = [ 'your_domain', '203.0.113.5']. Если хотите ответить на your_domain и любые поддомены, начните домен с точки : ALLOWED_HOSTS = ['.your_domain', '203.0.113.5'].

Например:

Когда закончите, сохраните и закройте файл. Если используете nano, нажмите CTRL+X, затем y и затем ENTER.

Начнём с создания и применения миграций к базе данных. Поскольку у нас ещё нет никаких данных, это настроит первоначальную структуру базы данных. Убедимся, что мы находимся в каталоге myproject:

Затем выполним и применим миграцию:

После создания структуры базы данных создадим учётную запись администратора:

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

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

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

В веб-браузере перейдём на доменное имя или IP-адрес сервера, за которым следует :8000:

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

Введём имя пользователя и пароль, которые создали с помощью команды createsuperuser. И попадём в интерфейс администратора:

Чтобы остановить сервер разработки, нажмите CTRL + C в окне терминала.

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

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