Ponga en marcha WIS2 Downloader y descargue sus primeros datos en pocos minutos.

Requisitos previos

1. Descargar y extraer

Descargue el archivo comprimido de la última versión y extráigalo:

tar -xzf wis2downloader-*.tar.gz
cd wis2downloader-*
Para usar la última versión de desarrollo, clone el repositorio: git clone https://github.com/World-Meteorological-Organization/wis2downloader.git

2. Configurar

Ejecute el script de configuración para crear un archivo .env con secretos generados aleatoriamente:

bash setup.sh

Este script copia default.env a .env y genera valores aleatorios para FLASK_SECRET_KEY y REDIS_PASSWORD. Revise el archivo .env y ajuste los parámetros si es necesario — los valores predeterminados son adecuados para un despliegue en una sola máquina.

Mantenga el archivo .env seguro. Contiene credenciales sensibles y no debe incluirse en el control de versiones.

3. Instalar el plugin Docker de Loki

WIS2 Downloader utiliza el controlador Docker de Loki para el envío de registros. Instálelo antes de iniciar la pila:

ARCH=$(uname -m | sed 's/x86_64/amd64/;s/aarch64/arm64/')
docker plugin install grafana/loki-docker-driver:3.6.7-${ARCH} --alias loki --grant-all-permissions

Verifique que el plugin está habilitado:

docker plugin ls

Debería ver loki:latest con ENABLED en true.

Si obtiene un error durante la instalación, compruebe su arquitectura con uname -m. Los valores más comunes son x86_64 (amd64) y aarch64 (arm64).

4. Configurar el directorio de descargas

Los contenedores se ejecutan como un usuario no-root (UID 10001, GID 988). En Linux debe configurar el directorio de descargas antes de iniciar:

sudo groupadd -g 988 wis2
sudo useradd -u 10001 -g wis2 -M -s /usr/sbin/nologin wis2
mkdir -p downloads
sudo chown wis2:wis2 downloads
En macOS y Windows (Docker Desktop) este paso no es necesario — Docker Desktop gestiona los permisos de volumen automáticamente.

Si no puede crear un usuario equivalente, consulte la sección Permisos de volumen de la Guía de administración para alternativas basadas en ACL.

5. Iniciar los servicios

docker compose up -d

Este comando inicia todos los servicios: gestor de suscripciones, suscriptores MQTT (Global Brokers de Francia y Brasil), workers Celery de descarga, Redis, Prometheus, Grafana y Loki.

Compruebe que todo esté funcionando:

docker compose ps

Espere a que pase la comprobación de estado de subscription-manager (aproximadamente 30 segundos) y luego confirme que está activo:

curl http://localhost:5002/health

6. Crear una suscripción

A través de la interfaz web (recomendado)

Abra http://localhost:8080 en su navegador.

Use la Vista de catálogo o la Vista de árbol para explorar los conjuntos de datos WIS2 disponibles, seleccione un tema, elija un directorio de guardado y haga clic en Suscribirse.

A través de la API

curl -X POST http://localhost:5002/subscriptions \
  -H "Content-Type: application/json" \
  -d '{
    "topic": "cache/a/wis2/+/data/core/weather/surface-based-observations/#",
    "target": "surface-obs"
  }'

Esto suscribe a todas las observaciones de superficie de cualquier centro de datos y guarda los archivos en downloads/surface-obs/.

7. Ver las descargas

Los archivos aparecen en el directorio downloads/, organizados por fecha:

ls -la downloads/surface-obs/

Monitorice la actividad de descarga en Grafana en http://localhost:3000 (credenciales predeterminadas: admin / admin).

Cambie la contraseña predeterminada de Grafana tras el primer inicio de sesión.

Próximos pasos

Guía Contenido

Guía de usuario

Uso de la interfaz web, creación y gestión de suscripciones, filtrado de datos

Guía de administración

Seguridad, escalado, variables de entorno, monitorización, mantenimiento

Referencia de la API

Documentación completa de la REST API; interfaz Swagger interactiva en http://localhost:5002/swagger

Guía del desarrollador

Arquitectura, módulos internos, extensión del sistema