Saltar al contenido principal

Instalando

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

Bare-Metal​

Containerizado​

  • No Orquestado: si el entorno de despliegue objetivo no incluye un orquestador de contenedores como Kubernetes, esto significa que tienes la intención de ejecutar la imagen de versión de Horizon desde dockerhub.com/stellar/stellar-horizon como un contenedor directamente con el daemon de Docker en el host. Elige la etiqueta de la imagen de Horizon para la versión específica y luego extrae 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 Chart de Helm de Horizon para gestionar el ciclo de vida de 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 README de Horizon 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 estable de SDF a tu sistema host. Si estás interesado en instalar versiones candidatas de versiones de software que aún no han alcanzado la estabilidad, consulta Añadiendo el Repositorio de Pruebas de la Última Versión. Por último, instala el paquete que describe los diversos comandos que estos paquetes ponen a disposición.

Para proceder con la instalación:

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

Versiones Precompiladas​

Consulta la lista de versiones de Horizon y versiones 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 de Horizon, tu instalación fue exitosa.

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

Instalación del Chart de Helm​

Si el despliegue se puede realizar en Kubernetes, hay un Chart de Helm de Horizon 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. A continuación, agrega el repositorio de 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 Chart de Helm de Horizon, se realizará una vez que se complete Configurando y en Ejecutándolo.

Si Kubernetes no es una opción, los charts de Helm aún pueden ser una buena referencia para mostrar cómo configurar y ejecutar el contenedor Docker de Horizon. Solo ejecuta el comando de helm con template para mostrar los manifiestos generados de Kubernetes, que demuestran todas las configuraciones de contenedores 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!