Введение

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

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

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. установленный sbt или activator.

Установка

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

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

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

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

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

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

Приложение в примере создано с помощью фреймворка Play.

Теперь у вас есть действующий git репозиторий, который включает в себя простое приложение и файл build.sb, который используется менеджером зависимостей Scala, sbt.

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

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

Как Dokkur понимает, что приложение написано на Scala? Ответ простой - по наличию файла build.sbt в корневой директории.

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

name := """play-getting-started"""
version := "1.0-SNAPSHOT"
lazy val root = (project in file(".")).enablePlugins(PlayScala)
scalaVersion := "2.11.1"
libraryDependencies ++= Seq(
jdbc,
cache,
ws
)

Файл build.sbt - это спецификация того, какие зависимости должны быть установлены вместе с приложением. Когда приложение опубликовано, Dokkur считывает файл и устанавливает все, что нужно, с помощью команды sbt compile stage.

Другой файл, system.properties, определяет какую версию Java надо использовать. Содержание этого файла, что является опциональным, обычно выглядит так:

java.runtime.version=1.8

Запусти команду sbt compile stage в локальной директории, чтобы установить зависимости, тем самым помочь подготовить систему для локального запуска приложения.

$ sbt compile stage
[info] Loading project definition from /private/tmp/play-getting-started/project
[info] Updating
{file:/private/tmp/play-getting-started/project/}play-getting-started-build...
[info] Resolving org.fusesource.jansi#jansi;1.4 ...
[info] Done updating.
[info] Set current project to play-getting-started (in build
file:/private/tmp/play-getting-started/)
[info] Updating {file:/private/tmp/play-getting-started/}root...
[info] Resolving jline#jline;2.11 ...
...
[info] Done packaging.
[info] Packaging
/private/tmp/play-getting-started/target/play-getting-started-1.0-SNAPSHOT-assets.jar ...
[info] Done packaging.
model contains 19 documentable templates
[info] Main Scala API documentation successful.
[info] Packaging
/private/tmp/play-getting-started/target/scala-2.11/play-getting-started_2.11-1.0-SNAPSH
OT-javadoc.jar ...
[info] Done packaging.
[success] Total time: 7 s, completed Apr 15, 2015 2:53:03 PM

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

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

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

  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-scala
  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 в браузере.