5.1.5 カスタムコンポーネント開発環境(SCCDE)

本項では、Synapseカスタムコンポーネント開発環境(以下SCCDE)について説明します。

5.1.5.1 SCCDEの概要#

Synapseカスタムコンポーネント開発環境(SCCDE)は、Synapseのカスタムコンポーネントを開発するための様々なツール・パッケージを集約した環境です。現在のところ以下の機能を有しています。

カスタムコンポーネント管理ディレクトリの初期化(init)

管理用のディレクトリは、GitやSubversionなどのバージョン管理システムで利用しやすい形態になっています。
カスタムコンポーネントのサンプルプログラムの追加(add)

コレクタ、シリアライザ、エミッタなどの簡易的なサンプルプログラムを追加できます。
カスタムコンポーネントのパッケージング(make-package)

コンポーネントのパッケージングを行うと、複数のカスタムコンポーネントやカスタムUIをまとめて１つのファイル(SCCPKG)に収めることができます。このSCCPKGファイルを、Synapseの管理画面からアップロードすることで、複数のカスタムコンポーネントをまとめて管理することができます。
カスタムコンポーネントのテスト環境の実行(serve)

作成したカスタムコンポーネントを簡易的に実行するためのテスト環境を起動できます。

現時点ではPython実装のカスタムコンポーネントのみに対応しています。 C言語実装のコンポーネントの対応は未定です。

5.1.5.2 インストール方法#

SCCDEは以下の方法でインストールできます。

Synapseと一緒に配布されるwhlパッケージファイルを使ってインストール
PyPI（pipの標準インデックス）からインストール

インストールする環境はWindowsでもLinuxでも構いません。ただしテスト環境の実行(serve)機能は、同一デバイスにSynapseがインストールされている必要があります。

LinuxWindows(pwsh)

$ python3 -m venv ~/sccde
$ . ~/sccde/bin/activate
(sccde) $ pip3 install speedbeesynapse-sccde

参考：venv

PS> python -m venv "$HOME\sccde"
PS> . "$HOME\sccde\Scripts\Activate.ps1"
(sccde) PS> pip3 install speedbeesynapse-sccde

参考：venv

本パッケージは標準的なPythonパッケージですので、上記のpip, venvを使ったインストール方法以外にも様々なパッケージ管理ツール（Poetry, uvなど）を使用可能です。お好みのツールをご利用ください。

※以降で説明する手順は、上記のactivateを行った(sccde)環境内で実施することを想定しています。

5.1.5.3 SCCDEの使い方とパッケージング#

5.1.5.3.1 カスタムコンポーネント管理ディレクトリの初期化#

カスタムコンポーネントを管理するために、空のディレクトリを用意して初期化する必要があります。以下の手順で初期化してください。

LinuxWindows(pwsh)

(sccde) $ mkdir sccpack-test
(sccde) $ cd sccpack-test
(sccde) $ sccde init
(sccde) $ ls
parameter_ui  source  scc-info.json

(sccde) PS> mkdir sccpack-test
(sccde) PS> cd sccpack-test
(sccde) PS> sccde init
(sccde) PS> ls
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          2025/xx/yy    hh:mm                parameter_ui
d----          2025/xx/yy    hh:mm                source
-a---          2025/xx/yy    hh:mm            644 scc-info.json

初期化を行うと現在のディレクトリに対して以下の処理が行われます。

scc-info.jsonの生成
カスタムコンポーネント(collector)のサンプルプログラムの追加

scc-info.jsonは、このディレクトリ内で管理するカスタムコンポーネントに関する情報を記載するためのファイルです。 JSON形式になっていますので、必要に応じてテキストエディタ等で編集してください。

主要なプロパティを下記に記載いたします。

