Ubuntu 16.04で実稼働用にNode.jsアプリケーションをセットアップする方法

前書き

Node.jsは、サーバーサイドおよびネットワーキングアプリケーションを簡単に構築するためのオープンソースJavaScriptランタイム環境です。 プラットフォームは、Linux、OS X、FreeBSD、およびWindowsで動作します。 Node.jsアプリケーションはコマンドラインで実行できますが、サービスとして実行することに重点を置いているため、再起動または障害が発生すると自動的に再起動し、運用環境で安全に使用できます。

このチュートリアルでは、単一のUbuntu 16.04サーバーでの実稼働対応Node.js環境のセットアップについて説明します。 このサーバーはPM2によって管理されるNode.jsアプリケーションを実行し、ユーザーにNginxリバースプロキシを介したアプリケーションへの安全なアクセスを提供します。 Nginxサーバーは、Let’s Encryptが提供する無料の証明書を使用してHTTPSを提供します。

前提条件

このガイドでは、次のものがあることを前提としています。

前提条件を完了すると、サーバーがデフォルトのNginxプレースホルダーページを* https:/// *で提供します。

サーバーにNode.jsランタイムをインストールすることから始めましょう。

Node.jsをインストールする

NodeSourceパッケージアーカイブを使用して、Node.jsの最新のLTSリリースをインストールします。

まず、NodeSource PPAをインストールして、そのコンテンツにアクセスする必要があります。 ホームディレクトリにいることを確認し、 `+ curl +`を使用してNode.js 6.xアーカイブのインストールスクリプトを取得します。

cd ~
curl -sL https://deb.nodesource.com/setup_6.x -o nodesource_setup.sh

このスクリプトの内容は、 + nano +(または好みのテキストエディター)で検査できます。

nano nodesource_setup.sh

そして、 `+ sudo +`の下でスクリプトを実行します:

sudo bash nodesource_setup.sh

PPAが構成に追加され、ローカルパッケージキャッシュが自動的に更新されます。 nodesourceからセットアップスクリプトを実行した後、上記と同じ方法でNode.jsパッケージをインストールできます。

sudo apt-get install nodejs

`+ nodejs `パッケージには、 ` nodejs `バイナリと ` npm `が含まれているため、 ` npm `を個別にインストールする必要はありません。 ただし、一部の ` npm `パッケージ(ソースからコードをコンパイルする必要があるパッケージなど)を機能させるには、 ` build-essential +`パッケージをインストールする必要があります。

sudo apt-get install build-essential

Node.jsランタイムがインストールされ、アプリケーションを実行する準備ができました! Node.jsアプリケーションを作成しましょう。

Node.jsアプリケーションを作成する

HTTPリクエストに「Hello World」を返すだけの_Hello World_アプリケーションを作成します。 これは、Node.jsのセットアップに役立つサンプルアプリケーションであり、独自のアプリケーションに置き換えることができます。適切なIPアドレスとポートでリッスンするようにアプリケーションを変更してください。

Hello World Code

まず、Node.jsアプリケーションを作成して開き、編集します。 このチュートリアルでは、 `+ nano `を使用して ` hello.js +`というサンプルアプリケーションを編集します。

cd ~
nano hello.js

次のコードをファイルに挿入します。 必要に応じて、両方の場所で強調表示されているポート `++`を置き換えることができます(管理者以外のポート、つまり 1024以上):

hello.js

#!/usr/bin/env nodejs
var http = require('http');
http.createServer(function (req, res) {
 res.writeHead(200, {'Content-Type': 'text/plain'});
 res.end('Hello World\n');
}).listen(, 'localhost');
console.log('Server running at http://localhost:/');

ここで保存して終了します。

このNode.jsアプリケーションは、指定されたアドレス( + localhost +)とポート( ++)でリッスンし、「+ 200+」HTTP成功コードとともに「Hello World」を返します。 * localhost *でリッスンしているため、リモートクライアントはアプリケーションに接続できません。

テストアプリケーション

アプリケーションをテストするために、 `+ hello.js +`実行可能ファイルをマークします:

chmod +x ./hello.js

そして次のように実行します:

