Ejecutar un Fullnode Indexer

Precaución

Esta es documentación para el indexer legacy. Para aprender cómo ejecutar la infraestructura subyacente para la pila de indexer más reciente, ver Transaction Stream Service.

Precaución

Los pasos de instalación abajo están verificados solo en macOS con Apple Silicon. Podrían requerir ajustes menores al ejecutar en otras builds.

Resumen

Para ejecutar un fullnode indexer, estos son los pasos en resumen:

1. Asegurar que tienes todas las herramientas y paquetes requeridos descritos abajo en este documento.
2. Seguir las instrucciones para configurar un fullnode público pero no iniciar el fullnode aún.
3. Editar el fullnode.yaml como se describe abajo en este documento.
4. Ejecutar el fullnode indexer según las instrucciones abajo.

Prerrequisitos

Instala los paquetes abajo. Nota, puedes haber instalado ya muchos de estos mientras preparabas tu entorno de desarrollo. Puedes confirmar ejecutando which command-name y asegurando que el paquete aparezca en la salida (aunque libpq no será devuelto incluso cuando esté instalado).

Importante: Si estás en macOS, necesitarás instalar Docker siguiendo la guía oficial en lugar de brew.

Para un fullnode indexer de Aptos, instala estos paquetes:

• brew - /bin/bash -c "$(curl -fsSL https://raw.githubusercontent.com/Homebrew/install/HEAD/install.sh)" Ejecuta los comandos emitidos en la salida para agregar el comando a tu path e instalar cualquier dependencia
• cargo Rust package manager - curl --proto '=https' --tlsv1.2 -sSf https://sh.rustup.rs | sh
• docker - brew install docker
• libpq Postgres C API library containing the pg_ctl command - brew install libpq Asegurar de realizar todos los comandos export después de la instalación.
• postgres PostgreSQL server - brew install postgresql
• diesel - brew install diesel

Configurar la base de datos

1. Iniciar el servidor PostgreSQL: brew services start postgresql
2. Asegurar que puedas ejecutar psql postgres y luego salir del prompt ingresando: \q
3. Crear un usuario PostgreSQL postgres con el comando createuser (encuéntralo con which):

   /path/to/createuser -s postgres

4. Clonar el repositorio aptos-core si no lo has hecho ya:

   git clone https://github.com/aptos-labs/aptos-core.git

5. Navegar (o cd) al directorio aptos-core/crates/indexer.
6. Crear el esquema de base de datos:

   diesel migration run --database-url postgresql://localhost/postgres

   Esto creará un esquema de base de datos con el subdirectorio migrations ubicado en este directorio aptos-core/crates/indexer. Si por alguna razón esta base de datos ya está en uso, prueba una base de datos diferente. Por ejemplo: DATABASE_URL=postgres://postgres@localhost:5432/indexer_v2 diesel database reset

Iniciar el fullnode indexer

1. Seguir las instrucciones para configurar un fullnode público y preparar la configuración, pero no iniciar aún el indexer (con cargo run o docker run).

2. Obtener la imagen Docker del indexer más reciente con:

   docker pull aptoslabs/validator:nightly_indexer

3. Editar el ./fullnode.yaml y agregar la siguiente configuración:

   storage:
     enable_indexer: true
     # Esto es para evitar que el nodo sea podado
     storage_pruner_config:
       ledger_pruner_config:
         enable: false
   
   indexer:
     enabled: true
     postgres_uri: "postgres://postgres@localhost:5432/postgres"
     processor: "default_processor"
     check_chain_id: true
     emit_every: 500

Nota

Bootstrapping el fullnode

En lugar de sincronizar tu fullnode indexer desde génesis, lo que puede tomar un largo período de tiempo, puedes elegir bootstrapear tu fullnode usando datos de respaldo antes de iniciarlo. Para hacerlo, sigue las instrucciones para restaurar desde un respaldo.

Nota: los indexers no pueden ser bootstrapeados usando un snapshot o fast sync.

1. Ejecutar el fullnode indexer con ya sea cargo run o docker run dependiendo de tu configuración. Recuerda suministrar los argumentos que necesitas para tu nodo específico:

   docker run -p 8080:8080 \
     -p 9101:9101 -p 6180:6180 \
     -v $(pwd):/opt/aptos/etc -v $(pwd)/data:/opt/aptos/data \
     --workdir /opt/aptos/etc \
     --name=aptos-fullnode aptoslabs/validator:nightly_indexer aptos-node \
     -f /opt/aptos/etc/fullnode.yaml

   o:

   cargo run -p aptos-node --features "indexer" --release -- -f ./fullnode.yaml

Reiniciar el indexer

Para reiniciar el servidor PostgreSQL:

1. Apagar el servidor buscando el proceso postmaster y matándolo:

   ps -ef | grep -i postmaster

2. Copiar el ID de proceso (PID) para el proceso y pasarlo al siguiente comando para apagarlo:

   kill -INT PID

3. Reiniciar el servidor PostgreSQL con:

   brew services restart postgresql@14