サイト廃止ガイド（コントリビューター向け）

このガイドでは、DoubleZero Device（DZD）の廃止またはサイトからの撤退方法について説明します。接続中のユーザーに影響を与えずにデバイスとリンクをネットワークから取り外し、オンチェーンで削除する手順を解説します。

プロセスは3つの段階で進みます。廃止日の31日前にデバイスに上限を設定し、通知期間中に接続ユーザーへ移行を案内し、廃止当日にリンク、インターフェース、デバイスをドレインして削除します。

⚠️ まずDoubleZeroと調整してください： デバイスやサイトを廃止する前に、必ずDoubleZeroチームと連携し、廃止の日時をスケジュールしてください。その時間帯に合わせて当社側でもいくつかの手順を実行する必要があるため、事前のスケジュール調整が必要です。デバイスへの上限設定やリンクのドレインを行う前に、日程と計画を合意してください。

⚠️ DZXスイッチとリンク： 廃止対象のデバイスがDZXスイッチである場合、またはDZXリンクがある場合は、影響を受けるコントリビューターをできるだけ早く特定し、通知してください。廃止日までにリンクの移行や再構築が必要になる場合があります。また、OPSポータルで廃止日のメンテナンスイベントを作成してください。

概要

タイミング	アクション	担当者
31日前	新しいユーザーが接続できないようデバイスに上限を設定する（`--max-users 0`）	コントリビューター
14日前	接続ユーザーに他のデバイスへの移行を通知する	DoubleZeroチーム
通知期間	ユーザーが自ら他のDZDに再接続する	ユーザー
廃止当日	リンク、インターフェース、デバイスをドレインして削除する	コントリビューター

原則：

新規ユーザーは早期に停止し、既存ユーザーは段階的に移行する。 デバイスに早めに上限を設定することで、その時点以降はユーザーが減少するのみとなります。既存ユーザーは引き続き利用でき、自身のスケジュールで移行します。
通知期間中はすべてを稼働状態に保つ。 移行中のユーザーが通常のサービスを受け続けられるよう、廃止当日までリンクやデバイスのドレインは行わないでください。
削除順序はコントラクトによって強制される。 アクティブ状態のリンクやデバイスは削除できないため、以下の手順ではまずドレインし、最後に削除を行います。

⚠️ 短期通知の場合： 撤退まで31日未満の場合は、直ちに開始してください。今すぐデバイスに上限を設定し、利用可能な期間に合わせて各期間を短縮してください。手順の順序は変わりません。

フェーズ1 — デバイスの上限設定（31日前）

新しいユーザーが接続できないようデバイスに上限を設定します：

doublezero device update --pubkey <DEVICE_PUBKEY> --max-users 0

既存ユーザーは影響を受けず、引き続き利用できます。サイトで廃止するすべてのデバイスについてこの操作を繰り返してください。リンクとデバイスは完全にアクティブなままなので、接続ユーザーは通常のサービスを受け続けられます。

フェーズ2 — 通知期間（14日前）

DoubleZeroチームが接続ユーザーに通知し、廃止日前に別のDZDへ再接続するよう依頼します。どのユーザーに誰が連絡するかについて、チームと調整してください。

この期間中はドレインを行わないため、ユーザーは通常のサービスを受け続けられます。ユーザーは自身のペースで再接続します。以下のコマンドでユーザー数を監視してください：

doublezero device list

フェーズ3 — 廃止当日

開始前に、除去が必要なものを正確に把握してください。デバイス、それに接続されたリンク、クリーンアップすべきインターフェースです。以下のコマンドですべて確認できます：

doublezero device list | grep <CONTRIBUTOR_CODE>    # デバイスを検索：コードと公開鍵
doublezero link list | grep <DEVICE_CODE>           # デバイスに接続されたリンクを検索
doublezero device interface list <DEVICE_CODE>      # 除去するデバイス上のインターフェースを一覧表示

以下の手順を順番に実行してください。各手順が次の手順を可能にします。

⚠️ 最終的なデバイス削除の前に： 最後の手順を実行する前に、DoubleZero Foundationに通知してください。Foundationは、期限内に移行しなかったユーザーを削除します（移行されていないユーザーがいると削除がブロックされます）。また、Foundation側で必要な手順を完了します。

1. リンクのドレイン

まずソフトドレイン、次にハードドレインを行います。各状態の詳細はリンクのドレインを参照してください。

doublezero link update --pubkey <LINK_PUBKEY> --status soft-drained
# トラフィックが移動したら：
doublezero link update --pubkey <LINK_PUBKEY> --status hard-drained

除去するデバイス上のすべてのリンクについて繰り返してください。

2. リンクの削除

doublezero link delete --pubkey <LINK_PUBKEY>

これにより、リンクが使用していたインターフェースが解放されます。

3. インターフェースの削除

doublezero device interface delete <DEVICE_CODE> <INTERFACE_NAME>

デバイス上の各インターフェースについて繰り返してください。

4. デバイスのドレイン

doublezero device update --pubkey <DEVICE_PUBKEY> --status drained

ドレインにより、デバイスがルーティングから除外され、残りのユーザーセッションが閉じられます。また、デバイスがアクティブ状態から移行され、削除可能になります。

5. デバイスの削除

doublezero device delete --pubkey <DEVICE_PUBKEY>

デバイスは、アクティブでなくなり、参照しているリンクがなく、インターフェースが残っていない場合にのみ削除できます。これらは前の手順で処理されています。

キャンセルまたは延期

上限設定とドレインは、削除を開始するまで元に戻すことができます：

doublezero device update --pubkey <DEVICE_PUBKEY> --max-users <ORIGINAL_VALUE>   # 容量を復元
doublezero link update --pubkey <LINK_PUBKEY> --status soft-drained             # ハードドレインから戻す
doublezero link update --pubkey <LINK_PUBKEY> --status activated                # アクティブに戻す
doublezero device update --pubkey <DEVICE_PUBKEY> --status activated            # デバイスのドレインを解除

リンク、インターフェース、またはデバイスの削除は永続的であり、オンチェーンアカウントが閉じられます。撤退が確定してから削除を開始してください。