Skip to content

README.ru.md

Latest commit

 

History

History
110 lines (75 loc) · 18 KB

README.ru.md

File metadata and controls

110 lines (75 loc) · 18 KB
Raw

ProAnima Arkvory

Arkvory

English | Русский

Собственный репозиторий для сборок, пакетов, образов контейнеров и больших файлов.

Документация · Скачать · HTTP API · Лицензия

Продукт ProAnimaStudio. Автор, правообладатель и владелец брендов Arkvory и ProAnimaStudio — Ian Panaev. Фирменные материалы · Идентификаторы продукта

Что это

Arkvory — репозиторий для файлов, которые производят ваши сборки, на вашем собственном сервере. Он хранит сборки, пакеты и большие ассеты и доставляет их тем, кому они нужны: агентам развёртывания, конвейерам CI/CD, тестовым машинам, разработчикам и игровым командам.

Это самостоятельный продукт со своим HTTP API, клиентом командной строки и TypeScript SDK. Он также говорит на протоколах, которые уже знают ваши инструменты: реестр OCI для Docker и Podman, сервер Git LFS и npm-реестр для Unity Package Manager.

Возможности

  • Файлы любого размера. Загрузка идёт частями и продолжается после обрыва связи или перезапуска; скачивание продолжается по HTTP Range. Один объект — до ~10 ТиБ. Каждый файл проверяется по SHA-256.
  • Всё — в репозиториях. Пакеты UPack с версиями, файлы по пути с историей, образы контейнеров, объекты Git LFS, пакеты npm и Unity — каждый хранится как неизменяемый артефакт.
  • Понятный доступ. Учётные записи, группы, персональные токены доступа и сервисные учётные записи, ключи которых получают только нужные действия в нужных репозиториях. Входы и изменения доступа журналируются.
  • Стадии и продвижение. Отметьте сборку qa, release или prod, опубликуйте её в другом репозитории без повторной загрузки, а агент развёртывания запросит «новейшую сборку release в диапазоне ^1.4».
  • Метаданные. Метки, текстовые метаданные, коллекции и вложения: манифесты, SBOM, подписи, отчёты.
  • Хранение. Последние N сборок каждого пакета, квоты и предупреждения, освобождение места в фоне без остановки сервера. Второй диск подключается как ещё один том хранилища, а куда идут новые загрузки, выбирается для каждого репозитория.
  • Резервные копии. Агент по расписанию копирует базу и всё содержимое на другой диск или сетевую папку, проверяет копии и восстанавливает в пустую цель.
  • Высокая доступность на одной площадке. Два или три Linux-сервера держат одну синхронную копию всех данных (DRBD, Pacemaker, обязательный fencing): если активный сервер отказал, работу принимает другой, а запись подтверждается, только когда она лежит в двух полных копиях.
  • Массовые обновления без сбоев. Когда тысяча клиентов одновременно скачивает большое обновление, скачивания целиком встают в очередь: каждый клиент знает своё место и ожидаемое начало, ждёт вместо ошибки, а люди в консоли обслуживаются первыми.
  • Весь кластер в одном месте. Подключите другие установки, зеркала и вторые площадки одноразовым кодом по закреплённому сертификату и смотрите на одной странице, отвечает ли каждая, её версию, копии HA, шлюзы чтения, отставание зеркал и очередь скачиваний.
  • Зеркала и шлюзы чтения. Вторая установка держит копию репозиториев только для чтения и раздаёт её, если основная площадка потеряна; дополнительные процессы скачивания делят общий бюджет полосы.
  • Работает сам. Службы Windows, пакеты Linux или Docker Compose. Службы перезапускаются после падения или зависания; подписанные стабильные обновления ставятся вручную или в час обслуживания, после свежей проверенной резервной копии, с откатом.
  • Консоль на одиннадцати языках. Английский, русский, испанский, французский, немецкий, португальский, китайский, японский, корейский, хинди и арабский; светлая и тёмная тема. В документации доступны те же языки; часть японских и арабских страниц пока показывается на английском.

Модули и Arkvory Pro

Arkvory поддерживает подписанные модули ProAnimaStudio для дополнительных хранилищ, протоколов передачи и HTTP-маршрутов. Модули устанавливаются на хосте и загружаются при старте служб; Docker Compose их не загружает. Установка и выполнение сторонних плагинов пока недоступны; на хосте можно только вести список доверенных ключей их авторов.

Arkvory Pro — дополнительный платный комплект модулей дедупликации и дельта-передачи для совместимых клиентов. Pro 0.1.0 работает с Arkvory 0.6.3 на Windows/Linux x64. Он переиспользует общие чанки в хранилище и передаёт недостающие данные или патчи вместо постоянной передачи целых файлов. Экономия зависит от данных и клиента. Существующие данные Pro читаются без активной лицензии; при недоступности платных функций новые загрузки переходят в хранилище ядра и на обычную передачу. Ядро остаётся бесплатным на прежних условиях лицензии.

Пакеты Pro и лицензию получают у ProAnimaStudio. Перед внедрением прочитайте о модулях, возможностях Pro и эксплуатационных ограничениях и активации лицензии.

