dotzero

↑ ↑ ↓ ↓ ← → ← → B A Start

Развертывание Node.js приложения на DotCloud

Dotcloud - это облачная платформа для развертывания приложений. Стек на DotCloud включает в себя более 10 различных сервисов среди которых есть и Node.js.

Мои первые впечатления от DotCloud были весьма положительные. Можно практически забыть о том как развертывать приложение и полностью сосредоточится на коде. Работа по развертыванию сводится к установке DotCloud CLI и настройке файла окружения dotcloud.yml. Установка клиента под Linux/MacOS тривиальна:

sudo easy_install pip
sudo pip install dotcloud

Подготовка к развертыванию

Для развертывания приложения на Dotcloud необходим файл dotcloud.yml, который описывает сервисы к которым приложение будет иметь доступ. Полный список приложений можно посмотреть по ссылке. Для доступа к стеку NodeJS + Redis файл dotcloud.yml может иметь следующий вид:

www:
  type: nodejs

data:
  type: redis

Если приложение на NodeJS использует дополнительные пакеты, то можно использовать файл package.json, в котором указать зависимости от других пакетов. Пакеты будут автоматически установлены при развертывании. Пример файла package.json:

{
  "engines": {
    "node": ">=v0.4.5"
  },
  "dependencies": {
    "redis": ">=0.6.6",
    "express": ">=2.4.2"
  }
}

Для автоматического запуска приложений на NodeJS необходимо создать третий файл с названием supervisord.conf и указать в нем путь запуска

[program:node]
command = node index.js
directory = /home/dotcloud/current

Использование environment.json

Получить доступ к стеку сервисов которые были указаны в файле dotcloud.yml очень просто. После развертывания приложения к домашней директории создается файл environment.json, содержащий информацию для доступа к сервисам. Используя этот файл можно настроить приложение для автоматического использования настроек к базам данных не заботясь о ручной настройке. Поскольку я указал Redis в качестве базы данных в файле dotcloud.yml и назвал его data, то для получения настроек к Redis из приложения на NodeJS достаточно написать:

var envfilepath = '/home/dotcloud/environment.json',
    environment = JSON.parse(require('fs').readFileSync(envfilepath));

var host = environment['DOTCLOUD_DATA_REDIS_HOST'],
    port = environment['DOTCLOUD_DATA_REDIS_PORT'],
    pass = environment['DOTCLOUD_DATA_REDIS_PASSWORD'];

Развертывание

Для создания приложения на Dotcloud необходимо написать в консоле:

dotcloud create appname

appname - в данном случае имя приложения, которое может быть любым. Ну и непосредственно пуш приложения на Dotcloud

dotcloud push appname ~/path-to-node-app/

При успешном деплое выдадут www адрес для доступа к приложению

Deployment finished successfully. Your application is available at the following URLs
www: http://d07c100d.dotcloud.com/

Что еще можно сделать

Использование собственного доменного имени. Для этого надо прописать DNS запись для соответствующего домена:

CNAME gateway.dotcloud.com.

И добавить алиас к своему приложению на Dotcloud:

dotcloud alias add appname.www www.example.com

Также можно подключится по SSH

dotcloud ssh appname.www

Полный список команд можно получить в подробной документации на официальном сайте.

Сокращатель ссылок на Node и Redis

Началось с того, что я решил попробовать Redis в каком-нить проекте, а поскольку давно планировал сделать собственную сокращалку ссылок, то решил именно ее и написать. Связка NodeJS + Redis вообще показалась наиболее легко реализуемой. Закончилось тем что помимо Redis написал еще и реализацию для MongoDB.

Не буду вдаваться в подробности сравнения MongoDB и Redis, на эту тему итак уже написано куча статей (Comparing MongoDB And Redis Part 1 и Part 2. Для реализации сокращалки Redis’а хватает за глаза, он вообще более дружественен и прост в реализации к такого рода задачам.

Скачать мой Node Url Shortener можно на Github.

Для установки надо подтянуть дополнительные пакеты из npm. Прежде всего это ExpressJS, а также пакет для работы с Redis или MongoDB.

git clone https://github.com/dotzero/node-url-shortener nus
cd nus
npm install

Далее надо отредактировать файл ./config.js и запустить app.js через NodeJS. Планирую пользовать исключительно через API, поэтому с веб-интерфейсом особо не заморачивался. Реализация API почти такая же как у goo.gl.

Для сокращения ссылок:

GET /api/v1/shorten/?long_url=http://www.google.com

JSON ответ

{
  status_code: 200
  status_txt: "OK"
  hash: "Mw"
  url: "http://localhost/Mw"
  long_url: "http://www.google.com"
}

И для разворачивания коротких ссылок

GET /api/v1/expand/?short_url=http://localhost/Mw