Ejecutar un Nodo Avalanche con Amazon Web Services (AWS)

Introducción

Este tutorial te guiará en la configuración de un nodo Avalanche en Amazon Web Services (AWS). Los servicios en la nube como AWS son una buena manera de asegurar que tu nodo sea altamente seguro, disponible y accesible.

Para empezar, necesitarás:

• Una cuenta de AWS
• Una terminal desde la cual hacer SSH a tu máquina de AWS
• Un lugar para almacenar y hacer copias de seguridad de archivos de manera segura

Este tutorial asume que tu máquina local tiene una terminal de estilo Unix. Si estás en Windows, tendrás que adaptar algunos de los comandos utilizados aquí.

Iniciar sesión en AWS

Registrarse en AWS está fuera del alcance de este artículo, pero Amazon tiene instrucciones aquí.

Es altamente recomendable que configures la Autenticación de Múltiples Factores en tu cuenta de usuario raíz de AWS para protegerla. Amazon tiene documentación para esto aquí.

Una vez que tu cuenta esté configurada, debes crear una nueva instancia EC2. Una EC2 es una instancia de máquina virtual en la nube de AWS. Ve al AWS Management Console e ingresa al panel de control de EC2.

Para iniciar sesión en la instancia EC2, necesitarás una llave en tu máquina local que conceda acceso a la instancia. Primero, crea esa llave para que luego pueda ser asignada a la instancia EC2. En la barra lateral izquierda, debajo de Red y seguridad, selecciona Pares de claves.

Selecciona Crear par de claves para lanzar el asistente de creación de pares de claves.

Nombra tu llave avalanche. Si tu máquina local tiene MacOS o Linux, selecciona el formato de archivo pem. Si es Windows, usa el formato de archivo ppk. Opcionalmente, puedes agregar etiquetas para el par de claves para ayudar con el seguimiento.

Haz clic en Crear par de claves. Deberías ver un mensaje de éxito y el archivo de la llave debería descargarse a tu máquina local. Sin este archivo, no podrás acceder a tu instancia EC2. Haz una copia de este archivo y colócalo en un medio de almacenamiento separado, como un disco duro externo. Mantén este archivo en secreto; no lo compartas con otros.

Crear un Grupo de Seguridad

Un Grupo de Seguridad de AWS define qué tráfico de internet puede entrar y salir de tu instancia EC2. Piensa en ello como un cortafuegos. Crea un nuevo Grupo de Seguridad seleccionando Grupos de seguridad bajo el desplegable Red y seguridad.

Esto abre el panel de Grupos de Seguridad. Haz clic en Crear grupo de seguridad en la parte superior derecha del panel de Grupos de Seguridad.

Necesitarás especificar qué tráfico entrante se permite. Permite el tráfico SSH desde tu dirección IP para que puedas iniciar sesión en tu instancia EC2 (cada vez que tu ISP cambia tu dirección IP, deberás modificar esta regla). Permite tráfico TCP en el puerto 9651 para que tu nodo pueda comunicarse con otros nodos en la red. Permite tráfico TCP en el puerto 9650 desde tu IP para que puedas hacer llamadas de API a tu nodo. Es importante que solo permitas tráfico en el puerto SSH y de la API desde tu IP. Si permites tráfico entrante desde cualquier lugar, esto podría usarse para forzar la entrada a tu nodo (puerto SSH) o como un vector de ataque de denegación de servicio (puerto de la API). Finalmente, permite todo el tráfico saliente.

Agrega una etiqueta al nuevo grupo de seguridad con la clave Name y el valor Grupo de Seguridad Avalanche. Esto nos permitirá saber qué grupo de seguridad es cuando lo veamos en la lista de grupos de seguridad.

Haz clic en Crear grupo de seguridad. Deberías ver el nuevo grupo de seguridad en la lista de grupos de seguridad.

Lanzar una Instancia EC2

