「Webサービスを（少しずつ）構築する」 第4回

4. サーバへのデプロイ

道具

• サーバ機
  • サーバ名（IPアドレス）、各自のユーザ名とパスワード、については 別途お知らせしてあります。
    • sakura というホスト名でアクセスできる（ように file:///c:/Windows/System32/drivers/etc/hosts が設定されている）という前提で以下の解説を行います。
  • 動作しているOSはLinxのディストリビューションの１つである CentOS（バージョン６）。
    • CentOSはサーバ構築者には人気の高いディストリビューションの１つ。
    • 現在はバージョン7がリリースされていて、6と7とで使い方の差異（土台としてインストールされている管理系ソフトウェアの違いによる）があることに留意されたい。
• ローカル（自分のPC）側で使う通信ソフトウェアとして：
  1. 転送ソフトウェア （SFTP対応のもの）。
     • 前に紹介した FileZilla や WinSCPで大丈夫。
     • git や dockerを使ったデプロイ、という技術もあるが、 （プロの道具という位置付けになるようだ） これを使うのは後の段階にしておこう。
  2. シェルでのログインのための sshクライアント
  • これらについては、前に（静的コンテンツをサーバにアップロードする話のとき）に解説したので省略する。
• サーバ側ソフトウェア
  1. JavaScript処理系： node コマンド（node.jsの実体）、そのパッケージマネージャ（npm）、
     および npmでインストールできるライブラリ群を必要に応じて使う。
     • すでにサーバにインストール済み
     • 実はCentOS6に標準添付の開発系パッケージは古いバージョンのものであることが多いので、 　CentOS6に最新版を入れるための作業がいくつか必要だった（がここでは省略する）。
  2. nginx（Webサーバ/リバースプロキシサーバ）
     • 単独のWebサーバとしてはApacheよりも後進だが、 プロキシとしての性能には定評がある。
     • インストールおよび設定済み（やはり静的コンテンツをサーバから提供する回で解説した。
  3. 端末で使えるエディタ（があると便利）
     • vi はCentOSに標準添付されている（が使い方は初心者には難しい）。

手順

1. 転送する
   • サーバ側でsshdが動いているので、SFTPでの転送がすぐに可能です。
   • 第2回に「アプリケーション生成」で作った（express-generatorに作らせた）アプリケーションディレクトリを、そのままアップロードする。
   • アップロード先は、自分のホームディレクトリの直下でいいだろう（もちろん別の場所でもいい）。
   • ディレクトリ node_modules の下（ここが最もボリュームがでかい）は、時間の無駄になるので転送の対象から外してもいい。

   • サーバ側で ls -l した時の出力が、おそらく

      -rw-r--r--   1 nobu zemi   1277 11月 19 22:53 2018 app.js
      drwxr-xr-x   2 nobu zemi   4096 11月 26 11:40 2018 bin
      drwxr-xr-x   2 nobu zemi   4096 11月 26 15:10 2018 config
      -rw-r--r--   1 nobu zemi    793 11月 23 15:34 2018 memo.db
     

     のようになるだろう。パーミッションの列（左端10文字に着目）がこんな形で、ファイルのオーナー以外に w （書き込み）のパーミッションが立っていない状態なら大丈夫だろう。

   • 今般の転送によって新たにサーバ側に作成されたアプrケーションディレクトリを、以下の解説では $APP と表記しておく。
2. 必要な変更箇所
   • これまでのプログラムで最低限変更しないといけない箇所は、$APP/config/config.json の、 development フェーズの、 host パラメータ。これを "localhost" または "127.0.0.1" に変更する （最初の値に戻す、とも言える）。
   • これらの値（文字列）は、 ダブルクォートで""囲んでも シングルクォート''で囲んでもいい。
   • このようにサーバ上のファイルを編集する必要がある時にエディタが必要になる。
     • vi が使いにくい人は、nano （これもCentOSに標準添付）を使うとやや敷居が低いだろう。
     • micro というエディタもインストールしてあります。
   • サーバ側であらためて npm install
     • node.js の殆どのライブラリはJavaScript言語で書かれたソースコードなので、 原理的にはWindowsから転送したもので大丈夫だが、 中にネイティブコンパイルされたプログラムが含まれることもあり、その時はエラーの原因になる。それを回避するためにサーバ上からこのライブラリ整備の操作をしておくことにしよう。