Установка

Платформа Пакет Руководство
Windows 10/11, Windows Server 2019+ (x64) Arkvory-Setup-x64.exe — мастер, Node.js и PostgreSQL в комплекте; работает без интернета Windows
Debian, Ubuntu, Fedora, совместимые с RHEL Arkvory-amd64.deb, Arkvory-x86_64.rpm со службами systemd Linux
Любой хост с Docker Docker Compose: API, worker, агент резервных копий и PostgreSQL Docker

Скачивайте только с GitHub Releases и сверяйте контрольные суммы SHA-256. Сервер слушает 127.0.0.1:8080, пока вы не настроите HTTPS. Консоль — по адресу /console/.

Первые шаги

  1. Установите сервер и откройте http://127.0.0.1:8080/console/.
  2. Создайте учётную запись владельца (мастер Windows делает это сам).
  3. Создайте персональный токен доступа или ключ сервисной учётной записи.
  4. Загрузите файл и скачайте его:
curl -T ./Setup.exe -H "Authorization: Bearer $ARKVORY_KEY" \
  http://127.0.0.1:8080/api/v1/repositories/releases/raw/builds/game/1.0/Setup.exe
curl -fL -H "Authorization: Bearer $ARKVORY_KEY" -o Setup.exe \
  http://127.0.0.1:8080/api/v1/repositories/releases/raw/builds/game/1.0/Setup.exe

Подробно: Быстрый старт.

Клиенты и протоколы

Способ Для чего
Веб-консоль Просмотр, загрузка и скачивание в браузере; пользователи, ключи, хранение, резервные копии и обновления
arkvoryctl Скрипты CI: передачи с продолжением, пакеты, продвижение, резервные копии; вывод --json
TypeScript SDK Свои инструменты в Node.js или браузере
HTTP API Интеграции на любом языке; OpenAPI по адресу /api/v1/openapi.json
Реестр образов Docker, Podman, Helm-чарты, ORAS
Git LFS Большие файлы git-репозиториев, блокировки файлов для Unity и Unreal
npm-реестр Scoped registries Unity Package Manager, npm publish
Файлы по пути Один запрос curl -T или PowerShell по пути

Документация

proanima.github.io/Arkvory — установка, повседневная работа, клиенты и протоколы, эксплуатация (резервные копии, зеркала, кластер высокой доступности, хранение, мониторинг, безопасность, устранение неполадок) и справочник HTTP API, который генерируется из контракта, проверяемого сервером. С поиском и выбором одиннадцати языков консоли; часть японских и арабских страниц пока показывается на английском. Актуальные возможности и ограничения отделены от исторических планов. Инженерные документы (архитектура, контракты, решения) ведутся на русском в docs/ и доступны в разделе сайта для разработчиков.

Ограничения

Отдельная установка — один сервер с PostgreSQL и локальным каталогом содержимого: если он остановился, клиенты ждут его возвращения. На Windows Node.js не умеет сбрасывать на диск записи каталогов, поэтому потеря питания вскоре после загрузки может оставить опубликованный файл без содержимого на диске; используйте ИБП и резервные копии. Кластеру высокой доступности нужны Linux-серверы на одной площадке с DRBD 9, Pacemaker и работающим устройством fencing для каждого сервера, проверенным на месте; двум серверам с данными нужен ещё отдельный сервер-свидетель. Windows и Docker Compose остаются отдельными серверами. От потери площадки не защищает ни то, ни другое: используйте резервные копии и при необходимости зеркало на второй площадке. Зеркало асинхронное и доступно только для чтения, пока вы вручную не переключитесь на него; оно не копирует учётные записи, ключи, вложения, ссылки удержания и журналы аудита. Содержимое и хранилище копий — локальные каталоги; S3 не реализован. Новое хранилище копий по умолчанию зашифровано, recovery kit хранится вне сервера.

Для разработчиков

Нужны Node.js 24 LTS, npm 11 и PostgreSQL 18 (Docker — по желанию).

git clone https://github.com/ProAnima/Arkvory.git
cd Arkvory
npm ci
npm run build
npm run gate -- quick

Запуск из исходников — для разработки; серверы ставятся из пакетов релиза. Правила изменений: AGENTS.md и CONTRIBUTING.md; слои и границы: ARCHITECTURE; проверки: ENGINEERING_GATES; решения: ADR; сайт документации и языки: WIKI, LOCALIZATION. Сообщения об уязвимостях: SECURITY.md.

Лицензия и авторство

© 2026 Ian Panaev (Ян Панаев), ProAnimaStudio.

ProAnima Arkvory бесплатен для всех, включая компании, и его исходный код открыт для чтения. Это не open source: использовать и изменять внутри своей организации можно, но распространять копии или форки, продавать и предоставлять как сервис нельзя. Публично описывая систему на основе Arkvory, укажите источник: «ProAnima Arkvory by ProAnimaStudio (Ian Panaev), https://github.com/ProAnima/Arkvory». Копии берутся только из официальных источников.

Условия: лицензия (English; при расхождении действует русский текст), уведомление: NOTICE.md, модель: LICENSING. Сторонние компоненты сохраняют свои лицензии.