Guía de topología
Dingo funciona con el archivo de topología predeterminado integrado, pero como SPO debes utilizar tu propio topology.json. Esta guía utiliza como ejemplo la topología de preview. Los archivos de topología de todas las redes están en la documentación de entornos de Cardano.
Adapta la configuración a tu red y a la distribución de tus nodos. Esta guía utiliza la distribución habitual de un productor de bloques detrás de dos relays.
Contenido de la guía:
- Topología JSON predeterminada de Preview
- Opciones de topología
- Ejemplo de topología de relay
- Ejemplo de topología de productor de bloques
Topología JSON predeterminada de Preview
El archivo JSON de topología predeterminado de Preview tiene este aspecto:
{ "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}Copia useLedgerAfterSlot y bootstrapPeers de la topología oficial de tu red. El slot de Preview del ejemplo quedará desactualizado y no es válido para preprod/mainnet.
Opciones de topología
Para modificar y utilizar el archivo JSON de topología, es importante conocer estos conceptos:
Pares locales y públicos
Las raíces locales se utilizan para los pares que el nodo debe mantener siempre en estado hot o warm, como su propio productor de bloques. Las raíces públicas proporcionan pares alternativos.
Pares de arranque
Los pares de arranque son útiles después de una interrupción prolongada: el nodo se sincroniza desde esos pares y utiliza los pares del ledger cuando alcanza la punta.
Opción advertise
Cuando advertise es true, el nodo puede compartir la dirección de ese par mediante peer sharing. Esto puede aumentar las conexiones entrantes al par anunciado y resulta útil para relays no registrados. Nunca anuncies al productor de bloques.
Puntos de acceso
Los puntos de acceso pertenecen a un grupo localRoots. Así puedes mantener advertise en false para el productor de bloques y en true para el relay.
Opción trustable
Dingo acepta trustable para que los archivos de topología de cardano-node se carguen sin cambios, pero no utiliza la opción. Una raíz local con trustable no ayuda a un nodo retrasado respecto a la punta a salir de la selección de cadena Genesis.
En mainnet, preprod y preview, el valor predeterminado genesisBootstrap.corroborationPeers: 0 desactiva la comprobación de corroboración durante la selección de cadena Genesis. Un valor positivo de corroborationPeers activa explícitamente esta comprobación. Dingo no añade grupos de control específicos de la red cuando falta genesisBootstrap.controlGroups en dingo.yaml; el operador debe configurar este campo explícitamente para definir un conjunto fijo. Cuando el operador configura controlGroups, solo cuentan los endpoints listados, agrupados por su identity.
Ejemplo de topología de relay
Para una distribución típica de dos relays y un productor de bloques, utiliza esta configuración en el relay:
- Usa dos grupos localRoots para anunciar los demás relays y ocultar al productor de bloques.
- Configura
"advertise": false,en el grupo que contiene al productor para mantenerlo privado. - Como hay un relay adicional, dos en total, establece
"valency": 1. Con dos relays adicionales, tres en total, utiliza"valency": 2, y así sucesivamente. - Dingo admite
hotValencycomo alias devalency; si aparecen ambas claves,valencytiene prioridad. Para los grupos de topología no vacíos, validawarmValencyfrente al número de puntos de acceso. - Mantén
useLedgerAfterSloten el valor de tu red, para que el relay pueda ponerse al día si se queda atrás respecto a la punta. - El modo Genesis/snapshot utiliza
peerSnapshotFileen lugar de los pares de arranque o junto con ellos. - Deja vacías las raíces públicas mediante
"publicRoots": [{ "accessPoints": [], "advertise": false }].
En el siguiente ejemplo, sustituye relay2.Address y blockProducerAddress por las direcciones del relay y del productor de bloques, y cambia "port": 3001 al puerto utilizado.
{ "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}Ejemplo de topología de productor de bloques
Un productor de bloques mantiene tus propios relays como sus únicas raíces locales. Utiliza esta configuración:
- Establece
"bootstrapPeers": null. - Establece
"advertise": false,, porque estas raíces locales del productor deben permanecer privadas. - Este ejemplo utiliza dos relays y establece
"valency": 2. Con tres relays, utiliza3. - Deja vacías las raíces públicas mediante
"publicRoots": [{ "accessPoints": [], "advertise": false }]. - Establece
useLedgerAfterSloten el valor de tu red, igual que en los relays. - El productor no necesita
peerSnapshotFilenibootstrapPeers.
Ejemplo de archivo JSON de topología del productor de bloques:
{ "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}Después de guardar cada archivo de topología, indica su ruta a Dingo, reinicia el nodo y comprueba que el productor de bloques mantenga conexiones hot con tus relays.
Añade lo siguiente al archivo /etc/dingo/dingo.yaml existente, sin sobrescribirlo:
sudo bash -c "cat <<EOF >> /etc/dingo/dingo.yaml# Path to the topology configuration filetopology: \"$DINGO_HOME/config/topology.json\"EOF"Las rutas siguen las guías para SPO de Dingo; ajústalas si es necesario. $DINGO_HOME se expande al ejecutar el comando, igual que en la guía de instalación del nodo. Utiliza un topology.json distinto en el productor de bloques y en cada relay.
Comprueba el archivo:
sudo nano /etc/dingo/dingo.yamlDespués reinicia:
sudo systemctl restart dingo¡Enhorabuena! Ya tienes archivos de topología personalizados para los relays y el productor de bloques.
Sección titulada «¡Enhorabuena! Ya tienes archivos de topología personalizados para los relays y el productor de bloques.»Docs authored by Doc Holiday