./hello.js
OutputServer running at http://localhost:/

アプリケーションをテストするには、サーバーで別のターミナルセッションを開き、 `+ curl +`で* localhost *に接続します。

curl http://localhost:

次の出力が表示される場合、アプリケーションは適切に動作しており、適切なアドレスとポートでリッスンしています。

OutputHello World

適切な出力が表示されない場合は、Node.jsアプリケーションが実行中であり、適切なアドレスとポートでリッスンするように構成されていることを確認してください。

動作していることを確認したら、* Ctrl + C *を押してアプリケーションを強制終了します(まだ行っていない場合)。

PM2をインストールする

次に、Node.jsアプリケーションのプロセスマネージャーであるPM2をインストールします。 PM2は、アプリケーションを管理およびデーモン化する簡単な方法を提供します(サービスとしてバックグラウンドで実行します)。

Node.jsでインストールするNodeモジュールのパッケージマネージャーである `+ npm +`を使用して、サーバーにPM2をインストールします。 次のコマンドを使用して、PM2をインストールします。

sudo npm install -g pm2

「+ -g 」オプションは、モジュールを_globally_にインストールするように「 npm +」に指示し、システム全体で使用できるようにします。

PM2でアプリケーションを管理する

PM2はシンプルで使いやすいです。 PM2のいくつかの基本的な使用方法について説明します。

アプリケーションを開始

最初にしたいことは、バックグラウンドで `+ pm2 start `コマンドを使用してアプリケーション ` hello.js +`を実行することです:

pm2 start

これにより、アプリケーションがPM2のプロセスリストに追加され、アプリケーションを起動するたびに出力されます。

Output[PM2] Spawning PM2 daemon
[PM2] PM2 Successfully daemonized
[PM2] Starting  in fork_mode (1 instance)
[PM2] Done.
┌──────────┬────┬──────┬──────┬────────┬─────────┬────────┬─────────────┬──────────┐
│ App name │ id │ mode │ pid  │ status │ restart │ uptime │ memory      │ watching │
├──────────┼────┼──────┼──────┼────────┼─────────┼────────┼─────────────┼──────────┤
│     │ 0  │ fork │ 3524 │ online │ 0       │ 0s     │ 21.566 MB   │ disabled │
└──────────┴────┴──────┴──────┴────────┴─────────┴────────┴─────────────┴──────────┘
Use `pm2 show <id|name>` to get more details about an app

ご覧のとおり、PM2は* App名*(ファイル名に基づいて、 `+ .js +`拡張子なし)とPM2 * id を自動的に割り当てます。 PM2は、プロセスの PID *、現在のステータス、メモリ使用量などの他の情報も保持します。

PM2で実行中のアプリケーションは、アプリケーションがクラッシュまたは強制終了すると自動的に再起動されますが、システムの起動時にアプリケーションを起動するために追加の手順を実行する必要があります(ブートまたはリブート)。 幸いなことに、PM2はこれを行う簡単な方法である `+ startup +`サブコマンドを提供します。

`+ startup +`サブコマンドは、サーバーの起動時にPM2とその管理対象プロセスを起動するための起動スクリプトを生成および構成します。

pm2 startup systemd

結果の出力の最後の行には、スーパーユーザー権限で実行する必要があるコマンドが含まれます。

Output[PM2] Init System found: systemd
[PM2] You have to run this command as root. Execute the following command:

生成されたコマンドを実行して(上記の強調表示された出力に似ていますが、 `++`の代わりにユーザー名で)PM2を起動時に起動するように設定します(独自の出力からコマンドを使用します):

sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u  --hp /home/

これにより、起動時にユーザーの `+ pm2 `を実行するsystemd * unit *が作成されます。 この ` pm2 `インスタンスは、今度は ` hello.js `を実行します。 ` systemctl +`でsystemdユニットのステータスを確認できます:

systemctl status pm2-

systemdの詳細な概要については、https://www.digitalocean.com/community/tutorials/systemd-essentials-working-with-services-units-and-the-journal [Systemd Essentials:Working with Services、Units、andジャーナル]。

その他のPM2の使用法(オプション)

