Consideraciones clave al actualizar una Subred

En el curso de la operación de una Subred, inevitablemente necesitarás actualizar o cambiar alguna parte del stack de software que está ejecutando tu Subred. Como mínimo, tendrás que actualizar el cliente de nodo AvalancheGo. Lo mismo ocurre con el binario del plugin de VM que se utiliza para ejecutar la blockchain en tu Subred, que probablemente sea el Subnet-EVM, la implementación de la Subnet de la máquina virtual Ethereum.

Las actualizaciones de nodos y VM generalmente no cambian la forma en que funciona tu Subred, en cambio, mantienen tu Subred sincronizada con el resto de la red, aportando actualizaciones de seguridad, rendimiento y características. La mayoría de las actualizaciones son opcionales, pero todas son recomendadas, y debes incluir las actualizaciones opcionales como parte del mantenimiento de rutina de tu Subred. Algunas actualizaciones serán obligatorias, y se comunicarán claramente como tales con anticipación, debes prestar especial atención a esas.

Además de las actualizaciones debido a nuevas versiones, es posible que también desees cambiar la configuración de la VM, para alterar la forma en que la Subnet se ejecuta, por diversas necesidades comerciales u operativas. Estas actualizaciones son únicamente competencia de tu equipo, y tienes control total sobre el momento de su implementación. Cualquier cambio de este tipo representa una actualización de red y debe ser cuidadosamente planificado y ejecutado.

warning

Las actualizaciones de red cambian permanentemente las reglas de tu Subred.

¡Errores de procedimiento o una actualización fallida pueden detener tu Subnet o provocar pérdida de datos!

Al realizar una actualización de Subred, cada validador en la Subnet deberá realizar la misma actualización. Si estás coordinando una actualización de red, debes programar un aviso anticipado a cada validador de la Subnet para que tengan tiempo de realizar la actualización antes de la activación. Asegúrate de tener una línea de comunicación directa con todos tus validadores.

Este tutorial te guiará a través del proceso de hacer varias actualizaciones y cambios de Subred. Señalaremos cosas a tener en cuenta y precauciones que debes tener en cuenta.

Consideraciones generales de actualización

Cuando operas una Subred, siempre debes tener en cuenta que las redes de Prueba de Participación como Avalanche solo pueden progresar si hay una cantidad suficiente de nodos validadores conectados y procesando transacciones. Cada validador en una Subnet se le asigna un cierto peso, que es un valor numérico que representa la importancia del nodo en las decisiones de consenso. En la Red Primaria, el peso es igual a la cantidad de AVAX apostados en el nodo. En las Subredes, el peso se asigna actualmente por los propietarios de la Subnet cuando emiten la transacción que agrega un validador a la Subred.

Las Subredes pueden operar normalmente solo si los validadores que representan el 80% o más del peso validador acumulativo están conectados. Si la cantidad de stake conectado cae cerca o por debajo del 80%, la rendimiento de la Subnet (tiempo de finalidad) sufrirá, y en última instancia, la Subnet se detendrá (dejará de procesar transacciones).

Como operador de una Subred, debes asegurarte de que, hagas lo que hagas, al menos el 80% del peso acumulativo de los validadores esté conectado y funcionando en todo momento.

info

Es obligatorio que el peso acumulativo de todos los validadores en la Subnet sea al menos el valor de snow-sample-size (valor predeterminado 20). Por ejemplo, si solo hay un validador en la Subred, su peso debe ser al menos snow-sample-size. Por lo tanto, al asignar peso a los nodos, siempre usa valores mayores que 20. Recuerda que el peso de un validador no se puede cambiar mientras está validando, así que asegúrate de usar un valor apropiado.

Actualización de nodos validadores de la Subred

AvalancheGo, el cliente de nodo que ejecuta los validadores Avalanche, está en constante y rápido desarrollo. Nuevas versiones salen a menudo (aproximadamente cada dos semanas), trayendo capacidades adicionales, mejoras de rendimiento o correcciones de seguridad. Las actualizaciones suelen ser opcionales, pero de vez en cuando (mucho menos frecuentemente que las actualizaciones regulares) habrá una actualización que incluye una actualización de red obligatoria. Esas actualizaciones son OBLIGATORIAS para cada nodo que ejecuta la Subred. Cualquier nodo que no realice la actualización antes de la marca de tiempo de activación dejará de funcionar inmediatamente cuando la actualización se active.

Por eso, tener una estrategia de actualización de nodos es absolutamente vital, y siempre debes actualizar a la última versión del cliente AvalancheGo inmediatamente cuando esté disponible.

Para una guía general sobre cómo actualizar AvalancheGo, consulta este tutorial. Al actualizar nodos de Subred y teniendo en cuenta la sección anterior, asegúrate de escalonar las actualizaciones de nodos y comenzar una nueva actualización solo una vez que el nodo anterior se haya actualizado correctamente. Usa la API de Salud para verificar que el valor healthy en la respuesta sea true en el nodo actualizado, y en otros validadores de la Subnet verifica que platform.getCurrentValidators() tenga true en el atributo connected para el nodeID del nodo actualizado. Una vez que se satisfacen esas dos condiciones, el nodo está confirmado como en línea y validando la Subnet y puedes comenzar a actualizar otro nodo.

Continúa el ciclo de actualización hasta que todos los nodos de la Subnet estén actualizados.

Actualización de binarios de plugin de VM de la Subred

