Введение

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

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

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. Go 1.6+, установленный локально.
  4. $GOPATH/bin, добавленный в $PATH.

Установка

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

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

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

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

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

Выполни следующие команды, чтобы локально собрать воедино приложение, скомпилировать и установить сгенерированные исполняемые файлы в $GOPATH/bin.

$ go get github.com/dokkur/go-getting-started

Теперь у вас есть функционирующий git репозиторий с простым приложением.

Остальные команды в инструкции должны быть выполнены в корневой директории приложения, которая расположена внутри $GOPATH, выполни следующее:

$ cd $GOPATH/src/github.com/dokkur/go-getting-started

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

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

Как Dokkur понимает, что приложение написано на Go? Ответ простой - по наличию файла Godeps.json в директории Godeps, которая находится в корневой директории приложения.

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

$ cat Godeps/Godeps.json
{
"ImportPath": "github.com/heroku/go-getting-started",
"GoVersion": "go1.6",
"GodepVersion": "v74",
"Deps": [
{
"ImportPath": "github.com/gin-gonic/gin",
"Comment": "v1.0rc1-110-g4cc2de6",
"Rev": "4cc2de6207f4128624cbdd16be30f64966c67c08"
},
...
]
}

Файл Godeps/Godeps.json используется Godep и является спецификации зависимостей, который используются в прижении, и версии Go, чтобы скомпилировать приложение. В этом примере файла Godeps/Godeps.json перечислены зависимости, связанные с преимущественно Gin, HTTP фреймворком.

После публикации приложения Dokkur считывает этот файл, устанавливает нужную версию Go и компилирует код с помощью команды go install ..

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

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

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