Введение
Это описание покажет вам, как развернуть Clojure приложение в течение нескольких минут. Эти инструкции также дадут вам достаточно информации, чтобы использовать Dokkur наилучшим образом.
Убедитесь, что у вас уже есть:
- Dokkur аккаунт.
- SSH ключи, добавленные в ваш аккаунт.
- Clojure и Leiningen, установленные локально.
Установка
На этом шаге вы должны установить Dokkur Toolbelt, что даст вам доступ к Dokkur Command Line Interface (CLI).
После установки вы сможете использовать команду dokkur login, чтобы авторизоваться с помощью вашей почты и пароля, которые вы вводили при регистрации.
Подготовка приложения
Чтобы опубликовать приложение, это приложение должно быть готово к публикации.
Если у вас нет своего Clojure проекта, то вы можете использовать шаблон, который мы подготовили для вас:
$ git clone https://github.com/dokkur/clojure-getting-started.git
$ cd clojure-getting-started
Если у вас все же есть свое Clojure приложение, которое вы хотите опубликовать, то вам надо провести небольшую подготовку.
Объявление зависимостей приложения
Как Dokkur понимает, что приложение написано на Clojure? Ответ простой - по наличию файла project.clj в корневой директории.
Обычно этот файл выглядит вот так:
(defproject clojure-getting-started "1.0.0-SNAPSHOT"
:description "Demo Clojure web app"
:url "http://clojure-getting-started.herokuapp.com"
:license {
:name "Eclipse Public License v1.0"
:url "http://www.eclipse.org/legal/epl-v10.html"
}
:dependencies [
[org.clojure/clojure "1.6.0"]
[compojure "1.4.0"]
[ring/ring-jetty-adapter "1.4.0"]
[environ "1.0.0"]
]
:min-lein-version "2.0.0"
:plugins [
[environ/environ.lein "0.3.1"]
]
:hooks [environ.leiningen.hooks]
:uberjar-name "clojure-getting-started-standalone.jar"
:profiles {
:production {
:env {
:production true
}
}
}
)
Файл project.clj - это спецификация того, какие именно зависимости должны быть установлены вместе с приложением, а также какая версия Clojure используется.
Создание приложения
Следуй инструкции:
- Отрой личный кабинет, перейди в раздел Personal apps (левое меню)
- Нажми на кнопку ⨁, чтобы открыть интерфейс New App
- Введи название приложения (Внимание! Используй только латинские буквы в нижнем регистре и цифры, например, myapp007), выбери доступный и подходящий инстанс для хранения, выбери шаблон Custom App и нажми на кнопку Create App.
Поздравляю! Ваше приложение создано. А сейчас надо его опубликовать. Поехали!
Добавление переменной окружения BUILDPACK_URL
- Перейдите в раздел Settings, в секции Environment variables нажмите на кнопку Edit.
- Выберите ADD NEW VARIABLE
- В поле Name напишите BUILDPACK_URL
- В поле VALUE вставьте
https://github.com/dokkur/buildpack-clojure
- Нажмите Save
Публикация приложения
- Перейди в раздел Settings, скопируй git url из секции Git URL.
- Перейди в Dokkur Toolbelt и запусти следующую команду:
git remote add dokkur git_url
Вместо git_url вставь ссылку, которую скопировал из веб-версии. - Запушь свое приложение:
git push dokkur master
Если хочешь опубликовать в другую ветку, то:git push dokkur yourbranch:master
Ура! Твое приложение опубликовано! Перейди по ссылке yourappname.dokkurapp.com в браузере.