Wraithbound Publisher

wraithbound-publisher — операторский Rust CLI. Он запускается разработчиком или CI, но никогда не поставляется игроку вместе с Electron launcher.

Что автоматизировано

CLI сам получает официальные assets и Java runtime, строит manifests и синхронизирует S3. Исходная кастомная сборка остаётся локальной папкой: набор модов, конфигов и патчей невозможно безопасно восстановить только по версии Minecraft. Подготовка assets внутри CLI разделена на четыре части: модель Mojang index, загрузку, SHA-1/atomic file helpers и построение launcher manifest. Поэтому добавление другого источника assets не требует менять S3 publication code.

Сборка

cd E:\Wraithbound\wraithbound-launcher-platform
cargo build --release -p wraithbound-manifest-builder

Будут созданы две команды:

Binary	Назначение
`wraithbound-publisher.exe`	Полная подготовка и публикация в S3
`manifest-builder.exe`	Совместимая локальная генерация одного manifest

Конфигурация

Copy-Item publisher.example.toml publisher.toml

schema_version = 1

[storage]
bucket = "wraithbound-launcher"
region = "us-east-1"
endpoint = "https://s3.example.com"
prefix = "launcher"
force_path_style = true
concurrency = 8

[build]
server_id = 4
source = "C:/Builds/Architechnica"
profile = "C:/Metadata/servers/4/profile.json"
excludes = ["assets/**", "logs/**", "screenshots/**", "options.txt"]
optionals = []

[release]
id = "2026.08.30.1"
generation = 1
loader = "forge"

[[release.mirrors]]
id = "wraithbound-cdn"
base_url = "https://cdn.wraithbound.com/launcher"
priority = 1

[signing]
# private_key = "C:/secure/wraithbound-release.key"

[assets]
source = "E:/Wraithbound/assets"
download_from_mojang = true

[runtime]
id = "java-17-win32-x64"
source = "C:/Runtimes/java-17-win32-x64"
version = "17"
download_url = "https://github.com/adoptium/temurin17-binaries/releases/download/jdk-17.0.20%2B8/OpenJDK17U-jre_x64_windows_hotspot_17.0.20_8.zip"
sha256 = "7fe2324cc5901a89aaa0e8dc232075c59f2aca5270c533bdb1b861a5274af834"
strip_components = 1
excludes = []
executable_path = "bin/javaw.exe"

Относительные пути разрешаются относительно каталога publisher.toml. strip_components = 1 убирает верхнюю папку из ZIP runtime. Если архив сразу содержит bin/, задайте 0.

Credentials

Секреты не записываются в TOML:

$env:AWS_ACCESS_KEY_ID = '...'
$env:AWS_SECRET_ACCESS_KEY = '...'
$env:AWS_SESSION_TOKEN = '...' # только для временной сессии

Bucket можно передать через WB_PUBLISHER_S3_BUCKET. Для CI предпочтительны короткоживущие credentials с правами только на launcher prefix. Путь к Ed25519 seed передаётся отдельно:

$env:WB_PUBLISHER_SIGNING_KEY = 'C:\secure\wraithbound-release.key'

Не помещайте AWS secrets в Electron config, launcher logs, Git или документацию. Publisher — единственный нативный операторский инструмент, которому разрешён прямой доступ к S3.

Команды

Создать пример

target\release\wraithbound-publisher.exe init --output publisher.toml

Существующий файл не перезаписывается без --force.

Проверить конфигурацию

target\release\wraithbound-publisher.exe check --config publisher.toml

Проверяются server_id, profile, build source, assetIndex, Java version и безопасные S3 path segments.

Подготовить assets и runtime

target\release\wraithbound-publisher.exe prepare --config publisher.toml

Assets provider:

читает существующий assets/indexes/{assetIndex}.json;
если index отсутствует, получает version metadata с Mojang;
сверяет SHA-1 index;
проверяет размер и SHA-1 каждого object;
скачивает только отсутствующие или повреждённые objects.

Runtime provider принимает только HTTPS, требует ожидаемый SHA-256, извлекает ZIP во временную папку, блокирует небезопасные ZIP paths и активирует каталог только после появления bin/javaw.exe или bin/java.

Dry run

target\release\wraithbound-publisher.exe publish `
  --config publisher.toml `
  --dry-run

Команда строит реальные manifests и печатает общий размер и число объектов, но не подключается к S3. --skip-prepare полезен для полностью подготовленного локального дерева. Полный список S3 keys, size, SHA-256 и локальных путей выводится только с --list-objects, чтобы обычный CI log не разрастался на тысячи строк и не раскрывал устройство runner-диска. Для проверки repository-конфига без production private key используйте обёртку из корня platform:

powershell -NoProfile -ExecutionPolicy Bypass `
  -File scripts/publisher-dry-run.ps1 `
  -Config apps/launcher/deployment/launcher/publisher.toml

Она создаёт одноразовый тестовый ключ и work directory только внутри игнорируемой .smoke, запускает publish --dry-run --skip-prepare, затем восстанавливает прежнее значение env и удаляет временные данные. S3 и launcher-server при этом не изменяются.

Создать только assets manifest

target\release\wraithbound-publisher.exe assets-manifest `
  --profile "E:\Wraithbound\wraithbound-launcher-platform\apps\launcher\deployment\launcher\servers\4\profile.json" `
  --assets-root "E:\Wraithbound\assets" `
  --output "E:\Wraithbound\wraithbound-launcher-platform\apps\launcher\deployment\launcher\assets\1.7.10\manifest.json"

Общий objects/ может содержать несколько версий. Команда выбирает только SHA-1, перечисленные в indexes/{assetIndex}.json, поэтому игрок не скачивает чужие assets.

Публикация

target\release\wraithbound-publisher.exe publish --config publisher.toml

Порядок строго фиксирован:

тела файлов клиента, assets и runtime;
assets manifest;
runtime manifest;
server manifest;
signed manifest.envelope.pb, который связывает server, assets и runtime manifests в один release (если настроен release/signing);
profile.json как последний metadata-объект; активация выполняется отдельно в launcher-server.

release.mirrors[].base_url является публичным корнем доставки, а не S3 endpoint. Publisher формирует из него versioned URL ${base_url}/servers/{serverId}/releases/{releaseId}/files, а assets и runtime помещает ниже того же release-каталога. Все URL входят в Ed25519-подпись. После успешной загрузки publisher может установить envelope через remote admin gRPC или в общий каталог launcher-server. Путь строится из текущих serverId и release.id, поэтому одна конфигурация не содержит зашитого номера сервера. Remote token читается из WB_LAUNCHER_ADMIN_TOKEN и не записывается в TOML. JSON остаётся форматом S3 metadata для site API и локальных native-планов. Electron принимает его только после сравнения client/assets/runtime inventories с проверенным protobuf envelope. Удалять JSON можно лишь после отдельной миграции site API и локальных scanner/downloader contracts. Для каждого S3 object сохраняется metadata sha256. При следующем запуске совпадающие size и hash пропускаются. Автоматическое удаление объектов не выполняется, поэтому ошибочная конфигурация не очистит bucket.

JSON Lines для CI

target\release\wraithbound-publisher.exe --json publish `
  --config publisher.toml `
  --dry-run

События содержат check, assets-prepared, runtime-prepared, plan, catalog-release, published или fatal. Событие object появляется только при явном --list-objects.

Совместимая команда manifest-builder

target\release\manifest-builder.exe `
  --root "E:\Builds\Vanilla1.17" `
  --output "E:\Builds\manifest.json" `
  --profile-id "fa9c1a52-6fa9-4da6-a488-9fc80250095c" `
  --version "1.17" `
  --exclude "logs/**" `
  --optional "mods/voicechat-*.jar" `
  --progress

Она сохраняет прежний контракт и пишет JSON Lines progress в stderr.

Диагностика

Ошибка	Причина / действие
`asset index не найден`	Включите `download_from_mojang` или положите index вручную
`Mojang возвращает другой assetIndex`	Исправьте `profile.assetIndex`
`SHA-256 runtime не совпадает`	Не используйте архив; проверьте URL и официальный hash
`runtime не содержит bin/javaw.exe`	Исправьте `strip_components`
S3 `AccessDenied`	Ограниченная роль не имеет `HeadObject`/`PutObject` на prefix
повторно загружаются все файлы	Старые objects не содержат metadata `sha256`; один повторный upload это исправит

Контракты и сборка

Модули

Что автоматизировано

Сборка

Конфигурация

Credentials

Команды

Создать пример

Проверить конфигурацию

Подготовить assets и runtime

Dry run

Создать только assets manifest

Публикация

JSON Lines для CI

Совместимая команда manifest-builder

Диагностика

​Что автоматизировано

​Сборка

​Конфигурация

​Credentials

​Команды

​Создать пример

​Проверить конфигурацию

​Подготовить assets и runtime

​Dry run

​Создать только assets manifest

​Публикация

​JSON Lines для CI

​Совместимая команда manifest-builder

​Диагностика

Что автоматизировано

Сборка

Конфигурация

Credentials

Команды

Создать пример

Проверить конфигурацию

Подготовить assets и runtime

Dry run

Создать только assets manifest

Публикация

JSON Lines для CI

Совместимая команда manifest-builder

Диагностика