コンテンツにスキップ

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

This translation was generated using artificial intelligence and has not been reviewed by a human translator. It may contain inaccuracies or errors and should not be relied upon.

用語

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/ウェブフォームを通じて深刻度と影響を受けるデバイス/リンクとともに自動投稿されます。スレッドで議論とトラブルシューティングが行われます。
#dz-contributor-maintenance 計画されたメンテナンス活動（アップグレード、修理）。API/ウェブフォームを通じて計画された開始/終了時間とともにスケジュールされます。スレッドで議論が行われます。
#dz-contributor-ops すべてのコントリビューターのオープンディスカッション — 運用上の質問、CLIのヘルプ、ランブックとプレイブックの共有。

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

DZプレフィックスルール

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

提供するDZプレフィックスプールはDoubleZeroプロトコルがIP割り当てを管理します。

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デバイス - DZエージェントを実行する物理Aristaスイッチ
DZX DoubleZero Exchange - コントリビューターがピアするメトロ相互接続ポイント
CYOA Choose Your Own Adventure - ユーザー接続方式（GREOverDIA、GREOverFabricなど）
DIA Direct Internet Access - すべてのDZDがコントローラーとテレメトリに必要とするインターネット接続、エッジ/ハイブリッドデバイスでのユーザー接続のCYOAタイプとしてよく使用される
WANリンク 自社のDZD間のリンク（同一コントリビューター）
DZXリンク 別のコントリビューターのDZDへのリンク（相互承認が必要）
Config Agent コントローラーをポーリングし、DZDに設定を適用する
Telemetry Agent TWAMPレイテンシ/ロスメトリクスを収集し、オンチェーンレジャーに送信する
サービスキー CLI操作のためのコントリビューターアイデンティティキー
メトリクスパブリッシャーキー テレメトリ送信をオンチェーンで署名するためのキー

ドキュメント構成

ガイド 説明
要件とアーキテクチャ ハードウェア仕様、ネットワークアーキテクチャ、帯域幅オプション
デバイスプロビジョニング ステップバイステップ：キー → リポジトリアクセス → デバイス → リンク → エージェント
運用 エージェントのアップグレード、リンク管理、監視
用語集 すべての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設定を導出するサービス

準備ができましたか？要件とアーキテクチャから始めてください。