Руководство по работе с зеркалом

Справка

Используйте Pub Bunker как приватное зеркало Dart-пакетов, артефактов Flutter SDK и Android-зависимостей Maven, чтобы обеспечить надежность сборки в контролируемых сетях.

Зеркало Dart Pub

Направьте разрешение зависимостей Dart и Flutter в Pub Bunker с помощью переменной окружения PUB_HOSTED_URL. Пакеты кэшируются и отдаются через эндпоинты, совместимые с Pub v2.

export PUB_HOSTED_URL="http://localhost:8080"
dart pub get

Кэш артефактов Flutter

Задайте переменную FLUTTER_STORAGE_BASE_URL, чтобы Flutter загружал бинарные файлы движка (engine), метаданные релизов и артефакты инструментов через локальный кэш.

export FLUTTER_STORAGE_BASE_URL="http://localhost:8080"
flutter precache

Прокси-сервер Maven

Направьте сборки Android через зеркала Google Maven и Maven Central для кэширования файлов Gradle, Kotlin, AndroidX, а также архивов JAR, AAR и файлов POM.

maven { url "http://localhost:8080/maven2/google" }
maven { url "http://localhost:8080/maven2/central" }

Автономный режим

После наполнения кэша используйте утилиту bunker для запуска стандартных команд Flutter в конфигурации изолированного зеркала.

bunker pub get
bunker build apk

Runner-ноды

Запускайте runner-демоны из CLI или интерактивного меню, чтобы зеркалировать архивы пакетов на дополнительные узлы хранения, а затем используйте bunker doctor для проверки статуса нод, покрытия пакетов, объема хранилища и последнего heartbeat.

bunker runner --name runner-node-1 --server http://localhost:8080
bunker doctor

Поддержка и Мониторинг

Экспортируйте диагностические пакеты поддержки через CLI и собирайте системную статистику с помощью совместимого с Prometheus эндпоинта /metrics.

bunker support-bundle --server http://localhost:8080 --token <token>
curl http://localhost:8080/metrics

Возможности веб-интерфейса

Поиск и просмотр зеркалированных Dart-пакетов прямо в браузере.

Просмотр файлов README и CHANGELOG, извлеченных из кэшированных архивов пакетов.

Контроль диагностики, объема хранилища, содержимого кэша, входящего трафика и последних ошибок в панели администратора.

Регистрация runner-нод, копирование готовых команд запуска, контроль онлайн-статуса, покрытия кэша, использования хранилища и свежести heartbeat.

Переключение интерфейса между английским и русским языками без влияния на работу API репозитория.

Рекомендуемый рабочий процесс

  1. Запустите Pub Bunker в среде с доступом к интернету и настройте клиентские инструменты на работу с локальным сервисом.
  2. Выполните один раз типовые сборки проектов Pub, Flutter и Android, чтобы наполнить локальные кэши.
  3. Перенесите окружение в контролируемую (изолированную) сеть и продолжайте использовать те же URL-адреса зеркал для воспроизводимых автономных сборок.