基本的な図の作成

ネットワーク図の基本要素であるノード（デバイス）とリンク（接続）の定義方法を説明します。

ノード（Nodes）

ノードはルーター、スイッチ、サーバーなどのネットワークデバイスを表します。

nodes:
  - id: router-1          # 必須: 一意の識別子
    label: "Core Router"  # 必須: 表示名
    type: router          # デバイスタイプ

デバイスタイプ

type	エイリアス	説明
`router`	-	ルーター
`l3-switch`	-	L3 スイッチ
`l2-switch`	`switch`	L2 スイッチ
`firewall`	-	ファイアウォール
`load-balancer`	`lb`	ロードバランサー
`server`	-	サーバー
`access-point`	`ap`	アクセスポイント
`cpe`	`onu`, `ont`	CPE（ONU / ONT）
`console-server`	`terminal-server`	コンソールサーバー
`cloud`	-	クラウド
`internet`	-	インターネット
`vpn`	-	VPN
`database`	`db`	データベース
`generic`	-	汎用

複数行ラベル

nodes:
  - id: router-1
    label:
      - "<b>RT-01</b>"      # 太字
      - "192.168.1.1"       # IP アドレス
      - "---"               # 区切り線
      - "Tokyo DC"          # 追加情報

ノードの形状

nodes:
  - id: db-1
    label: "Database"
    type: database
    shape: cylinder    # 形状を指定

shape	エイリアス	説明
`rounded`	`round`	角丸四角形（デフォルト）
`rect`	`rectangle`	四角形
`circle`	-	円
`diamond`	`rhombus`	ひし形
`hexagon`	-	六角形
`cylinder`	`database`	円柱
`stadium`	`pill`	スタジアム形
`trapezoid`	-	台形

リンク（Links）

リンクはデバイス間の接続を表します。

links:
  # シンプル形式
  - from: router-1
    to: switch-1

  # ポート指定
  - from:
      node: router-1
      port: eth0
    to:
      node: switch-1
      port: ge-0/0/0

リンク速度（standard）

standard: でリンクのイーサネット規格を指定します。速い規格ほど線が太く描画されます（凡例を有効にすると、使用中の規格ごとの線の太さサンプルが表示されます）。

links:
  - from: router-1
    to: switch-1
    standard: 10GBASE-T

代表的な値：

standard	速度
`1000BASE-T`	1G
`10GBASE-T`, `10GBASE-SR`	10G
`25GBASE-SR`	25G
`40GBASE-SR4`	40G
`100GBASE-SR4`, `100GBASE-LR4`	100G

VLAN

links:
  - from: switch-1
    to: switch-2
    vlan: 100           # 単一 VLAN

  - from: switch-1
    to: switch-3
    vlan: [10, 20, 30]  # トランク（複数 VLAN）

リンクタイプ

links:
  - from: router-1
    to: router-2
    type: dashed        # 破線（VPN など）

type	エイリアス	説明
`solid`	-	実線（デフォルト）
`dashed`	`dotted`	破線
`thick`	-	太線
`double`	-	二重線
`invisible`	`hidden`	非表示

矢印

links:
  - from: client
    to: server
    arrow: forward      # 順方向の矢印

arrow	エイリアス	説明
`none`	-	矢印なし（デフォルト）
`forward`	`->`	順方向
`back`	`<-`	逆方向
`both`	`<->`	双方向

冗長化タイプ

HA ペアやスタック構成を表現できます。

links:
  - from: router-1
    to: router-2
    redundancy: ha      # HA ペア

redundancy を指定したメンバー群は 1 つの筐体（メガネ形のハル）としてまとめて描画され、接合面のスタックポートにはラベルがバー内に表示されます。冗長リンク自体は通常のリンクとして描かれるため、他のリンクと同様にメトリクス（weathermap）を載せられます。3 台以上のスタックはハルが横に連結されます。

redundancy	エイリアス	説明
`ha`	`vrrp`, `hsrp`, `glbp`, `keepalive`	HA ペア
`vc`	`virtual-chassis`	Virtual Chassis
`vss`	-	VSS
`vpc`	-	vPC
`mlag`	`mclag`	MLAG
`stack`	`stacking`, `irf`	スタック

完全な例

name: "Office Network"

nodes:
  - id: inet
    label: "Internet"
    type: internet

  - id: router
    label:
      - "<b>Edge Router</b>"
      - "203.0.113.1"
    type: router

  - id: fw
    label: "Firewall"
    type: firewall

  - id: sw-core
    label: "Core Switch"
    type: l3-switch

  - id: srv-web
    label: "Web Server"
    type: server

  - id: srv-db
    label: "Database"
    type: database
    shape: cylinder

links:
  - from: inet
    to: router

  - from: router
    to: fw
    standard: 1000BASE-T

  - from: fw
    to: sw-core
    standard: 10GBASE-T

  - from: sw-core
    to: srv-web
    standard: 1000BASE-T
    vlan: 100

  - from: sw-core
    to: srv-db
    standard: 10GBASE-T
    vlan: 200