Как настроить приложение узла Koa.js в Ubuntu 16.04 LTS

• Краткое описание Node.js, Koa.js и Apache
• Настройка Node.js
• Настройка нашего каталога приложений
• Установка Koa.js
• Установка Apache
• Управление нашим приложением с помощью systemd
• Вывод

В этом руководстве мы узнаем, как настроить веб-приложение Koa.js для работы с использованием Node.js. Мы также будем связывать пример домена с обратным прокси-сервером с помощью Apache и узнаем, как управлять им с помощью правильного менеджера процессов. Без дальнейших церемоний, давайте начнем.

Краткое описание Node.js, Koa.js и Apache

Node.js - это быстрый кроссплатформенный фреймворк JavaScript, основанный на движке Chrome V8. Он используется в настольных и серверных приложениях и известен своей однопоточной обработкой цикла обработки событий. Node.js содержит реестр пакетов, называемый Node Package Manager (NPM), в котором размещено более полумиллиона пакетов. Пакеты NPM (или модули) являются основной основой Node.js, поскольку они представляют собой управляемый сообществом код, который может быть полезен в вашем приложении Node.js. В нашем приложении Koa.js Node.js является основной частью его функции.

Koa.js - это минималистичный веб-фреймворк, построенный на платформе Node.js. Созданная той же командой из популярного фреймворка Express.js, ее цель - еще больше минимизировать и без того минималистичный фреймворк Express.js, исключив промежуточное программное обеспечение из его ядра. Основной особенностью Koa.js является то, что обратных вызовов нет. Koa.js основан на генераторах на базе ES6 и функциях ES6, таких как Promises.

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

Настройка Node.js

Как и в любой среде Node.js, вам необходимо установить Node.js на VPS. Для этого урока я предполагаю, что у вас уже установлен Node.js в вашей системе. Если нет, вы можете просто следовать инструкциям здесь .

Настройка нашего каталога приложений

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

mkdir site

Не стесняйтесь заменить siteлюбое другое имя, которое вы хотели бы для каталога. Далее нам нужно инициализировать наш файл пакета Node.js. Перейдите в каталог, который вы только что создали, и запустите npm init, и выполните запросы. В итоге это должно выглядеть примерно так:

{
  "name": "site",
  "version": "1.0.0",
  "description": "Koa.js Site",
  "main": "index.js",
  "scripts": {
    "test": "echo \"Error: no test specified\" && exit 1"
  },
  "author": "yourname",
  "license": "ISC"
}

Установка Koa.js

Теперь, когда у нас есть настроенный каталог, мы можем приступить к установке Koa.js. В текущем рабочем каталоге /siteвведите следующее.

npm install koa

Это загрузит модуль Koa.js из NPM и установит его в наш каталог проектов для дальнейшего использования. Далее мы создадим наш пример файла приложения, который будет содержать код нашего приложения. Для этого создайте index.jsфайл.

nano index.js

Оказавшись внутри файла, создайте пример приложения.

const Koa = require('koa');
const app = new Koa();

app.use(async ctx => {
     ctx.body = 'Hello World';
 });

app.listen(3000);
console.log('Website is live!')

Сохраните и закройте файл. CTRL+ X.

Мы хотим убедиться, что наше приложение работает правильно. Чтобы запустить его, запустите node index.js, и вы увидите Website is liveв консоли.

Установка Apache

Теперь, когда мы знаем, что наш веб-сайт работает, мы можем приступить к установке Apache и его зависимостей.

sudo apt install -y libapache2-mod-proxy-html libxml2-dev

Чтобы использовать функцию обратного прокси в Apache, нам нужно включить необходимые модули.

a2enmod proxy
a2enmod proxy_http
a2enmod proxy_ajp
a2enmod rewrite
a2enmod deflate
a2enmod headers
a2enmod proxy_balancer
a2enmod proxy_connect
a2enmod proxy_html

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

Теперь нам нужно отредактировать файл конфигурации по умолчанию для Apache.

sudo nano /etc/apache2/sites-enabled/000-default.conf

Здесь нам нужно будет добавить блок для нашего приложения.

<VirtualHost *:*>
    ProxyPreserveHost On
    ProxyPass / http://0.0.0.0:3000/
    ProxyPassReverse / http://0.0.0.0:3000

    ServerName localhost
</VirtualHost>

