Введение

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

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

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. Ruby 2.2.4, установленная локально - следуй инструкциям по установке Ruby и Rails на OS X, Windows и Linux.
  4. Bundler, установленный локально - запусти команду gem install bundler.

Установка

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

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

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

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

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

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

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

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

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

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

source 'https://rubygems.org'
ruby '2.2.4'

# Bundle edge Rails instead: gem 'rails', github: 'rails/rails'
gem 'rails', '4.2.0'
# Use postgresql as the database for Active Record
gem 'pg'
gem 'rails_12factor', group: :production
# Use SCSS for stylesheets
gem 'sass-rails', '~> 4.0.3'
# Use Uglifier as compressor for JavaScript assets
gem 'uglifier', '>= 1.3.0'
...

Файл Gemfile - это спецификация того, какие зависимости должны быть установлены вместе с приложением. В нет также можно обозначить, какую версию Ruby надо использовать, чтобы запустить приложение на Dokkur.

Когда приложение опубликовано, Dokkur считывает файл и устанавливает все, что нужно, с помощью команды bundle install.

Внимание! До того, чтобы запустить приложение локально, надо установить зависимости так же локально. В файле Gemfile могут быть зависимости, связанные с определенной базой данных, которые может использоваться только в случае установленной нужной СУБД. Пожалуйста, установите её, прежде чем переходить к следующим шагам.

Теперь выполните команду bundle install в локальной директории, чтобы приготовить систему к локальному запуску приложения:

$ bundle install
Using rake 10.4.2
Using i18n 0.7.0
Using json 1.8.2
....
Using puma 2.9.1
Your bundle is complete!

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

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

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

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