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のインストール手順を参照してください。

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

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

注釈

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

注釈

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

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

$ node-red

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

http://localhost:1880

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

注釈

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

任意のディレクトリ(ユーザのホームディレクトリ等）で、以下のコマンドを実行してください。 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 ノードが追加されていることを確認してください。

注釈

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

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

$ node
> process.env

process.env.http_proxy, process.env.https_proxy

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

注釈

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

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

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

注意

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

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