Web-разработка на node.js и express. Изучаем node.js на практике

в 19:58, , рубрики: express, javascript, node.js, tutorial, web-разработка, метки: , , , ,

Предисловие

Пришла мне в голову смелая мысль, взяться за написание туториала по разработке на node.js (что-то наподобие ruby.railstutorial.org). Так как я первый раз берусь за подобный труд то для для меня очень важен любой фидбэк. Нужно это — не нужно. Что стоит убрать а на чем остановиться подробнее, в общем любая конструктивная критика. Надеюсь что дело пойдет и вам понравится, в этом случае по мере написания буду выкладывать главы на хабр.

Вступление

Приветствую, перед вами небольшой учебник по практической разработке на node.js, с использованием фреймворка express. Я с большим энтузиазмом отношусь к node и сопутствующим технологиям. Node.js в первую очередь привлекает свежестью в подходах к разработке, смелостью и драйвом.

О том, что такое node.js вы можете прочитать на http://nodejs.org/, если коротко — то это серверная платформа, для выполнения javascript. Так же мы будем использовать express, web-фреймворк построеный на концепции middleware (о том, что это такое, поговорим поподробнее чуть позже)

В процессе изучения мы познакомимся с различными аспектами web-разработки, такими как использование системы контроля версий, автоматическое тестирование и так далее. В результате по ходу изучения мы разработаем вполне рабочее web-приложение (простенький аналог твиттера)

Хочется отметить, что очень большое влияние на меня оказал railstutorial, это лучшее пособие по web-разработке, которое я встречал, и мне очень хотелось бы создать нечто подобное для node.js.

Глава 1. Старт

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

1.1 Рабочее окружение

Так как я в основном использую в работе linux, а если точнее — Ubuntu 12.04, основная часть инструкций по установке тех или иных инструментов будет ориентирована на ползователей линукс, но я буду стараться по возможности давать ссылки на инструкции и для других ОС.

Для того чтобы точно следовать инструкциям в учебнике, вам нужно будет поставить систему контроля версий git, дело в том, что мы не только будем размещать код своих проектов в git, но и устанавливать многие инструменты из репозиториев на гитхабе.

Так что, первое что мы сделаем — это…

1.1.1 Установка git

Пользователи apt-based дистрибутивов могут выполнить в терминале:

$ sudo apt-get install git-core

Остальные отправляются читать инструкции по адресу http://git-scm.com/book/ch1-4.html

1.1.2 Установка node.js и npm

Теперь пришло время поставить последнюю стабильню версию node.js (на текущий момент это 0.8.1) и npm (установщик пакетов для node).

Инструкции по установке разных ОС можно найти здесь

Для начала устанавливаем все что необходимо для компиляции пакета из исходников:

$ sudo apt-get install python g++ curl libssl-dev apache2-utils

Теперь скачиваем исходный код:

$ cd /tmp
$ git clone https://github.com/joyent/node.git
$ cd node
$ git checkout v0.8.1

Посделний этап — компиляция и установка:

$ ./configure
$ make
$ sudo make install

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

$ node -v
v0.8.1
$ npm -v
1.1.33

Если есть желание — можно запустить консоль node и поиграться с интерпретатором javascript.

1.1.3 Среда разработки

Тут каждый волен выбирать по своему вкусу, лично меня вполне устраивает gedit с установленным набором плагинов gmate. Вполне подходят Netbeans или Webstorm.

1.1.4 Express и первое приложение

Теперь пришло время познакомиться с фреймворком express. Фреймворк очень простой, и вполне приемлемо документированный. Единственный неудобный момент — это то, что мы будем использовать бета версию 3.0.x а документация на официальном сайте написана для 2.x, так что советую иметь под рукой migration guide

Устанавливаем express глобально:

$ sudo npm install -g express@3.0

Создаем директорию для наших учебных проектов:

$ mkdir -p ~/projects/node-tutorial
$ cd ~/projects/node-tutorial

Создаем проект и устанавливаем зависимости:

$ express node-demo-app
$ cd hello && npm node-demo-app

