コンテンツにスキップ

コントリビュータードキュメント

用語について

DoubleZeroが初めてですか？用語集でDZD、DZX、CYOAなどの主要な用語の定義をご確認ください。

DoubleZeroコントリビュータードキュメントへようこそ。このセクションでは、ネットワークコントリビューターになるために必要なすべてを説明します。

ネットワークコントリビューターに興味がありますか？

DoubleZeroネットワークへの貢献に必要なハードウェア、帯域幅、接続要件を理解するために、要件とアーキテクチャページをご確認ください。

オンボーディングチェックリスト

このチェックリストを使って進捗を管理してください。すべての項目を完了しないと、コントリビューションは技術的に運用可能になりません。

フェーズ1: 前提条件

  • 管理サーバーにDoubleZero CLIをインストール済み
  • ハードウェアを調達し、要件を満たしていることを確認済み
  • データセンターのラックスペースと電源が利用可能（4U、4KW推奨）
  • DZDを物理的に設置し、管理接続を確保済み
  • DZプロトコル用にパブリックIPv4ブロックを割り当て済み（DZプレフィックスルールを参照）

フェーズ2: アカウントセットアップ

  • サービスキーペアを生成済み（doublezero keygen）
  • メトリクスパブリッシャーキーペアを生成済み
  • サービスキーをDZFに提出し、認可を取得済み
  • オンチェーンでコントリビューターアカウントを作成済み（doublezero contributor listで確認）
  • malbeclabs/contributorsリポジトリへのアクセスを付与済み

フェーズ3: デバイスプロビジョニング

  • ベースデバイス設定を適用済み（contributorsリポジトリから）
  • オンチェーンでデバイスを作成済み（doublezero device create）
  • デバイスインターフェースを登録済み
  • ループバックインターフェースを作成済み（Loopback255 vpnv4、Loopback256 ipv4）
  • CYOA/DIAインターフェースを設定済み（エッジ/ハイブリッドデバイスの場合）

フェーズ4: リンク確立とエージェントインストール

  • WANリンクを作成済み（該当する場合）
  • DZXリンクを作成済み（ステータス: requested）
  • ピアコントリビューターがDZXリンクを承認済み
  • Config Agentをインストールし、稼働中
  • Config Agentがコントローラーから設定を受信中
  • Telemetry Agentをインストールし、稼働中
  • メトリクスパブリッシャーをオンチェーンに登録済み
  • テレメトリの送信がレジャー上で確認可能

フェーズ5: リンクバーンイン

  • すべてのリンクを24時間のバーンイン期間のためにドレイン済み
  • metrics.doublezero.xyzで24時間のゼロロス・ゼロエラーを確認済み
  • クリーンなバーンイン完了後、リンクのドレインを解除済み

フェーズ6: 検証とアクティベーション

  • doublezero device listでデバイスが表示される（max_users = 0）
  • doublezero link listでリンクが表示される
  • Config Agentのログで設定プルの成功を確認済み
  • Telemetry Agentのログでメトリクス送信の成功を確認済み
  • DZ/Malbec Labsと調整して接続テストを実行（接続、ルート受信、DZ経由のルーティング）
  • テスト合格後、doublezero device updateでmax_usersを96に設定

ヘルプの入手

オンボーディングの一環として、DZFがコントリビューター向けSlackチャンネルに追加します：

チャンネル 目的
#dz-contributor-announcements DZFおよびMalbec Labsからの公式連絡 — CLI/エージェントのアップグレード、破壊的変更、セキュリティアナウンス。重要な更新を監視し、質問はスレッドで行ってください。
#dz-contributor-incidents 計画外のサービス影響イベント。インシデントは重大度と影響を受けるデバイス/リンクとともにAPI/Webフォーム経由で自動投稿されます。議論とトラブルシューティングはスレッドで行います。
#dz-contributor-maintenance 計画的なメンテナンス活動（アップグレード、修理）。API/Webフォーム経由で計画開始/終了時刻とともにスケジュールされます。議論はスレッドで行います。
#dz-contributor-ops すべてのコントリビューター向けのオープンディスカッション — 運用に関する質問、CLIのヘルプ、ランブックやプレイブックの共有。

また、組織向けの直接サポートのためにプライベートDZ/Malbec Labsチャンネルも提供されます。

DZプレフィックスルール

重要: DZプレフィックスプールの使用

提供するDZプレフィックスプールは、IP割り当てのためにDoubleZeroプロトコルによって管理されます。

