Procedimiento de Instalación
Este documento describe los pasos requeridos para instalar CRESTONE en un servidor. Siga el procedimiento detalladamente para garantizar un despliegue exitoso.
1. Requisitos Previos
Antes de comenzar, asegúrese de contar con:
- Un servidor Linux (se recomienda Ubuntu) con privilegios de
sudo. Consulte los Requisitos Mínimos Técnicos para más detalles sobre el servidor. - Conectividad a Internet para descargar el paquete del instalador (o acceso a una copia del mismo).
- Dirección IP o nombre DNS del servidor que se utilizará durante la instalación.
2. Descargar el Paquete del Instalador
El instalador de CRESTONE se suministra como un paquete comprimido .tar.gz alojado en AWS S3.
Ejecute el siguiente comando para descargarlo:
curl -fLO https://seidor-analytics-products.s3.amazonaws.com/crestone/crestone_installer_latest.tar.gz
3. Extraer el Paquete
Descomprima el archivo en su directorio de trabajo:
tar -xzvf crestone_installer_latest.tar.gz
Acceda al directorio desempaquetado:
cd crestone_installer
4. Ejecutar el Instalador
Inicie el proceso de instalación ejecutando:
sudo bash ./install.sh
- El script le guiará a través de los pasos de instalación y configurará automáticamente todos los componentes de CRESTONE.
Los mensajes esperados incluyen pasos de progreso como:
🛠️ [Step 1/10] Check prerequisites
✅ Done: Docker ready
...
🛠️ [Step 11/11] Finalize NPM proxy hosts via API (save & reload)
✅ Done: NPM API finalize (host or in-container)
Al finalizar, debería visualizar:
🎉 Installation complete (steps 11/11).
5. Verificar la Instalación
Una vez finalizada la instalación, pruebe el sistema abriendo las siguientes URLs en su navegador:
-
CRESTONE UI:
http://crestone.<SERVER_IP>.nip.ioo
http://<SERVER_DNS>
6. Resolución de Problemas (Troubleshooting)
- Si los contenedores no inician, vuelva a ejecutar el instalador:
code
sudo bash ./install.sh --yes --server <SERVER_IP_OR_DNS> - Si se agota el espacio en disco mientras se escriben los archivos tar de las imágenes:
Asegúrese de contar con suficiente espacio libre. El instalador completo (todas las imágenes/tars) típicamente requiere entre ~20 y 30 GB libres durante la descompresión y la carga en Docker (code
Cannot write: No space left on devicedocker load), dado que los archivos tar y las capas extraídas coexisten temporalmente. Se recomienda disponer de >30 GB libres para mayor seguridad.
Comandos Habituales
- Levantar el stack de CRESTONE:
code
sudo docker compose -p crestone -f /crestone/docker-compose-full.yml --env-file /crestone/.env.runtime up -d --pull=never - Detener el stack de CRESTONE manualmente:
code
sudo docker compose -p crestone -f /crestone/docker-compose-full.yml --env-file /crestone/.env.runtime down - Ver los logs:
code
sudo docker compose -f ./docker-compose-full.yml -p crestone logs -f --tail=200 - Reiniciar todos los servicios:
code
sudo bash ./restart.sh - Asegurar que los servicios estén activos antes de reiniciar:
code
sudo bash ./restart.sh --ensure-up
✅ Ya está listo para utilizar CRESTONE.