Теперь можно заглянуть в то что нам сгенерировал генератор приложений, вот внутренности app.js:

/**
 * Module dependencies.
 */

var express = require('express')
  , routes = require('./routes')
  , http = require('http');

var app = express();

app.configure(function(){
  app.set('port', process.env.PORT || 3000);
  app.set('views', __dirname + '/views');
  app.set('view engine', 'jade');
  app.use(express.favicon());
  app.use(express.logger('dev'));
  app.use(express.bodyParser());
  app.use(express.methodOverride());
  app.use(app.router);
  app.use(express.static(__dirname + '/public'));
});

app.configure('development', function(){
  app.use(express.errorHandler());
});

app.get('/', routes.index);

http.createServer(app).listen(app.get('port'), function(){
  console.log("Express server listening on port " + app.get('port'));
});

Думаю, что люди знакомые с javascript могут предположить что тут происходит. Подключаются необходимые модули, конфигурируется приложение и запускается на 3000-м порту.

Теперь приложение можно запустить:

$ node app

И увидеть результат работы http://localhost:3000/

1.2 Система контроля версий

Теперь, когда у нас уже есть рабочее приложение, более подробно коснемся работы с сисемой контроля версий. Для того чтобы лучше познакомиться с работой git, стоит почитать книжку Pro Git, но можно и обойтись инструкциями в данном учебнике.

1.2.1 Настройка git

Для более комфортной работы с git стоит сначала указать свои личные данные:

$ git config --global user.name "Your Name"
$ git config --global user.email your.email@example.com

И настроить алиасы для наиболее часто используемых комманд:

$ git config --global alias.co checkout
$ git config --global alias.ci commit

1.2.2 Работа с git

Git настроен и можно размещать наше приложение в репозитории, инициализируем новый репозиторий:

$ git init

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

$ echo '/node_modules' > .gitignore

Помещаем все файлы в индекс и создаем первый коммит:

$ git add .
$ git ci -m "Initial commit"

1.2.3 github

После размещения кода проекта в репозитории пришло время выложить проект на GitHub. GitHub — это социальная сеть и хостинг для проектов. Огромное число opensource проектов хостится на гитхабе, так что если вы там еще не зарегистрированы — самое время сделать это (возможно вам придется сначала разобраться с ssh ключами)

Создаем новый репозиторий node-demo-app.

Выкладываем код на гитхаб:

$ git remote add origin git@github.com:ваш_ник_на_гитхабе/node-demo-app.git
$ git push -u origin master

1.3 Разворачиваем приложение

Теперь наступает самый волнующий этап, мы будем разворачивать приложение на хостинге.
Для этого воспользуемся услугами облачной системы деплоя Heroku.

1.3.1 Настройка Heroku

Для начала нам надо зарегистрироваться и установить необходимый инструментарий.

Пользователи ubuntu выполняют:

$ wget -qO- https://toolbelt.heroku.com/install.sh | sh

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

$ heroku login

1.3.2 Размещаем приложение на heroku

Теперь наше окружение полностью готов к выкладке на хостинг. Размещение node.js проекта на Heroku требует еще нескольких действий, вы можете почитать об этом в документации или просто выполнить инструкции.

В файле package.json нашего проекта, нужно указать версии ноды и npm, package.json должен выглядеть так:

{
  "name": "application-name",
  "version": "0.0.1",
  "private": true,
  "scripts": {
    "start": "node app"
  },
  "dependencies": {
    "express": "3.0.0beta4",
    "jade": "*"
  },
  "engines": {
    "node": "0.8.x",
    "npm": "1.1.x"
  }
}

Теперь в корне проекта создаем файл Procfile:

$ echo 'web: node app.js'  > Procfile

Проверяем что все запускается с помощью менеджера процессов:

$ foreman start

Приложение должно быть доступно на http://localhost:5000/

Добавляем файлы в репозиторий:

$ git add .
$ git ci -m "Added Procfile and engines"
$ git push

Создаем приложение на heroku:

$ heroku create
$ git push heroku master

Набираем:

$ heroku open

и любуемся задеплоеным приложением.

Автор: f0rk

* - обязательные к заполнению поля