Ahora estás listo para lanzar una instancia EC2. Ve al Panel de Control de EC2 y selecciona Lanzar instancia.

Selecciona Ubuntu 20.04 LTS (HVM), Tipo de Volumen SSD para el sistema operativo.

A continuación, elige tu tipo de instancia. Esto define las especificaciones de hardware de la instancia en la nube. En este tutorial configuramos una c5.2xlarge. Esto debería ser más que suficientemente poderoso ya que Avalanche es un protocolo de consenso liviano. Para crear una instancia c5.2xlarge, selecciona la opción Optimizado para cómputo del menú desplegable de filtros.

Selecciona la casilla junto a la instancia c5.2xlarge en la tabla.

Haz clic en el botón Siguiente: Configurar detalles de la instancia en la esquina inferior derecha.

Los detalles de la instancia pueden mantenerse en sus valores predeterminados.

info

Al configurar un nodo como validador, es crucial seleccionar el tipo de instancia AWS apropiado para asegurar que el nodo pueda procesar transacciones de manera eficiente y manejar la carga de la red. Los tipos de instancia recomendados son los siguientes:

• Para una participación mínima, comience con una instancia optimizada para cómputo como c6, c6i, c6a, c7 y similares.
• Utilice un tamaño de instancia 2xlarge para la configuración con participación mínima.
• A medida que aumenta la cantidad apostada, elija tamaños de instancia más grandes para acomodar la carga de trabajo adicional. Por cada orden de magnitud de aumento en la participación, suba un tamaño de instancia. Por ejemplo, para una participación de 20k AVAX, una instancia 4xlarge es adecuada.

Opcional: Usar Instancias Reservadas

De forma predeterminada, se te cobrará por hora por ejecutar tu instancia EC2. Para un uso a largo plazo, eso no es óptimo.

Podrías ahorrar dinero usando una Instancia Reservada. Con una instancia reservada, pagas por adelantado un año completo de uso de EC2 y recibes una tarifa más baja por hora a cambio de bloquearlo. Si tienes la intención de ejecutar un nodo durante mucho tiempo y no quieres arriesgar interrupciones del servicio, esta es una buena opción para ahorrar dinero. Nuevamente, investiga por tu cuenta antes de seleccionar esta opción.

Agregar Almacenamiento, Etiquetas, Grupo de Seguridad

Haz clic en el botón Siguiente: Agregar almacenamiento en la esquina inferior derecha de la pantalla.

Necesitas agregar espacio al disco de tu instancia. Deberías comenzar con al menos 700GB de espacio en disco. Aunque las actualizaciones para reducir el uso de disco están siempre en desarrollo, en promedio la base de datos crecerá continuamente, por lo que necesitas monitorear constantemente el uso de disco en el nodo e incrementar el espacio en disco si es necesario.

Ten en cuenta que la imagen a continuación muestra 100GB como tamaño de disco, lo cual era apropiado en ese momento en que se tomó la captura de pantalla. Debes verificar el tamaño actual recomendado de espacio en disco antes de ingresar el valor real aquí.

Haz clic en Siguiente: Agregar etiquetas en la esquina inferior derecha de la pantalla para agregar etiquetas a la instancia. Las etiquetas nos permiten asociar metadatos con nuestra instancia. Agrega una etiqueta con clave Name y valor Mi Nodo Avalanche. Esto hará claro qué es esta instancia en tu lista de instancias de EC2.

Ahora asigna el grupo de seguridad creado anteriormente a la instancia. Elige Seleccionar un grupo de seguridad existente y elige el grupo de seguridad creado anteriormente.

Finalmente, haz clic en Revisar y lanzar en la esquina inferior derecha. Una página de revisión mostrará los detalles de la instancia que estás a punto de lanzar. Revísalos y, si todo parece correcto, haz clic en el botón azul Lanzar en la esquina inferior derecha de la pantalla.

