---
title: shumoku meetup #1
tags:  #shumoku  
author: [Akitoshi Saeki](https://docswell.com/user/konoe_akitoshi)
site: [Docswell](https://www.docswell.com/)
thumbnail: https://bcdn.docswell.com/page/YJ6WXXWMJV.jpg?width=480
description: ネットワーク構成図の管理を自動化するツール「shumoku」の初回ミートアップで使用した発表資料です。  開発者である佐伯明俊（電気通信大学）が、shumokuの開発に至った背景を紹介します。netboxをソースにGitHubのCI/CDでトポロジー図を自動生成したいという動機から、D2・Mermaid・Grafana Node Graph・vis.js・Graphvizといった既存ツールを比較検討し、「全体を俯瞰できる」「綺麗な図になる」「CI/CDで動かせる」「netboxと連携できる」を満たすツールとして自作を始めるまでの経緯をまとめています。  後半では、JANOG57/58、OSC、JAWS DAYS、CloudNative Kaigi、e-NOC、CHUNOG、IWSC、セキュリティ・キャンプなどのイベントや、配信環境・研究室・自宅ラボでの活用事例を紹介し、JANOG58での事例と最近のアップデート情報を共有しています。
published: September 08, 26
canonical: https://docswell.com/s/konoe_akitoshi/K4N68G-2026-09-08-190027
---
# Page. 1

![Page Image](https://bcdn.docswell.com/page/YJ6WXXWMJV.jpg)

shumoku meetup #1
電気通信大学
佐伯明俊
@konoe_akitoshi
© akitoshi-lab.com


# Page. 2

![Page Image](https://bcdn.docswell.com/page/GJ5MXXMQJ4.jpg)

自己紹介
© akitoshi-lab.com


# Page. 3

![Page Image](https://bcdn.docswell.com/page/LE3WXXWZE5.jpg)

MMA 平部員
共創進化スマート社会実現推進機構 技術支援員
佐伯 明俊
Akitoshi Saeki
電気通信大学 学部 3年
Ⅱ類先端ロボティクスプログラム
© akitoshi-lab.com


# Page. 4

![Page Image](https://bcdn.docswell.com/page/8EDK22K47G.jpg)

shumokuとは？
© akitoshi-lab.com


# Page. 5

![Page Image](https://bcdn.docswell.com/page/V7PK11KVJ8.jpg)

構成図管理を自動化する
© akitoshi-lab.com


# Page. 6

![Page Image](https://bcdn.docswell.com/page/2JVVYYVRJQ.jpg)

そもそもの開発きっかけ
© akitoshi-lab.com


# Page. 7

![Page Image](https://bcdn.docswell.com/page/5EGL99L6JL.jpg)

トポロジー図？
●
© akitoshi-lab.com


# Page. 8

![Page Image](https://bcdn.docswell.com/page/4JQYWWY27P.jpg)

最初期
●
GithubのCI/CD機能でトポロジー図を生成するぜ！
○
○
●
ソースはnetbox
物理構成ベース
検討したツール
○
○
○
○
○
D2(位置関係に難あり)
Mermaid(面倒)
Infinity+Grafana+Node Graph(IF名)
vis.js
Graphviz
© akitoshi-lab.com


# Page. 9

![Page Image](https://bcdn.docswell.com/page/K74WKKWPE1.jpg)

自作し始める
●
●
●
●
全体を見れる
綺麗な図になる
ci/cdで動かせる
netboxと連携
© akitoshi-lab.com


# Page. 10

![Page Image](https://bcdn.docswell.com/page/LJ1YXXYXEG.jpg)

…
© akitoshi-lab.com


# Page. 11

![Page Image](https://bcdn.docswell.com/page/GJWGNNGK72.jpg)

こういう可視化を目指したい
© akitoshi-lab.com


# Page. 12

![Page Image](https://bcdn.docswell.com/page/4EZL33LN73.jpg)

サクッと綺麗な図が作れる。全体が見れる。
標準的にみんながサクッとネットワーク図をかければ幸せだよね。
© akitoshi-lab.com


# Page. 13

![Page Image](https://bcdn.docswell.com/page/Y76WXXW97V.jpg)

最近の活動と活用
© akitoshi-lab.com


# Page. 14

![Page Image](https://bcdn.docswell.com/page/G75MXXMD74.jpg)

使ってくれてありがとう！＜？
●
●
●
●
●
●
●
●
●
●
●
●
janog57
OSC
jaws days
cloud native kaigi
e-noc
chunog
某展示会1
iwsc
セキュリティ・キャンプ
janog58
某配信環境2
某氏自宅3
© akitoshi-lab.com


# Page. 15

![Page Image](https://bcdn.docswell.com/page/9J29XXRMER.jpg)

JANOG58
●
© akitoshi-lab.com


# Page. 16

![Page Image](https://bcdn.docswell.com/page/DEY488DPJM.jpg)

最近の更新情報
© akitoshi-lab.com


# Page. 17

![Page Image](https://bcdn.docswell.com/page/VJNYQQ6M78.jpg)

HP, Docsを更新しました！
●
© akitoshi-lab.com


# Page. 18

![Page Image](https://bcdn.docswell.com/page/YE9PDDLWJ3.jpg)

最近の更新２
●
server apiを全面的にopenapiへ移行
○
●
プラグインの追加
○
○
●
AIフレンドリーに
Arista CV-CUE
Huawei iMaster NCE-Campus
discovery機能の強化
○
○
同一セグメント内での探索
まだ改善の余地。。。。
© akitoshi-lab.com


# Page. 19

![Page Image](https://bcdn.docswell.com/page/GE8D33XRED.jpg)

最近の更新３ーロゴの更新
シンボルマーク
ロゴタイプ
ロゴマーク
© akitoshi-lab.com


# Page. 20

![Page Image](https://bcdn.docswell.com/page/LELMVV827R.jpg)

ロードマップ
© akitoshi-lab.com


# Page. 21

![Page Image](https://bcdn.docswell.com/page/4JMYGG69JW.jpg)

11月にはv1.0をリリースしたい！
© akitoshi-lab.com


# Page. 22

![Page Image](https://bcdn.docswell.com/page/PJR9ZZP979.jpg)

スケジュール感
2026-9
meetup
2026-9
描画系テスト
2026-10
描画系完成
2026-10
Discovery機能
修正実装
© akitoshi-lab.com


# Page. 23

![Page Image](https://bcdn.docswell.com/page/PEXQ9933JX.jpg)

トポロジーの自動生成
© akitoshi-lab.com


# Page. 24

![Page Image](https://bcdn.docswell.com/page/3EK9PPYNED.jpg)

次に解くべき課題
進行中の変更
確認できた問題
●
同じ階層内で最大±36pxの上下調整を許し、配線改善の余地を増
やす
●
上下調整が無効な構成でも同じ候補を再評価し、探索枠を消費
●
composite配置では方向指定が反映されず、ポート配置前提と不一致
●
CLI・Server・Editorなどの描画経路を統一
●
機器種別・グループの有無で方式が切り替わり、品質が大きく変化
●
不明な接続端点のポート補完と、Editorの座標処理を整備
●
配置関連230テストは通過するが、探索後の可読性検証が不足
次の優先順位
1
2
回帰テスト化
貫通・衝突が残るケースを回帰テ
スト化し、確実に排除
不整合の修正
無効な探索の排除と方向指定の不
整合を修正
shumoku meetup #1 © akitoshi-lab.com
© akitoshi-lab.com
3
探索効率の改善
階層の読みやすさを保ちながら、配
置自由度と探索効率を向上


# Page. 25

![Page Image](https://bcdn.docswell.com/page/L73WXX9Z75.jpg)

配置・配線の改善で、できたことと見えてきた限界
できたこと：配置・配線を統合評価する方式への進化
見えてきた限界：小規模構成（12ノード）での検証結果
複合的な配置モデルへの移行
評価項目機器種別あり機器種別なし線のノード貫通1 件2 件線同士の重な
り1 件2 件ポート・ラベル周辺の衝突3 件15 件
●
従来の単純な木構造中心の配置から、階層・グループ・冗長接続をすべて考慮する洗練
された複合配置アルゴリズムへ移行。
配線結果のフィードバック探索
●
仮想的に配線した結果をその場で評価・比較し、線の交差・重なり・貫通が最も少なく
なる最適な配置を探索します。
物理プロパティのサイズ反映
●
線幅、ポートサイズ、ラベルの実寸法を考慮し、それらの重なりを防ぐパラメータを直
接配置アルゴリズムに組み込み。
※ 現行の幾何検証器による検出数（ノードの重複・枠外はみ出しは0件）
機器情報の付与により、ルールベースによる配置最適化が一部促進されるものの、依然と
して不整合が残存する傾向にあります。
課題の核心と限界
「探索的に減らす」アプローチでは、貫通や衝突を完全にゼロにする保証がない
現在のアルゴリズムは、スコア評価に基づき「よりマシな配置」を探索する仕組みに留まっています。このため、接続トポロジーが複雑化した場合、ど
れだけ探索を繰り返しても、線のノード貫通やラベル衝突を「物理的に100%排除する」必然性を持たせる設計（ハード制約モデル）には至っていませ
ん。
shumoku meetup #1© akitoshi-lab.com
© akitoshi-lab.com


# Page. 26

![Page Image](https://bcdn.docswell.com/page/87DK22G4JG.jpg)

最近の悩み事
●
●
●
●
●
ネットワーク図作るの難しすぎない？？
OSSどうやって持続させていこうか
使用事例知りたい
フィードバック欲しいよね
目指せ標準化！
© akitoshi-lab.com


# Page. 27

![Page Image](https://bcdn.docswell.com/page/VJPK113VE8.jpg)

はOSSプロジェクトです
● フィードバック
● Issue報告
● 機能提案
● コントリビューション
● スポンサード
歓迎しています󰢛
HP
© akitoshi-lab.com