Введение

Это описание покажет вам, как развернуть Python приложение в течение нескольких минут. Эти инструкции также дадут вам достаточно информации, чтобы использовать Dokkur наилучшим образом.

Убедитесь, что у вас уже есть:

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. Python версии 2.7, установленный локально. - следуй инструкциям по установке на OS X, Windows, и Linux.
  4. Setuptools и Pip, установленные локально. Следуй инструкциям по установке Python (см. выше).
  5. Virtualenv, установленный локально. Выполни это с помощью команды pip install virtualenv.
  6. Нужная СУБД, установленная локально для локального запуска приложения.

Установка

На этом шаге вы должны установить Dokkur Toolbelt, что даст вам доступ к Dokkur Command Line Interface (CLI).

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

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

Чтобы опубликовать приложение, это приложение должно быть готово к публикации.

Если у вас нет своего Python проекта, то вы можете использовать шаблон, который мы подготовили для вас:

$ git clone https://github.com/dokkur/python-getting-started.git
$ cd python-getting-started

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

Если у вас все же есть свое Python приложение, которое вы хотите опубликовать, то вам надо провести небольшую подготовку.

Объявление зависимостей приложения

Как Dokkur понимает, что приложение написано на Python? Ответ простой - по наличию файла requirements.txt в корневой директории. Вы можете создать его, запустив команду pip freeze.

Обычно этот файл выглядит вот так:

dj-database-url==0.4.0
Django==1.9.2
gunicorn==19.4.5
psycopg2==2.6.1
whitenoise==2.0.6

Файл requirements.txt перечисляет зависимости приложения и их версии. Когда приложение опубликовано, Dokkur считывает файл и устанавливает все, что нужно, с помощью команды pip install -r requirements.txt.

Чтобы сделать это локально, создайте virtualenv для приложения:

$ virtualenv venv

Затем, активируйте virtualenv.
Если вы используете Windows, выполните эту команду:

> venv\Scripts\activate.bat

Если вы не используете Windows, выполните эту команду:

$ source venv/bin/activate

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

$ pip install -r requirements.txt
Downloading/unpacking Django==1.9.2 (from -r requirements.txt (line 1))
Downloading Django-1.9.2.tar.gz (6.6MB): 6.6MB downloaded
Running setup.py egg_info for package Django
...
Successfully installed dj-database-url Django gunicorn psycopg2 whitenoise
Cleaning up...

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

Создание приложения

Следуй инструкции:

  1. Отрой личный кабинет, перейди в раздел Personal apps (левое меню)
  2. Нажми на кнопку ⨁, чтобы открыть интерфейс New App
  3. Введи название приложения (Внимание! Используй только латинские буквы в нижнем регистре и цифры, например, myapp007), выбери доступный и подходящий инстанс для хранения, выбери шаблон Custom App и нажми на кнопку Create App.

Поздравляю! Ваше приложение создано. А сейчас надо его опубликовать. Поехали!

Добавление переменной окружения BUILDPACK_URL

  1. Перейдите в раздел Settings, в секции Environment variables нажмите на кнопку Edit.
  2. Выберите ADD NEW VARIABLE
  3. В поле Name напишите BUILDPACK_URL
  4. В поле VALUE вставьте
    https://github.com/dokkur/buildpack-python
  5. Нажмите Save

Публикация приложения

  1. Перейди в раздел Settings, скопируй git url из секции Git URL.
  2. Перейди в Dokkur Toolbelt и запусти следующую команду:

    git remote add dokkur git_url
    Вместо git_url вставь ссылку, которую скопировал из веб-версии.

  3. Запушь свое приложение:
    git push dokkur master
    Если хочешь опубликовать в другую ветку, то:
    git push dokkur yourbranch:master

Ура! Твое приложение опубликовано! Перейди по ссылке yourappname.dokkurapp.com в браузере.