パッケージング

ノードはモジュールとしてパッケージ化し、npmリポジトリに公開することができます。 これにより、インストールするのに必要な依存関係と共にインストールが容易になります。

命名規則

自作のノードの名称にnode-redを利用したい場合、Node-REDプロジェクトによってメンテナンスされていないことを明確にするため、プレフィックスとしてnode-red-contrib-を利用してください。 あるいは、node-redをプレフィックスとして利用しない任意の名称を使用することができます。

ディレクトリ構造

以下に、ノードパッケージの典型的なディレクトリ構造を示します:

├── LICENSE
├── README.md
├── package.json
└── sample
    ├── examples
    │   ├── example-1.json
    │   └── example-2.json
    ├── icons
    │   └── my-icon.svg
    ├── sample.html
    └── sample.js

パッケージ内で使用されるディレクトリ構造に厳密な要件はありません。 パッケージに複数のノードが含まれている場合、それらすべてが同じディレクトリに存在させることもできますが、 それぞれを独自のサブディレクトリに配置することもできます。

ノードモジュールをローカルでテストする

ノードモジュールをローカルでテストするには、npm install <folder>コマンドを使うことができます。 これにより開発中において、ローカルディレクトリでノードを開発し、ローカルのNode-REDインストールにリンクさせることができます。

あなたのnode-redユーザディレクトリで、通常のように次のコマンドを実行します。

npm install <ノードモジュールへのパス>

これにより、ディレクトリへ適切なシンボリックリンクが作成され、 Node-REDは起動時にノードを検出します。 Node-REDを再起動するだけで、ノードのファイルに対する変更を取得できます。

package.json

package.jsonファイルには通常のエントリと同様、 ランタイムにロードするノードを含む.jsファイルをリストアップしたnode-redエントリが含まれていなければなりません。

1つのファイルに複数のノードがある場合、ファイルを1回だけリストアップしなければなりません。

ノードが他のnpmモジュールの依存関係を持つ場合、 それらはdependenciesプロパティに含まれていなければなりません。

npmリポジトリ内でノードを発見できるようにするため、 keywordsプロパティにnode-redを含める必要があります。 これにより、キーワードで検索する際にパッケージが確実に表示されます。

Note: ノードが安定して正しく動作し、 他の人がノードを利用できるように充分に文書化されるまで `node-red`キーワードを追加しないでください。
{
    "name"         : "node-red-contrib-samplenode",
    "version"      : "0.0.1",
    "description"  : "A sample node for node-red",
    "dependencies": {
    },
    "keywords": [ "node-red" ],
    "node-red"     : {
        "nodes": {
            "sample": "sample/sample.js"
        }
    }
}

README.md

README.mdファイルには、 ノードの機能およびそれを機能させるために必要な前提条件を列挙します。 ノードのhtmlファイルの情報タブ部分に含まれていない追加の指示や、 そのノードを使用している小さなサンプルフローを含めると 有意義かもしれません。

ファイルは、 GitHub flavoured markdownを利用してマークアップすべきです。

LICENSE

他の人が自分のコードで出来ることと出来ないことを知ることができるように、 ライセンスファイルを含めてください。

npmに公開する

npmリポジトリにパッケージを公開するためのガイドが数多くあります。 こちらに基本的な概要があります。

flows.nodered.orgに追加する

2020年4月時点で、Node-REDフローライブラリnode-redというキーワード付きでnpmに公開されたノードを 自動的にインデックス化・更新することはもうできません。 代わりに、手動で送信リクエストを設定する必要があります。

このためには、パッケージング要件のすべてを満たしていることを確認してください。 新しいノードをライブラリに追加するためには、 ライブラリページの上部の+ボタンをクリックし、 「node」オプションを選択してください。 このボタンによってノード追加のページへ移動します。 ここでは要件のリストが再度表示され、 ノードをライブラリに追加するステップが記述されています。

既存のノードを更新するには、 新規ノードを追加したときと同様に再度送信することも可能ですし、 フローライブラリ上のノードのページの「request refresh」リンクから更新することも可能です。 このリンクはログインしているユーザのみ表示されます。

表示されない場合、 Node-REDフォーラムまたはslackで 助けを求めることができます。