Сохраните файл, CTRL+ X.

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

Как только изменения вступят в силу, нам нужно будет перезапустить Apache и перезапустить наше приложение Koa.js.

sudo systemctl restart apache2

Это гарантирует, что наш файл конфигурации активен и готов к работе, когда мы запустим наше приложение Koa.js. После перезапуска Apache вернитесь в каталог своего сайта и запустите приложение Koa.js, как мы делали ранее. В веб-браузере перейдите к http://yourdomainили или http://yourip:, и вы увидите «Hello World».

Управление нашим приложением с помощью systemd

Теперь, когда мы рассмотрели основы создания примера приложения Koa.js, мы понимаем, что в производственной среде запуск приложения таким, какой мы являемся сейчас, нецелесообразен. Менеджер процесса, безусловно, является обязательным требованием. Вот где Systemd вступает в игру. Проще говоря, systemd состоит из программного обеспечения, которое обеспечивает строительные блоки для системы Linux. Подобно «init», он предоставляет систему для управления пользовательскими процессами после запуска системы. В случае нашего приложения systemd позволяет нам автоматически запускать наш веб-сайт после перезагрузки системы, если происходит событие, которое нарушает работоспособность системы. Он также предоставляет набор инструментов, которые могут пригодиться при управлении нашим приложением. Самое приятное то, что он встроен в Ubuntu 16.04 LTS, поэтому нам не нужно устанавливать дополнительное программное обеспечение.

Создать сервис systemd

Все, что нам нужно для запуска нашего приложения, будет содержаться в файле с именем service. Он содержит информацию о нашем приложении, такую ​​как его имя, каталог, окружение и многое другое. Чтобы создать наш системный файл, откройте текстовый редактор.

sudo nano /lib/systemd/system/site.service

Отредактируйте и сохраните файл следующим образом.

[Unit]
Description=desc here
Documentation=https://example.com
After=network.target

[Service]
Environment=NODE_PORT=3000
Type=simple
User=youruser
ExecStart=/usr/bin/node /home/[youruser]/site/index.js
Restart=on-failure

[Install]
WantedBy=multi-user.target

Замените youruserна имя пользователя вашего сервера. Вот краткое изложение важных полей:

• After - Это сообщает systemd дождаться готовности сетевого интерфейса перед запуском нашего приложения.
• Environment- Здесь мы можем указать переменные среды для нашего приложения. Наш порт Node.js является одним из них.
• Type - Это сообщает systemd о том, что наше приложение можно просто запустить, не забывая пользовательские привилегии и тому подобное.
• User- Это говорит systemd, что мы хотим запустить приложение под нашей учетной записью, что рекомендуется. Запуск приложений от имени пользователя root может привести к многочисленным нарушениям безопасности.
• ExecStart - По сути, команда systemd будет запускать наше приложение, аналогично тому, как мы запускали его вручную.
• Restart- Сообщает systemd, при каких условиях перезапустить наше приложение. В этом случае мы хотим перезапустить наш сайт в случае ошибки.

Запустите сервис systemd

Теперь мы готовы запустить наш сервис systemd.

sudo systemctl daemon-reload

Это необходимо всякий раз, когда изменяется файл службы systemd, чтобы systemd регистрировал любые новые изменения.

Затем запустите ваше приложение.

sudo systemctl start site

Перейдите на сайт в вашем браузере еще раз, чтобы убедиться, что все работает.

Основные функции управления systemd

• stop - Останавливает приложение полностью.
• restart - Останавливает приложение и запускает его снова под новым процессом.
• enable - Сообщает systemd запускать приложение при каждом запуске компьютера.
• status - Показывает информацию о текущем запущенном приложении, например, время работы, состояние приложения и многое другое.

Чтобы использовать любую из этих функций, выполните следующее.

systemctl <function> site

Вывод

Мы успешно настроили приложение Koa.js и научились обращать его через прокси, а также управлять им с помощью systemd. Теперь вы готовы расширить свое приложение и использовать этот пример. Если вы хотите больше узнать о Koa.js и о том, что вы можете сделать, посетите их веб-сайт для получения более полезной информации. В дополнение к этому, если вы хотите больше узнать о менеджере процессов systemd, прочитайте документацию по нему здесь . Наконец, если вы хотите узнать больше об обратном прокси-сервере Apache, не стесняйтесь проверить их здесь .