Введение

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

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

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. Java 8, установленный локально.
  4. Maven 3, установленный локально.

Установка

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

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

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

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

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

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

Теперь у вас есть действующий git репозиторий, который включает в себя простое приложение и файл pom.xml, который используется менеджером зависимостей Java, Maven.

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

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

Как Dokkur понимает, что приложение написано на Java? Ответ простой - по наличию файла pom.xml в корневой директории. Вы можете создать его, запустив команду mvn archetype:create.

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

  <dependencies>
<dependency>
<groupId>com.sparkjava</groupId>
<artifactId>spark-core</artifactId>
<version>2.2</version>
</dependency>
<dependency>
<groupId>com.sparkjava</groupId>
<artifactId>spark-template-freemarker</artifactId>
<version>2.0.0</version>
</dependency>
...
</dependencies>

Файл pom.xml перечисляет зависимости и их версии. После публикации приложения Dokkur считывает этот файл и устанавливает нужные Java зависимости с помощью команды mvn clean install.

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

java.runtime.version=1.8

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

$ mvn clean install
[INFO] Scanning for projects...
[INFO]
[INFO] ------------------------------------------------------------------------
[INFO] Building helloworld 1.0-SNAPSHOT
[INFO] ------------------------------------------------------------------------
[INFO]
...
Downloading: http://repo.maven.apache.org/maven2/org/apache/maven/maven-archiver/2.5/maven-archiver-2.5.pom
Downloaded: http://repo.maven.apache.org/maven2/org/apache/maven/maven-archiver/2.5/maven-archiver-2.5.pom (5 KB at 14.9 KB/sec)
...
[INFO] ------------------------------------------------------------------------
[INFO] BUILD SUCCESS
[INFO] ------------------------------------------------------------------------
[INFO] Total time: 5.584s
[INFO] Finished at: 2015-07-06T09:52:33+01:00
[INFO] Final Memory: 19M/222M
[INFO] ------------------------------------------------------------------------

Если у вас не установлен Maven, или вы получаете ошибку типа “‘mvn’ is not recognized as an internal or external command”, в этом случае вы можете использовать команду-обертку mvnw clean install на Windows или ./mvnw clean install на Mac и Linux. Она и установит Maven, и запустит команду Maven.
Этот процесс копирует зависимости приложения в дииректорию target/dependency. Это называется “vendoring”, и оно исполняется с помощью плагина в файле pom.xml.

<plugin>
<groupId>org.apache.maven.plugins</groupId>
<artifactId>maven-dependency-plugin</artifactId>
<version>2.4</version>
<executions>
<execution>
<id>copy-dependencies</id>
<phase>package</phase>
<goals><goal>copy-dependencies</goal></goals>
</execution>
</executions>
</plugin>

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

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

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

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