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 は v6.x.x 以降を使用してください。 Node-RED サイトには v0.10.x 以降とありますが、NEC BaaS ノードでは v6.x.x 以降が必要です。
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