Базовая установка

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

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

Установка зависимостей

Drapo написан на третьей версии питона (см. https://python.org для подробностей), поэтому необходимо установить сам питон, менеджер питоновских пакетов pip и (опционально) инструмент для виртуальных окружений virtualenv. Кроме того, вам понадобится git, чтобы склонировать репозиторий с Drapo.

apt install python3 python3-pip python-virtualenv git

Подготовка окружения

Пропустите этот шаг, если вы запускаете Drapo для локального тестирования. Создание отдельного пользователя приветствуется для установки Drapo на боевых серверах.

Создадим пользователя, из-под которого будем запускать Drapo:

useradd -m -g www-data drapo

Мы добавили пользователя в группу www-data, так как от этого пользователя будет работать и веб-сервер.

Дальнейшие команды нужно выполнять от имени пользователя drapo и в его домашней директории (по умолчанию это /home/drapo):

su drapo
cd ~

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

Этот шаг можно пропустить, если вы уверены, что вам не нужно виртуальное окружение. Мы рекомендуем использовать окружение всегда, даже для локального запуска и тестирования.

Создаём и активируем окружение:

virtualenv -p /usr/bin/python3 venv
source venv/bin/activate

Скачиваем Drapo

Клонируем репозиторий с помощью git:

git clone [email protected]:andgein/drapo.git

По умолчанию он окажется в папке /home/drapo/drapo.

Устанавливаем питоновские зависимости проекта

pip install -U -r drapo/src/web/requirements.txt

Настройка базы данных

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

О настройке баз данных в Drapo читайте в статье «Конфигурация базы данных». Если вам достаточно sqlite3 базы данных, оставьте всё как есть.

Чтобы Drapo смог запуститься, в базе данных должны появиться необходимые таблицы и записи. Для этого выполните так называемые миграции:

./drapo/src/web/manage.py migrate

Обратите внимание, что если вы создали виртуальное окружение, то все команды, так или иначе связанные с питоном, нужно выполнять внутри этого окружения. Сюда входят команды pip install ... и запуски manage.py. Обычно, когда вы находитесь внутри виртуального окружения, в вашей командой строке в скобках написано имя окружения, например:

(venv) ~/drapo

Отлично, Drapo установлен!

Создайте себе супер-пользователя (администратора):

./drapo/src/web/manage.py createsuperuser.

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

./drapo/src/web/manage.py runserver

Она запустит локальный сервер для тестирования на порту 8000. Зайдите в браузере на http://127.0.0.1:8000, чтобы увидеть результат.

Если вам нужно сделать доступным Drapo для пользователей, нужно использовать промышленный веб-сервер (например, nginx или Apache). Подробную инструкцию о том, как настроить Drapo с nginx, смотрите [здесь](Настройка Drapo, uwsgi и nginx).