Se te pedirá que selecciones un par de claves para esta instancia. Selecciona Elegir un par de claves existente y luego selecciona el par de claves avalanche que hiciste anteriormente en el tutorial. Marca la casilla reconociendo que tienes acceso al archivo .pem o .ppk creado anteriormente (¡asegúrate de haberlo respaldado!) y luego haz clic en Lanzar instancias.

¡Deberías ver una nueva ventana emergente que confirma que la instancia se está lanzando!

Asignar una IP Elástica

Por defecto, tu instancia no tendrá una IP fija. Vamos a darle una IP fija a través del servicio de IP Elástica de AWS. Vuelve al panel de control de EC2. Bajo Red y seguridad, selecciona IPs Elásticas.

Selecciona Asignar dirección IP elástica.

Selecciona la región en la que se está ejecutando tu instancia y elige usar el pool de direcciones IPv4 de Amazon. Haz clic en Asignar.

Selecciona la IP Elástica que acabas de crear en el administrador de IP Elásticas. Desde el menú desplegable Acciones, elige Asociar dirección IP elástica.

Selecciona la instancia que acabas de crear. Esto asociará la nueva IP Elástica con la instancia y le dará una dirección IP pública que no cambiará.

Configurar AvalancheGo

Vuelve al panel de control de EC2 y selecciona Instancias en ejecución.

Selecciona la instancia de EC2 recién creada. Esto abre un panel de detalles con información sobre la instancia.

Copia el campo IPv4 Public IP para usarlo más adelante. A partir de ahora llamaremos a este valor PUBLICIP.

Recuerda: los comandos de terminal a continuación asumen que estás ejecutando Linux. Los comandos pueden ser diferentes para MacOS u otros sistemas operativos. Al copiar y pegar un comando desde un bloque de código, copia y pega la totalidad del texto en el bloque.

Inicia sesión en la instancia de AWS desde tu máquina local. Abre una terminal (prueba el atajo CTRL + ALT + T) y navega al directorio que contiene el archivo .pem que descargaste anteriormente.

Mueve el archivo .pem a $HOME/.ssh (donde generalmente residen los archivos .pem) con:

mv avalanche.pem ~/.ssh

Agrégalo al agente SSH para que podamos usarlo para SSH en tu instancia de EC2, y márcalo como de solo lectura.

ssh-add ~/.ssh/avalanche.pem; chmod 400 ~/.ssh/avalanche.pem

Haz SSH a la instancia. (Recuerda reemplazar PUBLICIP con el campo de IP pública de antes.)

ssh ubuntu@PUBLICIP

Si los permisos no están configurados correctamente, verás el siguiente error.

Ahora estás conectado a la instancia de EC2.

Si aún no lo has hecho, actualiza la instancia para asegurarte de que tenga el sistema operativo y las actualizaciones de seguridad más recientes:

sudo apt update; sudo apt upgrade -y; sudo reboot

Esto también reinicia la instancia. Espera 5 minutos, luego inicia sesión nuevamente ejecutando este comando en tu máquina local:

ssh ubuntu@PUBLICIP

Estás conectado nuevamente a la instancia de EC2. Ahora necesitaremos configurar nuestro nodo Avalanche. Para hacer esto, sigue el tutorial Configurar un Nodo Avalanche con el Instalador que automatiza el proceso de instalación. Necesitarás la PUBLICIP que configuramos antes.

Tu nodo AvalancheGo debería estar funcionando ahora y en proceso de arranque, lo cual puede llevar algunas horas. Para verificar si ha terminado, puedes hacer una llamada de API usando curl. Si estás haciendo la solicitud desde la instancia de EC2, la solicitud es:

curl -X POST --data '{
    "jsonrpc":"2.0",
    "id"     :1,
    "method" :"info.isBootstrapped",
    "params": {
        "chain":"X"
    }
}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/info

Una vez que el nodo haya terminado de arrancar, la respuesta será:

{
    "jsonrpc": "2.0",
    "result": {
        "isBootstrapped": true
    },
    "id": 1
}

