Ejecución de Unionvisor

Unionvisor es una utilidad para la gestión uniond despliegues. Gestiona la ejecución, actualización e interacción con el nodo.

Obtención de Unionvisor

Lanzamos imágenes de contenedores de Unionvisor llamadas paquetes. Cada paquete contiene todo lo necesario para ejecutar Unionvisor y unirse a una red en particular. El paquete Unionvisor para union-testnet-6 es bundle-testnet-6. Puede obtener el paquete Unionvisor para union-testnet-6 de nuestro Registro de contenedores de GitHub.

Alternativamente, puede ejecutar el siguiente comando:

docker pull ghcr.io/unionlabs/bundle-testnet-6:$UNIONVISOR_VERSION

Donde UNIONVISOR_VERSION es v0.19.0

Ejecución de Unionvisor

Antes de ejecutar esta imagen, necesitamos crear una carpeta para alojar la configuración y el estado de la cadena.

Puede crear esto donde quiera, pero lo hará en nuestro directorio de inicio de usuarios actuales.

Precaución

Es importante que pueda editar este contenido de esta carpeta.

Para crear un directorio para unionvisor en su directorio de inicio de usuario, ejecute:

mkdir ~/.unionvisor

Inicializando la configuración de cadena y la carpeta de estado

Ahora, usando el unionvisor imagen y la carpeta que acabamos de crear, podemos inicializar el contenido de esta carpeta.

Para hacer esto, usaremos los volúmenes de Docker.

docker run \  --volume ~/.unionvisor:/.unionvisor \  --volume /tmp:/tmp \  -it ghcr.io/unionlabs/bundle-testnet-6:$UNIONVISOR_VERSION \  init --moniker $MONIKER \  --network union-testnet-6 \  --seeds "[e-mail]:26656"

Donde MONIKER es el apodo preferido que le gustaría usar en este nodo.

Nota

Tenga en cuenta el uso de las banderas y argumentos a los que pasamos docker run corre aquí:

• --volume ~/.unionvisor:/.unionvisor monta la carpeta que creamos en el /.unionvisor carpeta del contenedor

• -itasegura que estamos ejecutando el contenedor de manera interactiva

Después de que el comando anterior se ejecute, debe tener un .unionvisor carpeta con los siguientes contenidos:

Migrar un Nodo Existente (Opcional)

Si tiene un nodo existente, ya sea para ejecutar el uniond imagen o binario en bruto: puede migrarlo a Unionvisor a partir de aquí.

Para migrar, solo necesita copiar sobre su uniond estado en el ~/.unionvisor/home directorio: luego inicie Unionvisor normalmente.

Si tienes un uniond estado guardado en ~/.union, puede ejecutar el siguiente comando.

sudo cp -r ~/.union/* ~/.unionvisor/home

Luego continúe siguiendo la guía normalmente.

Nota

Usamos sudo aquí porque Docker creó los archivos que estamos copiando con permisos elevados.

Emisión de Subcomandos a uniond a través de Unionvisor

Para correr uniond subcomandos, será útil alias el comando Docker en su shell .*rc archivo.

Por ejemplo, en zsh, puede agregar el siguiente alias a su .zshrc:

alias uniond='docker run -v ~/.unionvisor:/.unionvisor -v /tmp:/tmp --network host -it ghcr.io/unionlabs/bundle-testnet-6:$UNIONVISOR_VERSION --log-level off call --'

Donde UNIONVISOR_VERSION es v0.19.0

Nota

• El unionvisor call el subcomando pasa comandos y argumentos a uniond.

• Es posible que desee pasar --log-level off al llamar a Unionvisor para evitar la producción adicional al emitir subcomandos.

Esto le permitirá emitir uniond subcomandos con tales como uniond keys add con facilidad.

Iniciando el Nodo

Para ejecutar un nodo utilizando Unionvisor, también deberá exponer los puertos al contenedor. Weirll utiliza esto como una oportunidad para crear un archivo Docker Compose cuatro Unionvisor.

Un archivo mínimo de Docker Compose para Unionvisor se ve así:

services:  node:    image: ghcr.io/unionlabs/bundle-testnet-6:$UNIONVISOR_VERSION    volumes:      - ~/.unionvisor:/.unionvisor      - /tmp:/tmp    network_mode: "host"    restart: unless-stopped    command: run --poll-interval 1000

Esto montará nuestra carpeta de configuración y configuración de cadena al mismo tiempo que expondrá los puertos 26657, 1317, y 9093.

Después de crear un compose.yml archivo con el contenido anterior, podrá iniciar su nodo de Unión con docker compose.

Antes de iniciar su nodo de Union por primera vez, debe configurar su nodo correctamente.

Para algunas recomendaciones de configuración, consulte nuestro Configuración del Nodo página.

Para ejecutar su nodo en modo separado, ejecute:

docker compose --file path/to/compose.yaml up --detach