3. ポートを決める
   • みんなが express.js のデフォルトのポート番号 3000番を使うと、混乱のもとになります。
   • 他の人と衝突しない番号を探して使うようにしましょう。

   • すでにシステムで（いずれかのデーモンが）使っている番号との衝突も予めチェックしておくこと。

      netstat -ant | grep LISTEN
     

     で表示される接続の、

   ローカル側（左側）のポート番号をチェック。 * 以下の解説では、たとえばポート3333を選んだ場合を想定して示す。

4. 起動する

   • $APP に cd（場所を移動、或いはカレントディレクトリの変更）したあと、

      PORT=3333 npm start
     

   • この先、随時動作確認を行うようにして下さい。

      http://sakura:3333/
     

     • ブラウザでこのアドレスを開いてみる。ただし、学内からは（3333番に向けた通信が拒絶されて外に出ていかないため）使えないので、家などから試してみて下さい。

     或いは、端末からテキストベースのWebブラウザ等を使って、

      curl http://localhost:3333
     

     • lynx w3m もインストールしてあります（使い方の大筋はみんな同じ、コマンド名の後にアクセス先URLを渡す）。
5. デーモン化
   • 上記の起動方法の場合、 端末の接続が切れたり、自分でログアウトしたりすると、端末上で動作しているプログラムはすべて（道連れのように）自動的に終了してしまう。
   • サーバソフトウェアとして動作させるためには、永続的に動作させるよう工夫が必要。

   • Unixの機能（nohup）を使って

      PORT=3333 nohup npm start &
     

     という方法もあるが、

     ここでは、node.js のライブラリを活用するデーモン化の方法を解説する。

   • 準備：

     1. npm用ユーザディレクトリを作る

        mkdir ~/npm
        

        • 名前は何でもいいがこの名前を前提に本節の解説を進めます。

     2. 「グローバルインストール」（-g をつけたインストール操作）のインストール先ディレクトリ（上記ディレクトリ）を、 npm君に指示しておく。

        npm config set prefix=$HOME/npm 
        

     3. PATH設定に入れる

        • ~/.bash_profile を編集して、

           export PATH=$PATH:$HOME/npm/bin
          

          を末尾（がいいだろう）に追加し保存する。

     4. forever パッケージをインストール

          npm install forever -g 
        

   • 起動

      PORT=333 forever bin/www
     

     • $APPからの起動を前提とした呼び方を示した。

   • 動作確認と運用

      ps x      # 起動しているかどうか確認
      netstat -ant    # 目的のポート番号でLISTENしているかどうか
      # 以下は foreverコマンドの使用例
      forever list    # forever が管理しているデーモンの一覧
                      # 2カラム目の `[]` で囲まれた数が id番号
      forever stop 0  # など id番号を指定してデーモンを停止できる
     

     • forever について詳細は紹介のページ（たとえばここ)や、公式解説ページ（英語）を参照。

   • 他の選択肢：

     他にデーモン化のためのツール（ライブラリ）として、 pm2 があり、こちらが後発なので機能は充実しているようだ （がここでは解説は省略する）。

6. nginxからの転送設定
   • この部分はシステム管理者（nginxの設定管理ができる）が行う必要があるので、 5. まで進めた人は連絡下さい。
   • （技術解説は執筆中）
7. 絶対パス名を使う箇所への対応

   • express-generator は ＄APP/publicを静的コンテンツ置き場に設定しており、

     例えば /stylesheets/style.css といった資源への要求に対して、 このディレクトリ以下のファイルの内容を応答として送信する。

   • この形式の要求を nginxが受け取ると、nginxが自分で（nginxがドキュメントディレクトリとして管理する領域内を）探して応答を試みる（その結果、大抵は失敗して404が発生する）。
   • $APP/view/layout.pug の中に 上記ファイルを（絶対パスの形で）指定している箇所がある。
   • これを相対指定に変更しておこう。