Saltar al contenido principal

Instalar

Para instalar Horizon en entornos de producción o no desarrollo, recomendamos lo siguiente según la infraestructura objetivo:

Bare-Metal​

Containerizado​

  • No Orquestado: si el entorno de despliegue objetivo no incluye un orquestador de contenedores como Kubernetes, significa que tienes la intención de ejecutar la imagen de lanzamiento de Horizon desde dockerhub.com/stellar/stellar-horizon como un contenedor directamente con el demonio de Docker en el host. Elige la etiqueta de la imagen de Horizon para la versión de lanzamiento específica y luego descarga la imagen usando docker pull stellar/stellar-horizon:<tag_version> para obtenerla localmente en el host. Elige la etiqueta de la imagen de Horizon para la versión de lanzamiento específica y luego descarga la imagen usando docker pull stellar/stellar-horizon:<tag_version> para obtenerla localmente en el host.
  • Orquestado: cuando el entorno objetivo tiene orquestación de contenedores, como un clúster de Kubernetes, recomendamos usar el Horizon Helm Chart para gestionar el ciclo de vida de la instalación y despliegue de la imagen de Horizon como contenedor(es) en el clúster.

Para instalar Horizon en entornos de desarrollo, consulta el Horizon README del repositorio del código fuente para las opciones disponibles.

Notas sobre la Instalación​

Gestor de Paquetes​

SDF publica nuevas versiones en sus repositorios personalizados de Ubuntu. Sigue esta guía para agregar el repositorio SDF estable a tu sistema host. Si estás interesado en instalar versiones de versión candidata de software que aún no han alcanzado la estabilidad, consulta Añadiendo el Repositorio de Pruebas de Última Hora. Por último, instalar paquete detalla los varios comandos que estos paquetes hacen disponibles.

Para proceder con la instalación:

sudo apt update
sudo apt install stellar-horizon stellar-core

Lanzamientos Precompilados​

Consulta la lista de lanzamientos de Horizon y lanzamientos de Core. Copia los binarios al PATH del host.

Verificar Instalaciones Bare-Metal​

Ejecuta stellar-horizon --help desde una terminal. Si se muestra la ayuda para Horizon, tu instalación fue exitosa.

Algunos shells (como zsh) almacenan en caché las búsquedas del PATH. Es posible que necesites limpiar tu caché (usando rehash en zsh, por ejemplo) o reiniciar tu shell antes de intentar ejecutar el comando anterior.

Instalación del Helm Chart​

Si el despliegue se puede hacer en Kubernetes, hay un Horizon Helm Chart disponible. Instala la Herramienta CLI de Helm, si aún no lo has hecho en tu estación de trabajo, mínimo de versión 3. Luego, agrega el repositorio Stellar a la lista de repositorios del cliente de helm y confirma que puedes ver la lista de versiones de chart disponibles para el repositorio:

helm repo add stellar https://helm.stellar.org/charts
helm repo update stellar
helm search repo stellar/horizon --versions --devel

Espera para instalar el Helm Chart de Horizon, se realizará después de que se completen Configurando y en Ejecutando.

Si Kubernetes no es una opción, los helm charts aún pueden ser una buena referencia para mostrar cómo configurar y ejecutar el contenedor de Docker de Horizon. Solo ejecuta el comando helm con template para mostrar los manifiestos de Kubernetes generados, que demuestran todas las configuraciones de contenedor necesarias:

git clone https://github.com/stellar/helm-charts; cd helm-charts
helm template -f charts/horizon/values.yaml charts/horizon/

Próximo Paso​

Después de que la instalación esté completa, ahora estás listo para proceder a Configurar Horizon!