Saltar al contenido principal

Ejecutando

Con la imagen de Docker disponible y el archivo de configuración configurado, ahora estás listo para ejecutar Galexie y comenzar a exportar datos del ledger Stellar al bucket de GCS.

Uso de la Línea de Comando​

Comando Append​

Esta es la forma principal de ejecutar Galexie. El comando append opera en dos modos distintos:

  • En modo continuo/sin límites, comienza a exportar desde el ledger de inicio especificado y exporta continuamente nuevos ledgers que aparecen en la red hasta que el proceso se interrumpe.
  • En modo de rango fijo, exporta el rango de ledgers especificado y sale cuando se completa.

Sintaxis:

stellar-galexie append --start <start_ledger> [--end <end_ledger>] [--config-file <config_file>]

Argumentos:

--start <start_ledger> (requerido)

  • El número de secuencia del ledger inicial del rango que se está exportando.

--end <end_ledger> (opcional)

  • El número de secuencia del ledger final del rango que se está exportando. Si no se especifica o se establece en 0, el exportador continuará exportando nuevos ledgers a medida que aparezcan en la red.

--config-file <config_file_path> (opcional)

  • La ruta al archivo de configuración. Si no se especifica, la aplicación buscará un archivo llamado config.toml en el directorio actual.

Ejemplo de uso:

docker run --platform linux/amd64 -d \
-v "$HOME/.config/gcloud/application_default_credentials.json":/.config/gcp/credentials.json:ro \
-e GOOGLE_APPLICATION_CREDENTIALS=/.config/gcp/credentials.json \
-v ${PWD}/config.toml:/config.toml \
stellar/stellar-galexie \
append --start 350000 --end 450000 --config-file config.toml

--platform linux/amd64

  • Especifica la arquitectura de la plataforma (ajusta si es necesario para tu sistema).

-v Monta volúmenes para mapear tus credenciales de GCP locales y el archivo config.toml al contenedor:

  • $HOME/.config/gcloud/application_default_credentials.json: Tu archivo de credenciales local de GCP.
  • ${PWD}/config.toml: Tu archivo de configuración local.

-e GOOGLE_APPLICATION_CREDENTIALS=/.config/gcp/credentials.json

  • Establece la variable de entorno para las credenciales dentro del contenedor.

stellar/stellar-galexie

  • El nombre de la imagen de Docker.

Integridad de Datos y Reanudabilidad:​

El comando append mantiene una estricta integridad secuencial dentro de cada sesión de exportación. Si se interrumpe y luego se reinicia con el mismo rango, automáticamente reanuda desde donde se detuvo antes de la interrupción, asegurando que no se pierdan ledgers dentro de una sesión.

Comando Scan-and-fill​

El comando scan-and-fill es útil en casos donde hay huecos en los ledgers exportados en el lago de datos. El comando funciona escaneando todos los ledgers en el rango especificado, identificando los ledgers faltantes y exportando solo los ledgers faltantes mientras omite los ledgers existentes en el lago de datos.

El comando append asegura que no haya huecos en el rango exportado. Sin embargo, los huecos pueden ocurrir en el lago de datos debido a ciertas secuencias de eventos, a menudo por intervención del usuario, como:

  • Eliminación manual de ledgers del lago de datos. Por ejemplo, eliminar los ledgers 80-90 del rango 1-100.
  • Ejecutar rangos de exportación no contiguos. Por ejemplo, exportar rangos 1-50 y 60-100, dejando un hueco entre 50-60. En este caso, ejecutar el comando append con el rango 1-500 hace que Galexie reanude la exportación desde 101, sin llenar el hueco.

Sintaxis:

stellar-galexie scan-and-fill --start <start_ledger> --end <end_ledger> [--config-file <config_file>]

Argumentos:

--start <start_ledger> (requerido)

  • El número de secuencia del ledger inicial del rango que se está exportando.

--end <end_ledger> (requerido)

  • El número de secuencia del ledger final del rango que se está exportando.

--config-file <config_file_path> (opcional):

  • La ruta al archivo de configuración. Si no se especifica, el exportador buscará un archivo llamado “config.toml” en el directorio actual.

Ejemplo de uso:

docker run --platform linux/amd64 -d \
-v "$HOME/.config/gcloud/application_default_credentials.json":/.config/gcp/credentials.json:ro \
-e GOOGLE_APPLICATION_CREDENTIALS=/.config/gcp/credentials.json \
-v ${PWD}/config.toml:/config.toml \
stellar/stellar-galexie \
scan-and-fill --start 64000 --end 68000 --config-file config.toml