2. 開発環境のセットアップ

下記内容は、 CentOS7 / RHEL7 向けのインストール手順です。 (他 OS 環境の場合は、注釈に記載のURLを参照してください)

2.1. 事前準備

事前準備として、 Node-RED のインストールに必要なモジュールをインストールします。 以下、 sudo コマンドを使用できるユーザアカウントで Linux にログインしているものとします。

Node.js をインストールします。 npm もインストールされます。以下手順でないと古いバージョンがインストールされる場合があるためご注意ください。

$ curl --silent --location https://rpm.nodesource.com/setup_6.x | bash -
$ sudo yum -y install nodejs

注釈

インストール時には以下のように Node.js のバージョンを指定することもできます。

$ sudo yum -y install nodejs-6.10.0

注意

万一、上記のインストールに失敗する場合は、以下の build tools をインストール後に再実行すると解決する場合があります。

$ sudo yum dev-setting gcc-c++ make

注意

Node.js は v4.4.4 以降を使用してください。 Node-RED サイトには v0.10.x 以降とありますが、NEC BaaS ノードでは v4.4.4 以降が必要です。

Node.js の一部バージョン(v4.8.1, v6.10.1, v7.6.0)で Node.jsのメモリリーク が報告されています。 運用時に使用する Node.js のバージョンには注意してください。

注釈

詳細は Node.jsのインストール手順 を参照してください。

2.2. Node-RED のインストール

Node-RED をインストールします。

$ sudo npm install -g --unsafe-perm node-red

注釈

npm でインストールする際、 node-red@x.x.x のようにパッケージ名の後ろにバージョンを指定することで旧バージョンをインストールできます。

注釈

Node-RED 設定情報はユーザのホームディレクトリ配下(~/.node-red)に格納されます。 詳細は Node-REDドキュメント の「インストール」を参照してください。

2.3. Node-RED の起動確認

Node-RED を起動する場合は以下を実行します。

$ node-red

ブラウザで以下にアクセスし、Node-REDが起動していることを確認してください。

http://localhost:1880

※上記はローカルの場合です。公開サーバ上にインストールした場合は IP アドレスを指定してください。

注釈

Node-RED はデフォルトで 1880 番ポートを使用します。 ポート番号は Node-RED 設定ファイル(~/.node-red/setting.js)で変更できます。

2.4. NEC BaaS ノードのインストール

任意のディレクトリ(ユーザのホームディレクトリ等)で、以下のコマンドを実行してください。 npm のレポジトリに公開された NEC BaaS ノードがインストールされます。

$ sudo npm install -g node-red-contrib-nec-baas

または、 NEC BaaS ノードのパッケージ(node-red-contrib-nec-baas-*.tgz)を取得後、以下のコマンドを実行してインストールすることもできます。

$ sudo npm install -g node-red-contrib-nec-baas-*.tgz

Node-RED が表示されたブラウザをリロード後、画面左欄に NEC BaaS ノードが追加されていることを確認してください。

2.5. プロキシの設定

注釈

本節以降は必要に応じて実施してください。

NEC BaaS の各ノードは、 OS に設定された プロキシ情報を使用します。 プロキシ環境で動作させる場合は、 process.env コマンド実行時に表示される下記いずれかに プロキシ情報が設定されていることを確認してください。

$ node
> process.env

process.env.http_proxy, process.env.https_proxy

2.6. Node-RED の環境設定

Node-RED の環境設定を行う場合は ~/.node-red/settings.js ファイルを編集します。 ポートやサブパス等を設定できます。

注釈

詳細は Node-REDドキュメント の「設定」を参照してください。

Node-RED のブラウザUI上で各種ノードを追加/削除可能とする場合は、以下のプラグインをインストールします。

$ sudo npm install -g node-red-contrib-admin

注意

ブラウザUI上でノードを削除する場合は、 HTTPS 接続が必要です。 HTTP 接続では削除できない場合があります。

2.7. その他

npm のアンインストール方法

$ sudo npm uninstall -g npm

node-js のアンインストール方法

$ sudo yum remove nodejs

Node-RED のアンインストール方法

$ sudo npm uninstall -g node-red

NEC BaaS ノードのアンインストール方法

$ sudo npm uninstall -g node-red-contrib-nec-baas