IoT Flow Runtime Editorの使用

OCI統合のNode-REDエディタを使用して、フローの構築とデプロイ、Oracle DatabaseおよびOCIノードの構成、および他の認可されたユーザーとのコラボレーションを行います。

各IoTフロー・ランタイムには、管理されたノード-REDエディタが用意されています。

OCIコンソールの「フロー・ランタイム詳細」ページからエディタを開きます。OCIコンソールのシングル・サインオンでは、エディタに対して認証されるため、個別のノード-RED資格証明は必要ありません。IoTフロー・ランタイムの検索に関するヘルプが必要な場合は、IoTフロー・ランタイムのリストを参照してください。

ノード-REDエディタは、フロー・ランタイム・エンドポイントに次の形式を使用します。

https://<flow-runtime-short-id>.flows.iot.<region>.oci.customer-oci.com/

フローを表示または編集できるかどうかは、OCIIAM権限によって決まります。

OCIおよびノード-REDナビゲーション

OCIナビゲーション・バーは、標準のNode-REDエディタ・ヘッダーの上に表示されます。


コントロール	摘要
`<flow-runtime-short-id>`	OCIコンソールのフロー・ランタイムの詳細ページに戻ります。
「エディタ」または「ビューア」	現在のアクセスレベルを表示します。エディタはフローを変更およびデプロイできます。ビューアはエディタを検査できますが、変更をデプロイできません。複数のユーザーがログインしている場合、このフローが別のユーザーによって更新されていることを示すメッセージが表示されます。他のユーザーには、変更を確認またはマージするオプションが表示されます。
残りセッション	認証済エディタ・セッションの残り時間を表示します。
拡張	認証済エディタ・セッションの時間を延長する場合に選択します。
ヘルプ	エディタのヘルプを開きます。
サイン・アウト	エディタセッションを終了します。

Node-REDヘッダーには、「デプロイ」およびメイン・メニューが含まれます。エディタには、左側のノード・パレット、中央のフロー・ワークスペース、右側の情報、ヘルプ、デバッグ、構成およびコンテキスト・サイドバーが含まれます。

複数のユーザーの処理

複数の認可ユーザーが、同じフロー・ランタイムを開いて編集できます。各ユーザーは、個別のブラウザ・エディタ・セッションで作業します。これは、キャラクタごとのコラボレーション編集ではありません。

変更をアンデプロイしている間に別のユーザーが変更をデプロイした場合、デプロイする前に、新しいデプロイ済フロー構成を確認してマージするオプションがあります。可能な場合は、デプロイメントを調整し、関連する作業を別々のフロー・タブで維持します。作業をタブに分割すると、変更を比較およびマージしやすくなります。詳細は、フロー構造を参照してください。

フロー・ランタイム・ソフトウェアの更新

OCI IoTは、管理対象ノード-REDランタイムを含むフロー・ランタイムのソフトウェアを管理します。ノード-REDのパレット・マネージャを使用して管理対象ランタイムを更新しないでください。パレット・マネージャは、許可されたノード・モジュールを管理します。

1つ以上のフロー・ランタイムにソフトウェア更新が必要な場合、OCIは、影響を受けるリージョン、フロー・ランタイム名、フロー・ランタイムOCIDおよび期限までに必要なアクションをリストするお知らせを送信します。表示された各フロー・ランタイムを更新するには、通知時間から14日(336時間)かかります。

ノート

短時間の中断を計画します。フロー・ランタイムが非アクティブ化されて再アクティブ化されている間は、フロー処理は一時停止し、エディタは使用できません。

お知らせを開き、影響を受けるリソースおよび期限を確認します。コンソールにリストされたリソースを検索するには、IoTフロー・ランタイムのリストを参照してください。
更新する前に、必要なファイルをフロー・ランタイムのローカル・ファイル・システムからAutonomous Database、ファイル・ストレージまたは別の永続ストレージ・サービスに移動します。ローカル・ファイル・システムは一時的であり、そのファイル上のファイルは非アクティブ化またはアクティブ化中に失われる可能性があります。Autonomous Databaseに格納されたデータおよびマウントされたファイル・ストレージ・ファイル・システムは保持されます。フロー定義に別のリカバリ・ポイントが必要な場合は、現在のフローJSONをバックアップします。
影響を受けるフロー・ランタイムを非アクティブ化し、非アクティブ化作業リクエストが完了し、ライフサイクル状態が「非アクティブ」になるまで待機します。
フロー・ランタイムのアクティブ化: 保留中のソフトウェア更新を適用します。アクティブ化作業リクエストが正常に完了し、ライフサイクル状態が「アクティブ」になるまで待機します。作業リクエストの状態および詳細は、IoTドメイン・グループ、ドメインおよびフロー・ランタイムの作業リクエストを参照してください。
エディタを開き、フロー、フロー・ランタイム・インタフェース、Oracleノード、およびワークロードで使用されるその他の許可されたノード・モジュールが正常に動作することを確認します。アクティブ化またはフローの実行に失敗した場合は、構成されたフロー・ランタイム・ログを確認します。

重要

「期限までに必要なアクション」期限までに更新を完了しない場合、OCIは影響を受けるフロー・ランタイムを非アクティブ化します。フロー・ランタイムは、アクティブ化するまで「非アクティブ」状態のままです。アクティブ化すると、保留中のソフトウェア更新が適用され、サービスに戻されます。

フローのバックアップと復元

「フロー」タブには、フロー・ランタイムの1つの現在の完全なノード-RED flows.json構成ファイルが格納されます。別のflows.jsonを追加すると、そのアクティブな構成が置き換えられ、個別に保持されるバックアップは作成されません。

