Cómo ejecutar tu nodo ADAMANT en Docker (Windows o Mac)

Nota: La imagen de Docker puede estar desactualizada; se recomienda ejecutar un nodo ADAMANT en un servidor Ubuntu. ADAMANT utiliza Prueba de Participación Delegada (dPoS) para el consenso de la blockchain, y ejecutar tu propio nodo mejora la descentralización de la red.

Esta guía explica cómo instalar, ejecutar y actualizar un nodo ADAMANT en Windows, macOS o Linux usando Docker. El ejemplo utiliza Windows 10, que requiere una versión de 64 bits de Windows 10 Pro, Enterprise o Education (Build 14393 o posterior). La máquina anfitriona debe tener al menos 4 GB de RAM y 50 GB de espacio libre en disco, dependiendo de la altura actual del bloque.

Para instalar Docker, descarga la edición gratuita Docker Community Edition y ejecuta el instalador. Sigue el asistente para aceptar la licencia y autorizar el instalador con tu contraseña de sistema, necesaria para los componentes de red y las máquinas virtuales Hyper-V. Después de la instalación, inicia Docker desde el menú Inicio. Una vez que el icono de ballena en la barra de estado se vuelva estable, Docker está funcionando. También debes compartir tu unidad local con Docker haciendo clic derecho en el icono de la barra de estado, seleccionando Configuración, marcando la casilla de la unidad compartida y aplicando los cambios.

Para instalar el nodo ADAMANT, primero instala un cliente Git usando las opciones predeterminadas. Abre Microsoft PowerShell y clona el repositorio:

git clone https://github.com/Adamant-im/adamant-docker
cd adamant-docker

Para ejecutar el nodo, descarga las imágenes de Docker necesarias:

docker-compose pull

Inicia el servicio de base de datos y verifica que se haya lanzado correctamente:

docker-compose up -d db
docker-compose logs

A continuación, inicia el servicio adamant-node y verifica los registros para confirmar un inicio exitoso:

docker-compose up -d adamant-node

Puedes detener todos los servicios en ejecución con docker-compose stop y reiniciarlos más tarde usando docker-compose start.

Valida la instalación verificando el registro de la aplicación del nodo:

docker-compose logs --tail=10 adamant-node

El argumento --tail=10 limita la salida a las últimas 10 líneas del registro. Para verificar que el nodo esté conectado a la blockchain ADAMANT, visita el monitor de red ADAMANT y encuentra tu nodo por su dirección IP. Puede tardar unos minutos en aparecer. Un nodo recién instalado mostrará una altura de bloque de 1 mientras se sincroniza, lo cual puede tardar hasta un día dependiendo de tu conexión y CPU.

Para verificar la altura directamente, obtén el ID del contenedor usando docker ps, luego consulta la API del nodo:

docker ps
docker exec <container_id> curl -k -X GET http://localhost:36666/api/blocks/getHeight

Cuando la sincronización finalice, la altura coincidirá con otros nodos en la red. Para actualizar el nodo ADAMANT, abre PowerShell y ejecuta los siguientes comandos:

cd adamant-docker
docker-compose stop
docker-compose pull
docker-compose down
docker-compose up -d db
docker-compose up -d adamant-node