Debian9で本番用にNode.jsアプリケーションを設定する方法
序章
Node.js は、サーバーサイドおよびネットワーキングアプリケーションを構築するためのオープンソースのJavaScriptランタイム環境です。 プラットフォームは、Linux、macOS、FreeBSD、およびWindowsで動作します。 コマンドラインでNode.jsアプリケーションを実行できますが、このチュートリアルでは、それらをサービスとして実行することに焦点を当てます。 これは、アプリケーションが再起動または失敗時に再起動し、実稼働環境で安全に使用できることを意味します。
このチュートリアルでは、単一のDebian9サーバー上に本番環境に対応したNode.js環境をセットアップします。 このサーバーは、 PM2 によって管理されるNode.jsアプリケーションを実行し、Nginxリバースプロキシを介してアプリケーションへの安全なアクセスをユーザーに提供します。 Nginxサーバーは、 Let'sEncryptが提供する無料の証明書を使用してHTTPSを提供します。
前提条件
このガイドでは、次のことを前提としています。
- Debian9の初期サーバーセットアップガイドで説明されているDebian9サーバーのセットアップ。 sudo権限とアクティブなファイアウォールを持つ非rootユーザーが必要です。
- サーバーのパブリックIPを指すドメイン名。 このチュートリアルでは、全体を通してドメイン名example.comを使用します。
- Debian9にNginxをインストールする方法で説明されているようにNginxがインストールされています。
- Let'sEncrypt証明書を使用してSSLで構成されたNginx。 Debian9でLet'sEncryptを使用してNginxを保護する方法でプロセスを説明します。
前提条件を完了すると、https://example.com/
でドメインのデフォルトのプレースホルダーページを提供するサーバーが作成されます。
ステップ1—Node.jsをインストールする
NodeSource パッケージアーカイブを使用して、Node.jsの最新のLTSリリースをインストールすることから始めましょう。
NodeSource PPAをインストールしてそのコンテンツにアクセスするには、最初にパッケージインデックスを更新し、curl
をインストールする必要があります。
sudo apt update sudo apt install curl
ホームディレクトリにいることを確認してから、curl
を使用して、Node.js 8.xアーカイブのインストールスクリプトを取得します。
cd ~ curl -sL https://deb.nodesource.com/setup_8.x -o nodesource_setup.sh
このスクリプトの内容は、nano
または推奨テキストエディタを使用して調べることができます。
nano nodesource_setup.sh
スクリプトの検査が終了したら、sudo
でスクリプトを実行します。
sudo bash nodesource_setup.sh
PPAが構成に追加され、ローカルパッケージキャッシュが自動的に更新されます。 Nodesourceからセットアップスクリプトを実行した後、Node.jsパッケージをインストールできます。
sudo apt install nodejs
これらの最初の手順の後にインストールしたNode.jsのバージョンを確認するには、次のように入力します。
nodejs -v
Outputv8.11.4
注: NodeSource PPAからインストールする場合、Node.js実行可能ファイルはnode
ではなくnodejs
と呼ばれます。
nodejs
パッケージには、nodejs
バイナリと、ノードモジュールのパッケージマネージャーである npm が含まれているため、npm
を個別にインストールする必要はありません。 。
npm
は、ホームディレクトリの構成ファイルを使用して更新を追跡します。 npm
を初めて実行したときに作成されます。 次のコマンドを実行して、npm
がインストールされていることを確認し、構成ファイルを作成します。
npm -v
Output5.6.0
一部のnpm
パッケージ(たとえば、ソースからのコードのコンパイルが必要なパッケージ)を機能させるには、build-essential
パッケージをインストールする必要があります。
sudo apt install build-essential
これで、ソースからコードをコンパイルする必要があるnpm
パッケージを操作するために必要なツールができました。
Node.jsランタイムがインストールされたら、Node.jsアプリケーションの作成に移りましょう。
ステップ2—Node.jsアプリケーションを作成する
HTTPリクエストに「HelloWorld」を返すHelloWorldアプリケーションを作成してみましょう。 このサンプルアプリケーションは、Node.jsをセットアップするのに役立ちます。 独自のアプリケーションに置き換えることができます。適切なIPアドレスとポートでリッスンするようにアプリケーションを変更してください。
まず、hello.js
というサンプルアプリケーションを作成しましょう。
cd ~ nano hello.js
次のコードをファイルに挿入します。
〜/ hello.js
const http = require('http'); const hostname = 'localhost'; const port = 3000; const server = http.createServer((req, res) => { res.statusCode = 200; res.setHeader('Content-Type', 'text/plain'); res.end('Hello World!\n'); }); server.listen(port, hostname, () => { console.log(`Server running at http://${hostname}:${port}/`); });
ファイルを保存して、エディターを終了します。
このNode.jsアプリケーションは、指定されたアドレス(localhost
)とポート(3000
)をリッスンし、「HelloWorld!」を返します。 200
HTTP成功コードを使用します。 localhost
をリッスンしているため、リモートクライアントはアプリケーションに接続できません。
アプリケーションをテストするには、次のように入力します。
node hello.js
次の出力が表示されます。
OutputServer running at http://localhost:3000/
注:この方法でNode.jsアプリケーションを実行すると、CTRL+C
を押してアプリケーションが強制終了されるまで、追加のコマンドがブロックされます。
アプリケーションをテストするには、サーバーで別のターミナルセッションを開き、curl
を使用してlocalhost
に接続します。
curl http://localhost:3000
次の出力が表示された場合、アプリケーションは正常に動作しており、正しいアドレスとポートでリッスンしています。
OutputHello World!
期待どおりの出力が表示されない場合は、Node.jsアプリケーションが実行されており、適切なアドレスとポートでリッスンするように構成されていることを確認してください。
動作していることを確認したら、CTRL+C
を押して、アプリケーションを強制終了します(まだ実行していない場合)。
ステップ3—PM2をインストールする
次に、Node.jsアプリケーションのプロセスマネージャーであるPM2をインストールしましょう。 PM2を使用すると、アプリケーションをデーモン化して、サービスとしてバックグラウンドで実行できるようになります。
npm
を使用して、最新バージョンのPM2をサーバーにインストールします。
sudo npm install pm2@latest -g
-g
オプションは、npm
にモジュールをグローバルにインストールするように指示するため、システム全体で使用できます。
まず、pm2 start
コマンドを使用して、アプリケーションhello.js
をバックグラウンドで実行します。
pm2 start hello.js
これにより、アプリケーションがPM2のプロセスリストに追加されます。このリストは、アプリケーションを起動するたびに出力されます。
Output[PM2] Spawning PM2 daemon with pm2_home=/home/sammy/.pm2 [PM2] PM2 Successfully daemonized [PM2] Starting /home/sammy/hello.js in fork_mode (1 instance) [PM2] Done. ┌──────────┬────┬──────┬──────┬────────┬─────────┬────────┬─────┬───────────┬───────┬──────────┐ │ App name │ id │ mode │ pid │ status │ restart │ uptime │ cpu │ mem │ user │ watching │ ├──────────┼────┼──────┼──────┼────────┼─────────┼────────┼─────┼───────────┼───────┼──────────┤ │ hello │ 0 │ fork │ 1338 │ online │ 0 │ 0s │ 0% │ 23.0 MB │ sammy │ disabled │ └──────────┴────┴──────┴──────┴────────┴─────────┴────────┴─────┴───────────┴───────┴──────────┘ Use `pm2 show <id|name>` to get more details about an app
ご覧のとおり、PM2はApp name
(.js
拡張子なしのファイル名に基づく)とPM2id
を自動的に割り当てます。 PM2は、プロセスのPID
、その現在のステータス、メモリ使用量などの他の情報も保持します。
PM2で実行されているアプリケーションは、アプリケーションがクラッシュまたは強制終了された場合に自動的に再起動されますが、startup
サブコマンドを使用して、システムの起動時にアプリケーションを起動するための追加の手順を実行できます。 このサブコマンドは、サーバーの起動時にPM2とその管理対象プロセスを起動するための起動スクリプトを生成および構成します。
pm2 startup systemd
結果の出力の最後の行には、起動時に開始するようにPM2を設定するスーパーユーザー権限で実行するコマンドが含まれます。
Output[PM2] Init System found: systemd [PM2] To setup the Startup Script, copy/paste the following command: sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u sammy --hp /home/sammy
sammy
の代わりにユーザー名を使用して、出力からコマンドを実行します。
sudo env PATH=$PATH:/usr/bin /usr/lib/node_modules/pm2/bin/pm2 startup systemd -u sammy --hp /home/sammy
追加の手順として、PM2プロセスリストと対応する環境を保存できます。
pm2 save
これで、起動時にユーザーに対してpm2
を実行するsystemdunitが作成されました。 このpm2
インスタンスは、hello.js
を実行します。
systemctl
でサービスを開始します。
sudo systemctl start pm2-sammy
systemdユニットのステータスを確認します。
systemctl status pm2-sammy
systemdの詳細な概要については、 Systemd Essentials:サービス、ユニット、およびジャーナルの操作を参照してください。
PM2には、これまでに説明したものに加えて、アプリケーションに関する情報を管理または検索できる多くのサブコマンドが用意されています。
このコマンドでアプリケーションを停止します(PM2 App name
またはid
を指定):
pm2 stop app_name_or_id
アプリケーションを再起動します。
pm2 restart app_name_or_id
PM2によって現在管理されているアプリケーションを一覧表示します。
pm2 list
App name
を使用して、特定のアプリケーションに関する情報を取得します。
pm2 info app_name
PM2プロセスモニターは、monit
サブコマンドでプルアップできます。 これにより、アプリケーションのステータス、CPU、およびメモリ使用量が表示されます。
pm2 monit
引数なしでpm2
を実行すると、使用例が記載されたヘルプページも表示されることに注意してください。
Node.jsアプリケーションがPM2によって実行および管理されているので、リバースプロキシを設定しましょう。
ステップ4—Nginxをリバースプロキシサーバーとして設定する
アプリケーションはlocalhost
で実行およびリッスンしていますが、ユーザーがアプリケーションにアクセスする方法を設定する必要があります。 この目的のために、NginxWebサーバーをリバースプロキシとして設定します。
前提条件のチュートリアルでは、/etc/nginx/sites-available/example.com
ファイルでNginx構成を設定します。 このファイルを開いて編集します。
sudo nano /etc/nginx/sites-available/example.com
server
ブロック内に、既存のlocation /
ブロックが必要です。 そのブロックの内容を次の構成に置き換えます。 アプリケーションが別のポートでリッスンするように設定されている場合は、強調表示された部分を正しいポート番号に更新します。
/etc/nginx/sites-available/example.com
server { ... location / { proxy_pass http://localhost:3000; 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/
にアクセスすると、[のポート3000
でリッスンしているhello.js
にリクエストが送信されます。 X157X]。
同じサーバーブロックにlocation
ブロックを追加して、同じサーバー上の他のアプリケーションへのアクセスを提供できます。 たとえば、ポート3001
で別のNode.jsアプリケーションも実行している場合は、このロケーションブロックを追加して、https://example.com/app2
経由でのアクセスを許可できます。
/etc/nginx/sites-available/example.com —オプション
server { ... location /app2 { proxy_pass http://localhost:3001; 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アドレスまたはドメイン名)にアクセスして試してみてください。
結論
おめでとう! これで、Node.jsアプリケーションがDebian9サーバー上のNginxリバースプロキシの背後で実行されます。 このリバースプロキシ設定は、共有したい他のアプリケーションや静的Webコンテンツへのアクセスをユーザーに提供するのに十分な柔軟性があります。