PM2には、アプリケーションに関する情報を管理または検索できる多くのサブコマンドがあります。 引数なしで `+ pm2 +`を実行すると、使用例を含むヘルプページが表示され、チュートリアルのこのセクションよりも詳細にPM2の使用法が説明されています。

このコマンドでアプリケーションを停止します(PM2の「+ App name」または「+ id」を指定します):

pm2 stop

次のコマンドでアプリケーションを再起動します(PM2の「+ App name」または「+ id」を指定します):

pm2 restart

現在PM2によって管理されているアプリケーションのリストは、 `+ list +`サブコマンドで検索することもできます:

pm2 list

特定のアプリケーションに関する詳細情報は、 `+ info +`サブコマンドを使用して見つけることができます(PM2 _App name_または_id_を指定します)。

pm2 info

PM2プロセスモニターは、 `+ monit +`サブコマンドでプルアップできます。 これにより、アプリケーションのステータス、CPU、およびメモリ使用量が表示されます。

pm2 monit

Node.jsアプリケーションが実行され、PM2によって管理されたので、リバースプロキシを設定しましょう。

Nginxをリバースプロキシサーバーとして設定する

アプリケーションが実行され、* localhost *でリッスンしたので、ユーザーがアプリケーションにアクセスする方法を設定する必要があります。 この目的のために、Nginx Webサーバーをリバースプロキシとして設定します。

前提条件のチュートリアルでは、 `+ / etc / nginx / sites-available / default +`ファイルでNginx設定をセットアップしました。 ファイルを編集用に開きます。

sudo nano /etc/nginx/sites-available/default

`+ server `ブロック内には、既存の ` location / +`ブロックが必要です。 そのブロックの内容を次の構成に置き換えます。 アプリケーションが別のポートでリッスンするように設定されている場合、強調表示された部分を正しいポート番号に更新します。

/ etc / nginx / sites-available / default

. . .
   location / {
       proxy_pass http://localhost:;
       proxy_http_version 1.1;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection 'upgrade';
       proxy_set_header Host $host;
       proxy_cache_bypass $http_upgrade;
   }
}

これにより、サーバーがルートで要求に応答するように構成されます。 サーバーが `+ example.com `で利用できると仮定すると、Webブラウザーを介して ` https:// example.com / `にアクセスすると、リクエストが ` hello.js `に送信され、ポート ` 8080 +`でリッスンします* localhost *で。

同じサーバーブロックに追加の「+ location 」ブロックを追加して、同じサーバー上の他のアプリケーションへのアクセスを提供できます。 たとえば、ポート ` 8081 `で別のNode.jsアプリケーションも実行している場合、このロケーションブロックを追加して、 ` http:// example.com / app2 +`経由でアクセスできるようにすることができます。

/ etc / nginx / sites-available / default-オプション

   location /app2 {
       proxy_pass http://localhost:;
       proxy_http_version 1.1;
       proxy_set_header Upgrade $http_upgrade;
       proxy_set_header Connection 'upgrade';
       proxy_set_header Host $host;
       proxy_cache_bypass $http_upgrade;
   }

アプリケーションのロケーションブロックの追加が完了したら、保存して終了します。

次のように入力して、構文エラーが発生していないことを確認します。

sudo nginx -t

次に、Nginxを再起動します。

sudo systemctl restart nginx

Node.jsアプリケーションが実行中で、アプリケーションとNginxの構成が正しいと仮定すると、Nginxリバースプロキシ経由でアプリケーションにアクセスできるようになります。 サーバーのURL(パブリックIPアドレスまたはドメイン名)にアクセスして試してください。

結論

おめでとうございます。 これで、Ubuntu 16.04サーバー上のNginxリバースプロキシの背後でNode.jsアプリケーションが実行されました。 このリバースプロキシのセットアップは、ユーザーが共有したい他のアプリケーションまたは静的なWebコンテンツにアクセスできるように十分な柔軟性を備えています。 Node.jsの開発を頑張ってください!

前の投稿:CentOS 7にApache Tomcat 8をインストールする方法
次の投稿:IstioとKubernetesでカナリアを展開する方法