Развертывание приложения на языке Clojure на PaaS

Введение

Это описание покажет вам, как развернуть 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 в браузере.