プロパティ	説明
package-name	パッケージの名称です。任意の名前を記載できます。
package-version	パッケージのバージョンを示す文字列です。基本的には"."区切りの３つの数値を記載してください。このバージョン文字列はSemantic Versioning 2.0.0に沿った形式が望ましいです。
package-uuid	パッケージを識別するためのIDです。初期状態ではランダムなUUIDが設定されています。基本的には変更せずに使用してください
package-description	パッケージの説明文です。任意の文字列を記載して下さい。
author	パッケージ作成者の名前を記載できます。
license	このパッケージを利用する際のライセンス種別を記入できます。（BSD, MIT, UNLICENSEDなど）。不要な場合は空文字列としてください。
license-file	このパッケージのライセンス詳細を記したファイルの相対パスを指定できます。不要な場合は空文字列としてください。
python-components-source	このディレクトリ内で管理するPythonのカスタムコンポーネントの配置パスです。基本的に変更する必要はありません。
components	複数のカスタムコンポーネントの定義を記載するためのオブジェクトです。keyにはカスタムコンポーネントのUUIDを指定する必要があります。
components.*.name	カスタムコンポーネントの名称です。任意の名前を記載できます。
components.*.description	カスタムコンポーネントの説明文です。
components.*.component-type	カスタムコンポーネントの実装種別です。'python' or 'c'を指定する必要があります。
components.*.moduelname	Pythonカスタムコンポーネントのモジュール名です。 `python-components-source`で指定したパスを基準とした場合のカスタムコンポーネントをimportするためのモジュール名を記載してください。
components.*.parameter-ui-type	カスタムUIの定義ファイルへ種別を指定します。'json' or 'html'を指定可能です。
components.*.parameter-ui	カスタムUIへの相対パスを指定してください。 'json'形式の場合はそのファイルへのパスを、'html'形式の場合はhtmlファイルが配置されたディレクトリへのパスを指定してください。

5.1.5.3.2 カスタムコンポーネントの追加#

管理ディレクトリを初期化した後は、addサブコマンドによりカスタムコンポーネントのサンプルプログラムを追加できます。

LinuxWindows(pwsh)

(sccde) $ sccde add -t collector

(sccde) PS> sccde add -t collector

-tの後の文字列は、collectorの他にserializer, emitterなどに置き換え可能です。

追加したサンプルプログラムは初期状態ではsource/python配下に配置されます。 このサンプルはそのままでも実行可能なようになっていますが、これをベースに自由にカスタムコンポーネントを改変して独自のコンポーネントを作ることができます。

カスタムコンポーネントの実装方法については下記を参照してください。

また、追加されたサンプルコンポーネントにはカスタムUIのサンプルも付属しています。こちらも必要に応じて改変してご利用ください。

カスタムUI作成

デフォルトではjson形式のカスタムUIが付与されます。追加時のオプションで-u htmlを指定することで、HTML形式のカスタムUIも作成可能です。

5.1.5.3.3 カスタムコンポーネントのテスト実行#

SCCDEコマンドをインストールした環境に、Synapseもインストールされている場合はserveコマンドでカスタムコンポーネントをテスト実行することができます。

LinuxWindows(pwsh)

(sccde) $ sccde serve --port 8123
Preparing Synapse data directories..
Synapse server ready: http://127.0.0.1:8123
:

(sccde) PS> sccde serve --port 8123
Preparing Synapse data directories..
Synapse server ready: http://127.0.0.1:8123
:

初回実行ではデータディレクトリの初期化にしばらく時間がかかります。 ready: http://..のメッセージが表示されたら、ブラウザでそのURLを開いてください。

URLを開くと、SynapseのフローエディタのEdit Modeと同様の画面が表示されます。左側のコンポーネントベース一覧から、作成したカスタムコンポーネントを選択可能になっています。

テスト用のSynapseは、Ctrl-Cキーで停止できます。

オプション

オプション	説明
`--host`	テスト用Synapseサーバーが利用するIPアドレスを指定できます。稼働しているデバイス外からもアクセスしたい場合は`0.0.0.0`を指定してください。デフォルトは`127.0.0.1`となっています。
`--port`	テスト用Synapseサーバーが利用するTCPポート番号指定できます。他のサービスとポート番号が被らないように任意の番号を指定してください。デフォルトは`8000`となっています。
`--verbose`	テスト用Synapseの実行ログを表示します。

データディレクトリとログ

テスト用Synapseの実行中のデータは、sccdeの作業ディレクトリ内にある.synapse/var-speedbeesynapseディレクトリに配置されます。

LinuxWindows(pwsh)

(sccde) $ ls .synapse/var-speedbeesynapse/
certs  config  dblog  hivecore_exec_status.json  logs  projects  sdts.db  sdts.file  webui_tmp

(sccde) PS> ls .\.synapse\var-speedbeesynapse\
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          2025/xx/yy    hh:mm                certs
d----          2025/xx/yy    hh:mm                config
d----          2025/xx/yy    hh:mm                dblog
d----          2025/xx/yy    hh:mm                logs
d----          2025/xx/yy    hh:mm                projects
d----          2025/xx/yy    hh:mm                sdts.db
d----          2025/xx/yy    hh:mm                sdts.file
d----          2025/xx/yy    hh:mm                webui_tmp
-a---          2025/xx/yy    hh:mm            105 hivecore_exec_status.json

