Этот документ был автоматически переведён с английского языка с помощью Claude AI. Термины из области WMO/метеорологии должны быть проверены носителем языка перед использованием в производственной среде. Смотрите оригинал на английском для авторитетной версии.

Запустите WIS2 Downloader и начните загружать данные за несколько минут.

Предварительные требования

  • Docker 20.10+

  • Docker Compose 2.0+

  • Сетевой доступ к WIS2 Global Broker (порт 443)

1. Загрузка и распаковка

Загрузите архив последнего релиза и распакуйте его:

tar -xzf wis2downloader-*.tar.gz
cd wis2downloader-*
Для работы с последней версией разработки склонируйте репозиторий: git clone https://github.com/World-Meteorological-Organization/wis2downloader.git

2. Настройка

Запустите скрипт настройки для создания файла .env со случайно сгенерированными секретами:

bash setup.sh

Скрипт копирует default.env в .env и генерирует случайные значения для FLASK_SECRET_KEY и REDIS_PASSWORD. Проверьте файл .env и при необходимости скорректируйте параметры — значения по умолчанию подходят для развёртывания на одной машине.

Храните файл .env в безопасном месте. Он содержит конфиденциальные учётные данные и не должен добавляться в систему контроля версий.

3. Настройка каталога загрузок

Контейнеры работают от имени непривилегированного пользователя (UID 10001, GID 988). В Linux необходимо настроить каталог загрузок перед запуском:

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
На macOS и Windows (Docker Desktop) этот шаг не требуется — Docker Desktop автоматически управляет правами доступа к томам.

Если создать соответствующего пользователя невозможно, обратитесь к разделу Права доступа к томам Руководства администратора, где описаны альтернативные подходы на основе ACL.

4. Запуск сервисов

docker compose up -d

Эта команда запускает все сервисы: менеджер подписок, MQTT-подписчики (Global Broker Франции и Бразилии), рабочие процессы Celery для загрузки файлов, Redis, Prometheus, Grafana и Loki.

Проверьте, что все сервисы работают:

docker compose ps

Дождитесь успешного прохождения проверки работоспособности subscription-manager (около 30 секунд), затем убедитесь, что сервис запущен:

curl http://localhost:5002/health

5. Создание подписки

Через веб-интерфейс (рекомендуется)

Откройте http://localhost:8080 в браузере.

Используйте Каталог или Дерево тем для просмотра доступных наборов данных WIS2, выберите тему, укажите каталог сохранения и нажмите Подписаться.

Через 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"
  }'

Эта команда создаёт подписку на все наземные наблюдения от любого центра данных и сохраняет файлы в downloads/surface-obs/.

6. Просмотр загруженных файлов

Файлы сохраняются в каталоге downloads/, упорядоченные по дате:

ls -la downloads/surface-obs/

Следите за активностью загрузок в Grafana по адресу http://localhost:3000 (учётные данные по умолчанию: admin / admin).

Смените пароль Grafana по умолчанию после первого входа.

Дальнейшие шаги

Руководство Содержание

Руководство пользователя

Работа с веб-интерфейсом, создание и управление подписками, фильтрация данных

Руководство администратора

Повышение безопасности, масштабирование, переменные окружения, мониторинг, обслуживание

Справочник API

Полная документация REST API; интерактивный интерфейс Swagger по адресу http://localhost:5002/swagger

Руководство разработчика

Архитектура системы, внутреннее устройство модулей, расширение системы