Además del cliente AvalancheGo en sí, se lanzan nuevas versiones de los binarios de VM que ejecutan las blockchains en la Subred. En la mayoría de las Subredes, eso es el Subnet-EVM, por lo que este tutorial pasará por los pasos para actualizar el binario subnet-evm. El proceso de actualización será similar para actualizar cualquier binario de plugin de VM.

Todas las consideraciones para hacer actualizaciones escalonadas de nodos, como se discutió en la sección anterior, son válidas también para las actualizaciones de VM.

En el futuro, las actualizaciones de VM serán manejadas por la herramienta Avalanche-CLI , pero por ahora debemos hacerlo manualmente.

Ve a la página de versiones del repositorio de Subnet-EVM. Localiza la última versión y copia el enlace que corresponda al sistema operativo y la arquitectura de la máquina en la que se está ejecutando el nodo (darwin = Mac, amd64 = procesador Intel/AMD, arm64 = procesador Arm). Inicia sesión en la máquina donde se está ejecutando el nodo y descarga el archivo, usando wget y el enlace al archivo, así:

wget https://github.com/ava-labs/subnet-evm/releases/download/v0.2.9/subnet-evm_0.2.9_linux_amd64.tar.gz

Esto descargará el archivo a la máquina. Descomprímelo así (usa el nombre de archivo correcto, por supuesto):

tar xvf subnet-evm_0.2.9_linux_amd64.tar.gz

Esto descomprimirá y colocará el contenido del archivo en el directorio actual, el archivo subnet-evm es el binario del plugin. Ahora debes detener el nodo (si el nodo se está ejecutando como un servicio, usa el comando sudo systemctl stop avalanchego). Debes colocar ese archivo en el directorio de plugins donde se encuentra el binario AvalancheGo. Si el nodo está instalado usando el script de instalación, la ruta será ~/avalanche-node/plugins. En lugar del nombre de archivo subnet-evm, el binario de la VM debe tener el nombre del ID de VM de la cadena en la Subred. Por ejemplo, para la Subred WAGMI ese ID de VM es srEXiWaHuhNyGwPUi444Tu47ZEDwxTWrbQiuD7FmgSAQ6X7Dy. Entonces, el comando para copiar el nuevo binario del plugin se vería así:

Después de hacer eso, puedes volver a iniciar el nodo (si se está ejecutando como servicio, haz `sudo systemctl start avalanchego`). Puedes monitorear la salida del registro en el nodo para verificar que todo esté bien, o puedes usar la API [info.getNodeVersion()](https://docs.avax.network/apis/avalanchego/apis/info#infogetnodeversion) para verificar las versiones. Un ejemplo de salida se vería así:

```json
{
  "jsonrpc": "2.0",
  "result": {
    "version": "avalanche/1.7.18",
    "databaseVersion": "v1.4.5",
    "gitCommit": "b6d5827f1a87e26da649f932ad649a4ea0e429c4",
    "vmVersions": {
      "avm": "v1.7.18",
      "evm": "v0.8.15",
      "platform": "v1.7.18",
      "sqja3uK17MJxfC7AN8nGadBw9JK5BcrsNwNynsqP5Gih8M5Bm": "v0.0.7",
      "srEXiWaHuhNyGwPUi444Tu47ZEDwxTWrbQiuD7FmgSAQ6X7Dy": "v0.2.9"
    }
  },
  "id": 1
}

Ten en cuenta que la entrada junto a la ID de VM que actualizamos correctamente dice v0.2.9. ¡Has actualizado con éxito la VM!

Consulta la sección anterior sobre cómo asegurarte de que el nodo esté saludable y conectado antes de pasar a actualizar el siguiente validador de Subnet.

Si no obtienes el resultado esperado, puedes detener AvalancheGo, examinar y seguir de cerca paso a paso lo anterior. Eres libre de eliminar archivos en ~/avalanche-node/plugins, sin embargo, debes tener en cuenta que eliminar archivos es para eliminar una VM binaria existente. Debes colocar el complemento de VM correcto en su lugar antes de reiniciar AvalancheGo.

Actualizaciones de Red

A veces necesitas hacer una actualización de red para cambiar las reglas configuradas en el génesis bajo las cuales opera la Cadena. En EVM regular, las actualizaciones de red son un proceso bastante complicado que incluye desplegar la nueva binaria de EVM, coordinar la actualización programada y desplegar cambios en los nodos. Pero desde Subnet-EVM v0.2.8, hemos introducido la esperada función de realizar actualizaciones de red usando solo unas pocas líneas de JSON. Las actualizaciones pueden consistir en habilitar/deshabilitar precompilaciones particulares o cambiar sus parámetros. Las precompilaciones disponibles actualmente te permiten:

• Restringir los desplegadores de contratos inteligentes
• Restringir quién puede enviar transacciones
• Acuñar monedas nativas
• Configurar tarifas dinámicas

Consulta Personalizar una Subnet para obtener una discusión detallada de los posibles parámetros de actualización de precompilación.

Resumen

Una parte vital del mantenimiento de una Subnet es realizar actualizaciones oportunas en todos los niveles de la pila de software que ejecuta tu Subnet. Esperamos que este tutorial te brinde suficiente información y contexto para permitirte realizar esas actualizaciones con confianza y facilidad. Si tienes preguntas adicionales o algún problema, no dudes en comunicarte con nosotros en Discord.