DZプレフィックスの使用方法：

  • 最初のIP: デバイス用に予約（Loopback100インターフェースに割り当て）
  • 残りのIP: DZDに接続する特定のユーザータイプに割り当て：
    • IBRLWithAllocatedIPユーザー
    • EdgeFilteringユーザー
    • マルチキャストパブリッシャー
  • IBRLユーザー: このプールからは消費しません（独自のパブリックIPを使用）

これらのアドレスを以下の用途に使用することはできません：

  • 自社のネットワーク機器
  • DIAインターフェースのポイントツーポイントリンク
  • 管理インターフェース
  • DZプロトコル外のインフラストラクチャ

要件：

  • グローバルにルーティング可能な（パブリック）IPv4アドレスであること
  • プライベートIPレンジ（10.x、172.16-31.x、192.168.x）はスマートコントラクトによって拒否されます
  • 最小サイズ: /29（8アドレス）、より大きなプレフィックスが推奨されます（例: /28、/27）
  • ブロック全体が利用可能である必要があります — アドレスを事前に割り当てないでください

自社機器用のアドレス（DIAインターフェースIP、管理など）が必要な場合は、別のアドレスプールを使用してください。

クイックリファレンス: 主要用語

DoubleZeroが初めてですか？以下が基本用語です（完全な用語集を参照）：

用語 定義
DZD DoubleZero Device - DZエージェントを実行する物理的なAristaスイッチ
DZX DoubleZero Exchange - コントリビューターがピアリングするメトロ相互接続ポイント
CYOA Choose Your Own Adventure - ユーザー接続方式（GREOverDIA、GREOverFabricなど）
DIA Direct Internet Access - すべてのDZDがコントローラーおよびテレメトリに必要とするインターネット接続。エッジ/ハイブリッドデバイスでのユーザー接続のCYOAタイプとしても一般的に使用されます
WAN Link 自身のDZD間のリンク（同一コントリビューター）
DZX Link 別のコントリビューターのDZDへのリンク（双方の承認が必要）
Config Agent コントローラーをポーリングし、DZDに設定を適用します
Telemetry Agent TWAMPレイテンシー/ロスメトリクスを収集し、オンチェーンレジャーに送信します
Service Key CLI操作用のコントリビューターIDキー
Metrics Publisher Key テレメトリ送信をオンチェーンで署名するためのキー

ドキュメント構成

ガイド 説明
要件とアーキテクチャ ハードウェア仕様、ネットワークアーキテクチャ、帯域幅オプション
デバイスプロビジョニング ステップバイステップ: キー → リポジトリアクセス → デバイス → リンク → エージェント
運用 エージェントアップグレード、リンク管理、モニタリング
Geoプローブデプロイメント ジオロケーション用geoProbeエージェントのデプロイと設定
用語集 すべてのDoubleZero用語の定義

ネットワークエンジニア以外の方のためのネットワーク基礎知識

ネットワークエンジニアリングの背景をお持ちでない方のために、このドキュメントで使用される概念の入門を以下に示します：

IPアドレッシング

  • IPv4アドレス: ネットワーク上のデバイスの一意の識別子（例: 192.168.1.1）
  • CIDR表記（/29、/24）: サブネットサイズを示します。/29 = 8アドレス、/24 = 256アドレス
  • パブリックIP: インターネット上でルーティング可能; プライベートIP: 内部ネットワーク専用（10.x、172.16-31.x、192.168.x）

ネットワークレイヤー

  • レイヤー1（物理層）: ケーブル、光学部品、波長
  • レイヤー2（データリンク層）: スイッチ、VLAN、MACアドレス
  • レイヤー3（ネットワーク層）: ルーター、IPアドレス、ルーティングプロトコル

一般的な用語

  • MTU: Maximum Transmission Unit - 最大パケットサイズ（通常WANリンクでは9000バイト）
  • VLAN: Virtual LAN - 共有インフラストラクチャ上でトラフィックを論理的に分離
  • VRF: Virtual Routing and Forwarding - 同一デバイス上でルーティングテーブルを分離
  • BGP: Border Gateway Protocol - ネットワーク間のルート交換
  • GRE: Generic Routing Encapsulation - オーバーレイネットワーク用のトンネリングプロトコル
  • TWAMP: Two-Way Active Measurement Protocol - デバイス間のレイテンシー/ロスを測定

DoubleZero固有の用語

  • オンチェーン: DoubleZeroでは、デバイス登録、リンク設定、テレメトリがDoubleZeroレジャーに記録されます — これによりネットワーク状態がすべての参加者に対して透明で検証可能になります
  • コントローラー: DoubleZeroレジャー上のオンチェーン状態からDZD設定を導出するサービス

始める準備はできましたか？要件とアーキテクチャから始めましょう。