Puedes continuar, incluso si AvalancheGo no ha terminado de arrancar.

Para hacer que tu nodo sea un validador, necesitarás su ID de nodo. Para obtenerlo, ejecuta:

curl -X POST --data '{
    "jsonrpc":"2.0",
    "id"     :1,
    "method" :"info.getNodeID"
}' -H 'content-type:application/json;' 127.0.0.1:9650/ext/info

La respuesta contiene el ID de nodo.

{"jsonrpc":"2.0","result":{"nodeID":"NodeID-DznHmm3o7RkmpLkWMn9NqafH66mqunXbM"},"id":1}

En el ejemplo anterior, el ID del nodo es NodeID-DznHmm3o7RkmpLkWMn9NqafH66mqunXbM. Copia tu ID de nodo para más adelante. Tu ID de nodo no es un secreto, así que puedes simplemente pegarlo en un editor de texto.

AvalancheGo tiene otras APIs, como la API de Salud, que se pueden usar para interactuar con el nodo. Algunas APIs están deshabilitadas de forma predeterminada. Para habilitar estas APIs, modifica la sección ExecStart de /etc/systemd/system/avalanchego.service (creado durante el proceso de instalación) para incluir banderas que habiliten estos puntos finales. No habilites manualmente ninguna API a menos que tengas una razón para hacerlo.

Haz una copia de seguridad de la clave de staking y el certificado del nodo en caso de que la instancia de EC2 se corrompa o no esté disponible. El ID del nodo se deriva de su clave de staking y certificado. Si pierdes tu clave de staking o certificado, entonces tu nodo obtendrá un nuevo ID de nodo, lo que podría hacer que seas inelegible para una recompensa de staking si tu nodo es un validador. Se recomienda encarecidamente que copies la clave de staking y el certificado de tu nodo. La primera vez que ejecutas un nodo, generará un nuevo par de clave/certificado de staking y los almacenará en el directorio /home/ubuntu/.avalanchego/staking.

Sal de la instancia de SSH ejecutando:

exit

Ahora ya no estás conectado a la instancia de EC2; estás de vuelta en tu máquina local.

Para copiar la clave de staking y el certificado a tu máquina, ejecuta el siguiente comando. Como siempre, reemplaza PUBLICIP.

scp -r ubuntu@PUBLICIP:/home/ubuntu/.avalanchego/staking ~/aws_avalanche_backup

Ahora tu clave de staking y certificado están en el directorio ~/aws_avalanche_backup. El contenido de este directorio es secreto. Deberías guardar este directorio en un almacenamiento no conectado a internet (como un disco duro externo).

Actualizando tu Nodo

AvalancheGo es un proyecto en curso y hay actualizaciones regulares de versión. La mayoría de las actualizaciones son recomendadas pero no requeridas. Se dará aviso previo para las actualizaciones que no sean compatibles con versiones anteriores. Para actualizar tu nodo a la última versión, SSH en tu instancia de AWS como antes y ejecuta el script de instalación nuevamente.

./avalanchego-installer.sh

Tu máquina ahora está ejecutando la versión más nueva de AvalancheGo. Para ver el estado del servicio AvalancheGo, ejecuta sudo systemctl status avalanchego.

Aumentar el Tamaño del Volumen

Si necesitas aumentar el tamaño del volumen, sigue estas instrucciones de AWS:

• Solicitar modificaciones a tus volúmenes EBS
• Extender un sistema de archivos Linux después de redimensionar un volumen

Conclusión

¡Eso es todo! Ahora tienes un nodo AvalancheGo ejecutándose en una instancia AWS EC2. Recomendamos configurar monitoreo de nodo para tu nodo AvalancheGo. También recomendamos configurar alertas de facturación de AWS para que no te lleves sorpresas cuando llegue la factura. Si tienes comentarios sobre este tutorial, o cualquier otra cosa, envíanos un mensaje en Discord.