オブジェクト・ストレージ・バケットなど、フロー・ランタイムの外部にあるポイントインタイム・コピーを保存します。ファイル・ストレージ・マウントでは、実行中のフローでファイルを使用できるようになり、この管理側のバックアップには必要ありません。

JSONフロー構成のバックアップ

Node-REDエディタで、完全なフローJSON構成をエクスポートし、JSONファイルをダウンロードします。かわりに、コンソール、CLIまたはAPIを使用して、フロー・ランタイムからアクティブなフローJSONを取得できます。
オブジェクト・ストレージ・バケットを作成するか、既存のバックアップ・バケットを選択します。Object Storageで同じオブジェクト名を使用する以前のバージョンを保持する場合は、オブジェクトのバージョニングを有効にします。
JSONファイルをアップロードします。フロー・ランタイムおよびバックアップ時間を識別する名前(flow-runtimes/<flow-runtime-short-id>/2026-07-28T160000Z-flows.jsonなど)を使用します。
フロー・ランタイムOCID、Node-REDバージョン、エクスポート時間およびバックアップの理由を記録します。オブジェクトをダウンロードし、リカバリのためにオブジェクトに依存する前に有効なJSONが含まれていることを確認します。

JSONフロー構成のリストア

現在のフローJSON構成を取得して外部的に保存してから、置換します。
オブジェクト・ストレージからリストアするポイントインタイムJSON構成をダウンロードします。
JSONを「フロー」タブに追加するか、CLIまたはAPIを使用して完全なフローJSONを置換します。フローの検索に関するヘルプが必要な場合は、IoTフロー・ランタイムのリストを参照してください。
ノード-REDエディタを開き、フロー、共有構成ノードおよびインストール済ノード・モジュールを確認します。エクスポートされたJSONで保持されなかった必要な資格証明を再入力し、クリティカル・フローをテストします。

重要

フローJSONには、機密エンドポイントおよび構成の詳細を含めることができ、資格証明バックアップ・ノードに必要なすべてのシークレットを保持しない場合があります。バックアップ・オブジェクトへのアクセスを制限し、リストア・プロセスに頼る前にリストア・プロセスをテストします。

Oracleノード

管理対象パレットには、標準のNode-REDノードに加えて、Oracle DatabaseノードおよびOCIノードが含まれます。フロー・ランタイムで使用可能なノードは、サービス・バージョンによって異なります。

Oracle Databaseノード

db-nodesグループは、構成時に顧客のAutonomous Databaseを含むフローをOracle Databaseに接続します。

ノード	摘要
db接続	他のデータベース・ノードが使用する共有Oracle Database接続を定義します。
トランザクションの開始	データベース接続を取得し、ダウンストリーム・データベース操作のトランザクションを開始します。
トランザクションを終了	現在のトランザクションをコミットまたはロールバックし、データベース接続を解放します。
エンキュー	構成済のOracle Databaseトランザクション・イベント・キューにメッセージを追加します。
デキュー	構成済のOracle Databaseトランザクション・イベント・キューからメッセージを取得します。
sql	構成済のデータベース接続を使用してSQL文を実行します。

OCIノード

OCI-nodesグループは、フローをサポート対象のOCI IoT操作に接続します。

ノード	摘要
iot-config	OCIノードで使用される共有OCI構成認証、リージョンおよびデフォルト・コンパートメント設定を定義します。
送信コマンド	デジタル・ツイン・インスタンスにコマンドを送信します。
登録	サポートされているOCI IoTソースからのメッセージへのフローをサブスクライブします。
遠隔測定	フローからOCI IoTにテレメトリを送信します。

OCI構成オプション

パレットは、共有構成ノード iot-configにラベルを付けます。その編集ダイアログでは、OCI Configラベルが使用されます。フローに適した認証タイプを選択します。

認証タイプ	摘要
構成ファイル	OCI SDK構成ファイルおよび選択したプロファイルを使用します。
Instance Principal	インスタンス・プリンシパルがランタイム環境で使用可能である場合、OCIコンピュート・インスタンスのアイデンティティを使用します。
リソース・プリンシパル	Flow Runtimeリソース・プリンシパルを使用します。このオプションは、ユーザーの存続期間が長い資格証明をフローに格納することを回避します。フロー・ランタイムを動的グループに追加し、そのノードがアクセスするOCIリソースに必要なポリシーのみを付与します。
APIキー(シンプル)	構成ノードに指定されたOCIユーザーAPI署名キー情報を使用します。ターゲット・サービスがサポートする場合は、これらの資格証明を保護し、かわりにリソース・プリンシパルを使用します。

「リージョン」を、ターゲット・リソースを含むリージョンに設定します。コンパートメントOCIDを子OCIノードのデフォルト・コンパートメントに設定します。子ノードは、デフォルト・コンパートメントをオーバーライドできます。

構成を変更した後、「更新」を選択し、「デプロイ」を選択して、「接続のテスト」を使用します。

ノード・モジュールの管理

パレット・マネージャは、ノードREDエディタの組込み機能です。これにより、コマンドラインを使用せずにノード・モジュールをインストール、更新、無効化または削除でき、パブリック・ノード-REDライブラリに関連付けられた統合パッケージ・インタフェースが提供されます。OCI IoT Flow Runtimeでは、サービスが使用可能にするモジュールおよびバージョンのみを管理できます。

追加のOracleカスタム・ノードを調べるには、GitHubのノード-RED Oracle Cloudノードを参照してください。このリポジトリには、Oracle DatabaseおよびAdvanced Queues (AQ)、Oracle Fusion Cloud SCM、OCIサービスおよびOCI IoTプラットフォームのノードと、インストール・ガイダンス、ノード参照およびサンプル・フローが含まれています。リポジトリからノードをインストールする前に、フロー・ランタイムでモジュールおよびバージョンが許可されていることを確認します。

Oracle Cloud Infrastructureドキュメント