Введение

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

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

  1. Dokkur аккаунт.
  2. SSH ключи, добавленные в ваш аккаунт.
  3. Node.js и npm, установленные локально.

Установка

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

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

Прежде, чем двигаться дальше, проверьте, что установка Node.js и npm прошла успешно. Выполните каждую команду (см. ниже) и убедитесь, что отображается именно та версия, которую вы установили (ваши версии могут отличаться от тех, что показаны в примерах). Если команды ничего не возвращают, то вернитесь к инструкциям по установке (см. выше).

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

Эти инструкции актуальны для каждой версии Node начиная с 4-й - проверить можно так:

$ node -v
v5.9.1

npm устанавливается вместе с Node, но все равно проверьте. Если npm нет, то установите более позднюю версию Node:

$ node -v
3.7.3

Теперь проверьте, установлен ли git. Если нет, то установите и проверьте еще раз.

$ git --version
git version 2.2.1

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

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

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

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

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

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

Как Dokkur понимает, что приложение написано на Node.js? Ответ простой - по наличию файла package.json в корневой директории. Вы можете создать его, запустив команду npm init --yes.

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

{
"name": "node-js-getting-started",
"version": "0.2.5",
...
"engines": {
"node": "5.9.1"
},
"dependencies": {
"ejs": "2.4.1",
"express": "4.13.3"
},
...
}

Файл package.json - это не только спецификация того, какие зависимости должны быть установлены с приложением, но и указатель того, какую версию Node.js надо использовать, чтобы запустить приложение на Dokkur. Когда приложение опубликовано, Dokkur считывает файл и устанавливает все, что нужно, с помощю команды npm install.

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

$ npm install
npm http GET https://registry.npmjs.org/express
npm http 304 https://registry.npmjs.org/express
npm http GET https://registry.npmjs.org/stream-spigot
npm http GET https://registry.npmjs.org/connect/2.12.0
...
express@4.13.3 node_modules/express
+---methods@0.1.0
+---merge-descriptors@0.0.1
+---range-parser@0.0.4
+---cookie-signature@1.0.1
+---debug@2.0.0
+---fresh@0.2.0
+---buffer-crc32@0.2.1
+---cookie@0.1.0
+---mkdirp@0.3.5
+---send@0.9.2 (destroy@1.0.3, ms@0.6.2, mime@1.2.11)
...

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

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

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

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