データをクリアして初期状態に戻したい場合は、.synapseフォルダごと削除してからテスト用Synapseを起動してください。

また、カスタムコンポーネントのデバッグ等でログを参照したい場合は、.synapse/var-speedbeesynapse/logsにあるspeedbeesynase.logを参照できます。

開発用コンポーネント

テスト用Synapse実行中は、専用の開発用コンポーネントを利用できます。開発用コンポーネントの詳細については、「開発用コンポーネント」を参照してください。

5.1.5.3.4 パッケージング#

カスタムコンポーネントを追加した後は、make-packageサブコマンドにより、パッケージを作成できます。

LinuxWindows(pwsh)

(sccde) $ sccde make-package
(sccde) $ ls
custom_component_package_example.sccpkg  parameter_ui  scc-info.json  source

(sccde) PS> sccde make-package
(sccde) PS> ls
Mode                 LastWriteTime         Length Name
----                 -------------         ------ ----
d----          2025/xx/xx    hh:mm                parameter_ui
d----          2025/xx/xx    hh:mm                source
-a---          2025/xx/xx    hh:mm           2481 custom_component_package_example.sccpkg
-a---          2025/xx/xx    hh:mm            644 scc-info.json

.sccpkgという拡張子がついたファイルがSCCPKGです。このファイルをSynapseに登録することができます。

5.1.5.4 SynapseへのSCCPKGファイルの登録、および、削除#

前項で説明したパッケージングにより作成したパッケージファイル(SCCPKG)を、 Synapseの管理画面から登録することで、パッケージに含まれるカスタムコンポーネントを利用できるようになります。

5.1.5.4.1 登録/更新#

次の手順で、作成したSCCPKGファイルをSpeeDBee Synapseに登録することができます。

ヘッダのモード選択で"Edit Mode"を選択し、Editモードの画面を開きます。
設定メニューアイコンを押下し、「カスタムコンポーネント」を選択します。
コンポーネントパッケージの「追加」を押下し、カスタムコンポーネントのファイルを登録します。

既に同一のパッケージが登録済みの場合、ここで上書きを確認するダイアログが表示されます。上書きする場合は「はい」を選択してください。
「閉じる」を押下します。
確認ダイアログで「はい」を選択し、変更を反映するために、システムを再起動させます。
左メニューに、登録したカスタムコンポーネントが反映されます。

5.1.5.4.2 ダウンロード#

次の手順で、登録したコンポーネントパッケージをダウンロードすることができます。

設定メニューアイコンを押下し、「カスタムコンポーネント」を選択します。
コンポーネントパッケージの「ダウンロードアイコン（取得）」を押下します。
コンポーネントパッケージのファイルがダウンロードされます。

5.1.5.4.3 削除#

次の手順で、登録したSCCPKGファイルをSpeeDBee Synapseから削除することができます。

設定メニューアイコンを押下し、「カスタムコンポーネント」を選択します。
対象パッケージの右にある「ゴミ箱アイコン（削除）」を押下します。
確認ダイアログで「はい」を選択します。
SCCPKGファイルが削除されます。

5.1.5.4.4 保護の付与#

登録したパッケージには保護をかけることができます。
保護されたパッケージは次の操作が行えなくなるため、意図しない更新を防ぐことができます。

登録/更新
削除
ダウンロード

次の手順で、パッケージに保護をかけることができます。

設定メニューアイコンを押下し、「カスタムコンポーネント」を選択します。
対象パッケージの右にある「鍵アイコン（保護）」を押下します。
保護解除する際に必要となるパスワードを入力して、「保護」を押下します。
警告
- パスワードは復元できない形式で保存され、一度設定すると保護を解除するまで再設定できません。
- 保護設定したパスワードを忘れた場合、該当のパッケージは操作不能となります。
パスワードの取り扱いには十分ご注意ください。
コンポーネントパッケージが保護状態になります。

5.1.5.4.5 保護の解除#

次の手順で、パッケージの保護を解除することができます。

設定メニューアイコンを押下し、「カスタムコンポーネント」を選択します。
対象パッケージの右にある「鍵アイコン（保護解除）」を押下します。
保護をかけた際に設定したパスワードを入力して、「保護解除」を押下します。
コンポーネントパッケージの保護が解除されます。