Saltar al contenido

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

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.

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 hotValency como alias de valency; si aparecen ambas claves, valency tiene prioridad. Para los grupos de topología no vacíos, valida warmValency frente al número de puntos de acceso.
  • Mantén useLedgerAfterSlot en 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 peerSnapshotFile en 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, utiliza 3.
  • Deja vacías las raíces públicas mediante "publicRoots": [{ "accessPoints": [], "advertise": false }].
  • Establece useLedgerAfterSlot en el valor de tu red, igual que en los relays.
  • El productor no necesita peerSnapshotFile ni bootstrapPeers.

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 file
topology: \"$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.yaml

Despué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.»

Doc Holiday logo

Docs authored by Doc Holiday