More than 3 years have passed since last update.

Elastic Beanstalkで、Node.js+expressアプリを動かそう [ハマりポイント説明]

Last updated at 2020-06-15Posted at 2019-12-25

#注意
本内容は、Beanstalkのプラットフォームが。「Amazon Linux AMI Node.js プラットフォームバージョン」以前向けの内容です。
2020/05以降は、「Amazon Linux 2 のプラットフォームバージョン」になりますので、本内容は対象外になります。

#🔶 はじめに
Lambdaの方が使い勝手がいいので、あまり使わないElastic Beanstalkですが、いざ使おうと思うと、いくつか躓くポイントがあるので、その点も含めて、Node.js+expressで作ったサンプルアプリを動かすまでの手順を紹介します。

##🔷 Elastic Beanstalk
https://aws.amazon.com/jp/elasticbeanstalk/
Java、.NET、PHP、Node.js、Python、Ruby、Go、Dockerなどで作られたプログラムをデプロイ、実行する環境。
実態としては、EC2の上にApacheやNginx等のサーバーを立てて提供してくれる。

#🔶 作業手順
大きくは以下の手順になります。

Node.js+expressでアプリを用意する。
ソースコード+node.jsモジュールをZIPファイルにまとめる。
Elastic Beanstalk実行環境構築、デプロイ。
実行。

##🔷 Node.js+expressでアプリを用意する
今回は、express myappコマンド作成される、サンプルアプリを使います。
ゴールとしては、Elastic Beanstalkにデプロイして、以下の画面が表示する事です。

アプリの生成手順の詳細は以下を参照してください。

参考：Node.js + ExpressでREST API開発を体験しよう for Windows［準備編］

###✅ ポイント1 : アプリ起動時のポート番号の変更

myappプロジェクトを生成したら、binフォルダ配下のwwwファイルを開き、以下のようにアプリ実行時のポート番号を、デフォルトの3000番から8081番に修正する。

bin/www

#!/usr/bin/env node

/**
 * Module dependencies.
 */

var app = require('../app');
var debug = require('debug')('myapp:server');
var http = require('http');

/**
 * Get port from environment and store in Express.
 */

// var port = normalizePort(process.env.PORT || '3000'); ←３０００ポートは使えない
var port = normalizePort(process.env.PORT || '8081'); // 起動時のポートを8081に変更
app.set('port', port);

Beanstalk環境のnginxは、デフォルトでアプリケーションの8081ポートへリクエストを転送するので、上記のように変更する必要があります。

参考：プロキシサーバーを設定する

##🔷 ソースコード+Node.jsモジュールをZIPファイルにまとめる

Beanstalkのデプロイパッケージは、ソースコードに必要なNode.jsモジュールをインポートして、ZIPファイルにまとめて作成します。

###✅ ポイント２ : Linux環境でnpm installを実行する

まず、Lambdaのトピックですが、以下のように紹介されています。

注意: ほとんどの Node.js モジュールはプラットフォームに依存しませんが、一部のモジュールは特定のオペレーティングシステム環境に対してコンパイルされます。Lambda は、Linux 環境で動作します。npm でモジュールをインストールする場合、zip ファイルを Linux 環境で構築して、正しいプラットフォームに対する依存関係が必ず含まれるようにすることをお勧めします。

参考：Node.js の Lambda デプロイパッケージを作成するには、どうすればよいですか？

Beanstalkも、実態はEC2（Amazon Linux）インスタンスなので、Linux環境でnpm installを実行する方が無難です。
やり方はいくつかありますが、おすすめはmyappプロジェクトをCloud9にアップロードして、そこでnpm installを実行して、再度ローカルにダウンロードするやり方です。
詳しくは以下を参照。

参考：Lambda関数にNode.jsモジュールを入れるなら、Cloud9が簡単でおすすめ

###✅ ポイント3 : ZIPファイルはファイル指定して圧縮する

デプロイパッケージを作る際、生成したmyappプロジェクトフォルダ自体をZIPで圧縮すると、デプロイ時にエラーになります。
必ず、myappプロジェクトフォルダ配下のファイルを指定して、ZIPで圧縮してください。