Ejecutar el binario cliente

Actualmente, solo estamos apoyando oficialmente la ejecución del binario Union Testnet (uniond) como contenedor Docker.

Es posible ejecutar el uniond binario fuera de los contenedores, sin embargo, no estamos suministrando directamente binarios de metal desnudo en este momento.

Esta guía asume que tienes Acoplador correctamente instalado y configurado en su sistema. Proporcionamos uniond imágenes para Linux en x86_64 (amd64) y aarch64 (arm64).

Obteniendo la Imagen Docker

Para conseguir el uniond imagen, puedes visitar nuestro contenedor en el Registro de contenedores de GitHub, o ejecute el siguiente comando:

docker pull ghcr.io/unionlabs/uniond-release:$UNIOND_VERSION

Donde UNIOND_VERSION es v0.19.0

Funcionamiento uniond

Creación de una Configuración de Cadena y Carpeta de Estado

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 uniond en el directorio de inicio de su usuario, ejecute:

mkdir ~/.union

Inicialización de la Configuración de Cadena y la Carpeta de Estado

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

Para hacer esto, usaremos volúmenes Docker.

docker run \  --user $(id -u):$(id -g) \  --volume ~/.union:/.union \  --volume /tmp:/tmp \  -it ghcr.io/unionlabs/uniond-release:$UNIOND_VERSION init $MONIKER \  --home /.union

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í:

• --user $(id -u):(id -g)asegura que el contenedor se está creando y ejecutando con el usuario actual y sus permisos

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

• -itasegura que estamos ejecutando el contenedor de forma interactiva

Después del uniond init el comando se termina de ejecutar, debe tener un .union carpeta con los siguientes contenidos:

Emisión de Subcomandos a uniond

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 ~/.union:/.union -v /tmp:/tmp --network host -it ghcr.io/unionlabs/uniond-release:$UNIOND_VERSION --home /.union'

Donde UNIOND_VERSION es v0.19.0

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

Iniciando el Nodo

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

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

services:  node:    image: ghcr.io/unionlabs/uniond-release:${UNIOND_VERSION}    volumes:      - ~/.union:/.union      - /tmp:/tmp    network_mode: "host"    restart: unless-stopped    command: start --home /.union

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.

Precaución

Antes de iniciar su nodo de Union por primera vez, debe configurar su nodo correctamente y obtener el archivo de génesis.

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

Puede descargar la génesis aquí:

génesis.json

Para ejecutar su nodo en modo separado, ejecute:

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