トポロジーガイドの概要
Dingo は組み込みの既定トポロジーでも動作しますが、SPO は独自の topology.json を使用してください。このガイドでは Preview ネットワークのファイルを例にします。全ネットワークのファイルは Cardano の環境一覧にあります。
ネットワークとノード構成に合わせて変更してください。ここでは、2 つのリレーの背後に 1 つのブロックプロデューサーを配置する一般的な構成を使用します。
このガイドの内容:
既定の Preview トポロジー JSON
既定の Preview トポロジー JSON は次の形式です。
{ "bootstrapPeers": [ { "address": "preview-node.play.dev.cardano.org", "port": 3001 } ], "localRoots": [ { "accessPoints": [], "advertise": false, "trustable": false, "valency": 1 } ], "peerSnapshotFile": "peer-snapshot.json", "publicRoots": [ { "accessPoints": [], "advertise": false } ], "useLedgerAfterSlot": 119231973}
useLedgerAfterSlotとbootstrapPeersは、そのネットワークの公式トポロジーからコピーします。上記の Preview スロットは時間とともに古くなり、preprod/mainnet には適しません。
トポロジーフラグの意味
トポロジー JSON を変更して使用するため、次の項目を理解してください。
ローカルピアと公開ピア
ローカルルートは、自分のブロックプロデューサーなど、常にホットまたはウォームに保つピア向けです。公開ルートは代替ピアの取得元です。
ブートストラップピア
ノードが長時間停止していた場合に役立ちます。これらのピアから同期し、先端に到達したら台帳ピアを使用します。
advertise フラグ
advertise が true の場合、ピア共有によってそのピアのアドレスを共有でき、着信接続が増える可能性があります。未登録のリレーで役立ちます。ブロックプロデューサーを広告してはいけません。
アクセスポイント
アクセスポイントは localRoots グループ内に配置します。これにより、BP の advertise を false にし、リレーでは true にできます。
trustable フラグ
Dingo は cardano-node のトポロジーファイルを変更せずに読み込めるよう trustable を受け付けますが、このフラグは使用しません。trustable のローカルルートは、先端から遅れたノードが Genesis チェーン選択を抜ける助けにはなりません。
mainnet、preprod、preview では、既定の genesisBootstrap.corroborationPeers: 0 により、Genesis チェーン選択の確認ゲートを無効にします。corroborationPeers に正の値を明示的に設定すると、確認ゲートが有効になり、チェーンに従う前に指定数の独立したグループに属するピアの確認が必要になります。dingo.yaml に genesisBootstrap.controlGroups がない場合、Dingo はネットワーク固有の制御グループを自動的に追加しません。固定の制御グループを使用する場合は、genesisBootstrap.controlGroups を明示的に設定してください。設定すると、記載したエンドポイントだけを対象にし、その identity ごとにグループ化します。
リレー用トポロジー例
一般的な 2 リレーと BP の構成では、リレーのトポロジーを次のように設定します。
- BP を隠しながら他のリレーを広告できるよう、localRoots を 2 グループに分けます。
- BP を含むグループは
"advertise": false,にして、BP を非公開に保ちます。 - 他のリレーが 1 つ(合計 2 つ)なら “valency”: 1、他のリレーが 2 つ(合計 3 つ)なら “valency”: 2 とします。
hotValencyはvalencyの別名として使用でき、両方があればvalencyが優先されます。空でないトポロジーグループでは、アクセスポイント数に対してwarmValencyを検証します。- 先端から遅れても追いつけるよう、
useLedgerAfterSlotはネットワークの値のままにします。 - Genesis/スナップショットモードでは、ブートストラップピアの代わりに、または併用して
peerSnapshotFileを使用します。 "publicRoots": [{ "accessPoints": [], "advertise": false }]で公開ルートを空にします。
次の例では “relay2.Address” と “blockProducerAddress” を自分のリレーと BP のアドレスに、“port”: 3001 を使用するポートに変更してください。
{ "bootstrapPeers": [ { "address": "preview-node.play.dev.cardano.org", "port": 3001 } ], "localRoots": [ { "accessPoints": [ { "address": "relay2.Address", "port": 3001 } ], "advertise": true, "valency": 1, "trustable": true }, { "accessPoints": [ { "address": "blockProducerAddress", "port": 3001 } ], "advertise": false, "valency": 1, "trustable": true } ], "peerSnapshotFile": "peer-snapshot.json", "publicRoots": [ { "accessPoints": [], "advertise": false } ], "useLedgerAfterSlot": 119231973}BP 用トポロジー例
ブロックプロデューサーは、自分のリレーだけをローカルルートにします。
"bootstrapPeers": nullにします。- BP のローカルルートを非公開に保つため、
"advertise": false,にします。 - この例はリレーが 2 つなので
"valency": 2にします。3 つなら3にします。 "publicRoots": [{ "accessPoints": [], "advertise": false }]で公開ルートを空にします。- リレーと同様に、
useLedgerAfterSlotをネットワークの値にします。この設定により、BP は台帳ピアにも接続します。 - BP に
peerSnapshotFileやbootstrapPeersは不要です。
BP 用トポロジー JSON の例:
{ "bootstrapPeers": null, "localRoots": [ { "accessPoints": [ { "address": "relay1.Address", "port": 3001 }, { "address": "relay2.Address", "port": 3001 } ], "advertise": false, "trustable": true, "valency": 2 } ], "publicRoots": [ { "accessPoints": [], "advertise": false } ], "useLedgerAfterSlot": 119231973}各トポロジーファイルを保存後、Dingo がそのファイルを使用するよう設定して再起動し、BP が自分のリレーにホット接続していることを確認します。
既存の /etc/dingo/dingo.yaml に次を追加します。ファイルを上書きしないでください。
sudo bash -c "cat <<EOF >> /etc/dingo/dingo.yaml# Path to the topology configuration filetopology: \"$DINGO_HOME/config/topology.json\"EOF"パスは Dingo SPO ガイドに合わせています。必要に応じて調整してください。
$DINGO_HOME はノードセットアップガイドと同様に、コマンド実行時に展開されます。BP と各リレーには、それぞれ異なる topology.json を使用します。
ファイルを確認します。
sudo nano /etc/dingo/dingo.yaml再起動します。
sudo systemctl restart dingoリレーとブロックプロデューサーの独自トポロジーを設定できました。
Section titled “リレーとブロックプロデューサーの独自トポロジーを設定できました。”Docs authored by Doc Holiday