Cytoscape.jsでサービス依存関係を操作:障害の影響候補を逆向きに探索

プログラミング・Web開発カテゴリを表すパンダのイラスト プログラミング・Web開発

この記事について
この記事は、生成AIを活用した自動生成フローで作成しています。Cytoscape.jsの公式情報を参照し、固定版とライセンスを同梱した静的Web教材を制作しました。

検証ステータス:🧪 計算ロジックは確認済み、ブラウザー表示は未確認
GitHubにあるlogic.mjsの純粋関数をV8隔離環境で確認しました。GitHub Pagesの実到達と操作、WordPress表示は今回未確認です。

Cytoscape.jsでサービス依存関係を操作:障害の影響候補を逆向きに探索

架空のポータル、API、認証、DBという4サービスの依存関係を表示し、障害対象を選ぶと影響候補の色と件数が変わる教材です。

静的サイトでも動きのあるJavaScript教材を実現できます。ただし、第三者ライブラリを使うことと、実際の業務システムに導入できることは別です。まず画面操作で結果の変化を確かめ、仕組みと検証条件を理解しましょう。

まず動かす

DBを選ぶとAPIとポータルの2件、認証を選ぶとポータル1件、ポータルを選ぶと影響候補0件です。これは事前に登録した依存関係から機械的にたどった結果であり、実際の障害を検知したものではありません。

初期の入力から条件を1つだけ変えて、元のデータが変わったのか、表示する条件だけが変わったのかを意識してください。操作を戻して期待結果が復元するかも確認します。特にグラフや図は見た目の変化が目立つため、数字での結果確認も重要です。

何が使われているのか

項目内容
ライブラリCytoscape.js 3.30.4
配信GitHub Pagesの静的HTML/CSS/JavaScript
ライセンスMIT(ライセンス全文をvendorに同梱)
コードの取得公式GitHubの版を固定。実行時CDNなし
データ架空の値のみ
確認済み分離したロジックのV8検査
未確認公開URLの到達・ブラウザー実操作・WordPress表示

動く仕組みと役割分担

Cytoscape.jsはノードとエッジの描画とクリック操作を受け持ち、affectedBy関数は『依存する側→依存先』の矢印を逆向きに探索します。キューと集合で重複するサービスを数えないようにしています。

次は教材の計算ロジックです。ブラウザーで描画できなくても、画面へ渡す値が期待通りかを別に確かめられます。完成した操作画面はHTML、CSS、app.mjs、vendorの全ファイルが必要です。この抜粋だけで動くと誤認しないようにしてください。

export const nodes=[{id:"portal",label:"ポータル"},{id:"api",label:"API"},{id:"auth",label:"認証"},{id:"db",label:"DB"}];
export const dependencies=[["portal","api"],["portal","auth"],["api","db"]];
export function affectedBy(failed){const impacted=new Set(),queue=[failed];while(queue.length){const node=queue.shift();for(const [service,requires] of dependencies){if(requires===node&&!impacted.has(service)){impacted.add(service);queue.push(service);}}}return [...impacted];}

この分離によって、計算の誤りと見た目の不具合を別々に診断できます。画面が出ないからといって元データが間違っているとは限りません。逆に画面が綺麗でも、元データや計算条件が間違っていれば役に立ちません。

一条件を変えたときの意味

依存関係があってもフェイルオーバーなどによって実際には停止しない場合があります。影響候補を確定情報と誤認してはいけません。実システムの構成情報を公開デモへ流用すると、接続関係を外部に知らせるリスクもあります。

変更した入力と結果を記録してから次の条件へ進みます。複数の値を同時にいじると、何が変化の原因になったか分からなくなるためです。まずダミー入力で動きを覚え、必要があれば公式仕様の境界値を照合しましょう。

動かないときの確認

何も描画されないときはライブラリの取得、DIVの高さ、ノードID、エッジのsource/target、クリック時のIDを調べます。矢印の向きを逆に扱うと原因と影響を取り違えます。

現象確認する場所切り分け
URLが開けないPagesの配信とHTTP応答公開側の問題
画面が真っ白vendor・DOM・Console読込み/実行の問題
操作が反映されない入力イベントと更新処理状態管理の問題
数字と画面が違う元配列と表示設定計算と描画の問題

今回の検証で実施したのは計算部分の隔離確認です。ライブラリ本体の実ブラウザー動作や本番のWordPress表示は確認していません。実施していない操作を検証済みとしないことは、失敗を再現できる技術記事にとって重要です。

実務に応用する場合

DBを選ぶとAPIとポータルの2件、認証を選ぶとポータル1件、ポータルを選ぶと影響候補0件です。これは事前に登録した依存関係から機械的にたどった結果であり、実際の障害を検知したものではありません。 その一方で、業務データへ拡張する前に依存関係があってもフェイルオーバーなどによって実際には停止しない場合があります。影響候補を確定情報と誤認してはいけません。実システムの構成情報を公開デモへ流用すると、接続関係を外部に知らせるリスクもあります。

運用向けに広げるときは、アクセス権、保存の成否、更新の証跡、失敗時の復旧、データの取り違え防止を検討する必要があります。ブラウザーの静的デモは説明用であり、本番のDBや認証を備えたシステムの代わりではありません。

静的同梱と安全管理

ライブラリ本体は外部CDNへ毎回読み込むのではなく、docs/demos/cytoscape-service-dependencies/vendor/へ固定版を同梱しています。第三者が配布したソフトウェアなので、出典・バージョン・ライセンスをREADMEに明記し、ライブラリの更新は意図的に検証してから行います。外部CDNの突然の変更に左右されにくい一方、セキュリティ更新まで自動で行われるわけではありません。

架空データだけを使用し、実在する人・会社・機密システムの情報を公開教材に入れません。第三者製のコードであっても、利用者が実行するものとして権限やネットワーク接続、将来のライブラリ更新を確認する責任は残ります。WordPress記事本文に無断のスクリプトやiframeを挿入せず、従来の配信経路を維持しています。

まとめ

架空のポータル、API、認証、DBという4サービスの依存関係を表示し、障害対象を選ぶと影響候補の色と件数が変わる教材です。 「操作して結果を確認する」「変化の理由を説明する」「1つだけ条件を変えて比較する」という順で、動くライブラリを技術の学びへ変えられます。完成版のREADMEとソースを見れば、静的サイトのまま再現する手順も確認できます。

公式資料とコード

検証範囲

計算ロジックをV8隔離環境で確認し、静的教材と版固定の第三者ライブラリ、ライセンスをGitHubへ保存しました。ブラウザー実機での操作、画面表示、WordPress本番での見え方、スマートフォン、Windows/macOS差は未確認です。

文書情報

記事タイトル
Cytoscape.jsでサービス依存関係を操作:障害の影響候補を逆向きに探索
作成日
更新日
Source URL
https://papanda925.com/?p=18696

ライセンス: 本記事のうち、当サイトが権利を有する本文・自作図表は、特記なき限り CC BY 4.0 で利用できます。生成AIを活用して作成・編集した内容を含みます。コードについて、別途ライセンス表示またはリンク先GitHubリポジトリのライセンスがある場合は、その条件を優先します。引用・第三者資料・画像・商標等は本ライセンスの対象外です。 利用ポリシー

タイトルとURLをコピーしました