diff --git a/README.md b/README.md index 878be117..927fa93c 100644 --- a/README.md +++ b/README.md @@ -30,7 +30,15 @@ It is a standalone product with its own HTTP API, command-line client and TypeSc - **The whole cluster in one place.** Pair the other installations, mirrors and second sites with a one-time code over a pinned certificate, and see on one page whether each answers, its version, HA copies, read gateways, mirror lag and download queue. - **Mirrors and read gateways.** A second installation keeps a read-only copy of repositories and serves it when the first site is lost; extra download processes share one bandwidth budget. - **Runs by itself.** Windows services, Linux packages or Docker Compose. Services restart after a crash or a hang; signed stable updates install by hand or in a maintenance hour, behind a fresh verified backup, with rollback. -- **A console in eleven languages.** English, Russian, Spanish, French, German, Portuguese, Chinese, Japanese, Korean, Hindi and Arabic, light and dark. The documentation is in the same languages. +- **A console in eleven languages.** English, Russian, Spanish, French, German, Portuguese, Chinese, Japanese, Korean, Hindi and Arabic, light and dark. The documentation offers the same language selection; some Japanese and Arabic pages fall back to English. + +## Modules and Arkvory Pro + +Arkvory supports signed ProAnimaStudio modules for additional storage, transfer protocols and HTTP routes. Modules are installed on the host and loaded at service startup; Docker Compose does not load them. Third-party plugins cannot yet be installed or run; the host can only maintain their trusted author keys. + +**Arkvory Pro** is an optional paid module bundle for deduplication and delta transfers with compatible clients. Pro 0.1.0 works with Arkvory 0.6.3 on Windows/Linux x64. It reuses shared chunks in storage and transfers missing content or patches instead of always sending complete files. Savings depend on the data and client. Existing Pro data remains readable without an active licence; new uploads fall back to core storage and ordinary transfers when paid features are unavailable. The core remains free of charge under its existing licence. + +Obtain Pro packages and a licence from ProAnimaStudio. See [modules, Pro features and operating limits](https://proanima.github.io/Arkvory/operate/modules#pro) and [licence activation](https://proanima.github.io/Arkvory/operate/licenses) before deployment. ## Install @@ -73,7 +81,7 @@ The full walkthrough: [Quick start](https://proanima.github.io/Arkvory/guide/qui ## Documentation -**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/)** — installation, everyday work, clients and protocols, operation (backups, mirrors, the high-availability cluster, storage, monitoring, security, troubleshooting) and the HTTP API reference generated from the contract the server enforces. With search, in the eleven languages of the console. The engineering documents (architecture, contracts, decisions) are in Russian in [`docs/`](docs/) and in the site's developers' section. +**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/)** — installation, everyday work, clients and protocols, operation (backups, mirrors, the high-availability cluster, storage, monitoring, security, troubleshooting) and the HTTP API reference generated from the contract the server enforces. With search and the eleven-language selector of the console; Japanese and Arabic still contain English fallback pages. The [current implementation and limits](docs/CURRENT_STATE.md) distinguish shipped features from historical plans. The engineering documents (architecture, contracts, decisions) are in Russian in [`docs/`](docs/) and in the site's developers' section. ## Limits diff --git a/README.ru.md b/README.ru.md index 7f70689b..ecc209b6 100644 --- a/README.ru.md +++ b/README.ru.md @@ -30,7 +30,15 @@ Arkvory — репозиторий для файлов, которые прои - **Весь кластер в одном месте.** Подключите другие установки, зеркала и вторые площадки одноразовым кодом по закреплённому сертификату и смотрите на одной странице, отвечает ли каждая, её версию, копии 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 и эксплуатационных ограничениях](https://proanima.github.io/Arkvory/ru/operate/modules#pro) и [активации лицензии](https://proanima.github.io/Arkvory/ru/operate/licenses). ## Установка @@ -73,7 +81,7 @@ curl -fL -H "Authorization: Bearer $ARKVORY_KEY" -o Setup.exe \ ## Документация -**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/ru/)** — установка, повседневная работа, клиенты и протоколы, эксплуатация (резервные копии, зеркала, кластер высокой доступности, хранение, мониторинг, безопасность, устранение неполадок) и справочник HTTP API, который генерируется из контракта, проверяемого сервером. С поиском, на одиннадцати языках консоли. Инженерные документы (архитектура, контракты, решения) ведутся на русском в [`docs/`](docs/) и доступны в разделе сайта для разработчиков. +**[proanima.github.io/Arkvory](https://proanima.github.io/Arkvory/ru/)** — установка, повседневная работа, клиенты и протоколы, эксплуатация (резервные копии, зеркала, кластер высокой доступности, хранение, мониторинг, безопасность, устранение неполадок) и справочник HTTP API, который генерируется из контракта, проверяемого сервером. С поиском и выбором одиннадцати языков консоли; часть японских и арабских страниц пока показывается на английском. [Актуальные возможности и ограничения](docs/CURRENT_STATE.md) отделены от исторических планов. Инженерные документы (архитектура, контракты, решения) ведутся на русском в [`docs/`](docs/) и доступны в разделе сайта для разработчиков. ## Ограничения diff --git a/docs/API_CONTRACT_GUARD.md b/docs/API_CONTRACT_GUARD.md index cc1bf431..25178a3f 100644 --- a/docs/API_CONTRACT_GUARD.md +++ b/docs/API_CONTRACT_GUARD.md @@ -60,4 +60,4 @@ GET bytes описывает 200/206, binary content, ETag, Content-Length, Cont Добавить use case и server handler, wire-схемы и строку operation policy; определить стабильное имя, реальные права и retry. Обновить SDK и карту API, затем осмысленно обновить снимок operations. Запустить `npm run check`, `npm test`, PostgreSQL integrations и относящиеся ACL/отказные сценарии. Не расширять static exclusions ради прохождения проверки. -Сам inventory guard не требует таблиц; текущий runtime использует схему **11** с [индексом файловых страниц](ASSET_PAGINATION.md), сохраняя [делегированное управление](SERVICE_DELEGATION.md). Новые service-administration policies задают action, точную область resource и bootstrapAlternative; это metadata, не замена транзакционной авторизации. Следующие этапы: импорт identities/ownership, namespace selectors, события и UI управления ключами. Полный HA-стенд остаётся отдельной отложенной приёмкой. +Сам inventory guard не требует таблиц; версию runtime определяет `packages/infrastructure/src/schema-version.ts` (52 в ядре 0.6.3). Service-administration policies задают action, точную область resource и bootstrapAlternative; это metadata, не замена транзакционной авторизации. Наличие событий, управления ключами и HA проверяется по текущей реализации и гейтам, а не по списку будущих этапов первоначального guard: [CURRENT_STATE](CURRENT_STATE.md), [CI](CI.md). diff --git a/docs/API_MAP.md b/docs/API_MAP.md index ecdf8c17..3d9e34ec 100644 --- a/docs/API_MAP.md +++ b/docs/API_MAP.md @@ -6,11 +6,11 @@ Управление установленным кодом: `GET/HEAD /api/v1/system/updates` и `POST /api/v1/system/updates/requests`. Surface administration, глобальный administrator, команды check/configure/apply с revision и UUID. SDK: `client.updates`. [Контракт, права и восстановление](UPDATES.md). -Резервные копии экземпляра (B2, [ADR 0056](adr/0056-unattended-backups.md)): `/api/v1/backup/*`, surface administration, системные права `backup.read`/`backup.manage` (администратор учётных записей или файловый ключ владельца/bootstrap; ключи репозиториев — 403). Подробности — [раздел 1a](#1a-резервные-копии--реализовано). Схема БД введена в 26; актуальная — 34 (`SCHEMA_VERSION`). +Резервные копии экземпляра (B2, [ADR 0056](adr/0056-unattended-backups.md)): `/api/v1/backup/*`, surface administration, системные права `backup.read`/`backup.manage` (администратор учётных записей или файловый ключ владельца/bootstrap; ключи репозиториев — 403). Подробности — [раздел 1a](#1a-резервные-копии--реализовано). Схема БД введена в 26; в ядре 0.6.3 актуальная — 52 (`SCHEMA_VERSION`). -Области ответственности, уровни видимости, каталог операций текущего credential и SDK для удалённых клиентов реализованы: [API_SURFACES](API_SURFACES.md). `GET/HEAD /api/v1/operations` — authenticated, контекст repository необязателен, pagination до 100, advisory conditions. `GET/HEAD /api/v1/openapi.json?surface=…` — документационное представление. Актуальная схема БД — 32. +Области ответственности, уровни видимости, каталог операций текущего credential и SDK для удалённых клиентов реализованы: [API_SURFACES](API_SURFACES.md). `GET/HEAD /api/v1/operations` — authenticated, контекст repository необязателен, pagination до 100, advisory conditions. `GET/HEAD /api/v1/openapi.json?surface=…` — документационное представление. Версия схемы определяется `packages/infrastructure/src/schema-version.ts`; для выпущенного ядра 0.6.3 это 52. -Дата сверки: 2026-10-05, runtime со схемой 32. Это точка входа для интеграторов: **реализованные маршруты** ниже отделены от **проектируемых расширений**. Детальные JSON-схемы текущего сервера: `GET /api/v1/openapi.json` с действующим Bearer. OpenAPI сейчас 3.0.3; новую модель доступа описывает [API_ACCESS](API_ACCESS.md), порядок внедрения — [API_EVOLUTION](API_EVOLUTION.md). +Текущие версии и границы реализации: [CURRENT_STATE](CURRENT_STATE.md). Это точка входа для интеграторов: **реализованные маршруты** ниже отделены от **проектируемых расширений**. Детальные JSON-схемы текущего сервера: `GET /api/v1/openapi.json` с действующим Bearer. OpenAPI сейчас 3.0.3; новую модель доступа описывает [API_ACCESS](API_ACCESS.md), порядок внедрения — [API_EVOLUTION](API_EVOLUTION.md). Физическая очистка: GET/HEAD `R/storage/cleanup` (`storage.read`), PUT того же пути и POST `R/storage/cleanup/run` (`storage.manage`). Настройки с CAS, динамическая пауза, ограниченный проход и результат последнего выполнения: [ONLINE_CLEANUP](ONLINE_CLEANUP.md). Выполняется в фоне без остановки HTTP; 200 при запросе прохода не означает завершение удаления. diff --git a/docs/ARCHITECTURE.md b/docs/ARCHITECTURE.md index 956bc6e2..b1df683e 100644 --- a/docs/ARCHITECTURE.md +++ b/docs/ARCHITECTURE.md @@ -127,3 +127,9 @@ HA одной площадки ([ADR 0072](adr/0072-single-site-ha.md)): пер Наблюдаемость остаётся в infrastructure без внешних зависимостей: `DiagnosticLogger` (JSON-строки, уровни, поля процесса, неблокирующий учёт потерь) и `MetricsRegistry` (Prometheus text). Composition roots создают один логгер на процесс, ставят crash-only обработчики и регистрируют `/health/metrics`. Correlation ID передаётся явно копией `Principal` на запрос и сохраняется адаптерами задач и аудита; domain/application его не интерпретируют, глобального контекста нет: [ADR 0052](adr/0052-structured-observability.md). Лента событий для внешних систем ([ADR 0080](adr/0080-event-integrations.md), этапы E1–E2): domain `events` — каталог типов, отображение строки журнала в событие, ограничение `data` и правило удаления префикса позиций; application `EventFeed` — видимость по `Principal`, ограниченный просмотр и курсор с эпохой; infrastructure — outbox (`appendCatalogEvents` вызывает единственный писатель журнала `appendCatalogAudit` в транзакции изменения) и `PostgresEventLog` (чтение в одном снимке, секвенсор и удаление под блокировкой строки состояния). Секвенсор и удаление по сроку работают циклом worker; HTTP-маршруты и CloudEvents-конверт — `apps/api` и contracts, клиенты — SDK `events` и `arkvoryctl events tail`. + +## Службы модулей в выпущенном ядре + +Ядро 0.6.3 предоставляет extension API 0.13 (схема 52). Помимо загрузки пакетов, API передаёт маршрутам область прав вызывающего и отмену; хост выдаёт staged completion, change feed, storage и compute по ролям. `derived-cache` управляет поколениями производных данных и их reservations/pins; `module-state` — ограниченным атомарным состоянием установки; `resource-catalog` — общими владельцами, ссылками, поколениями файлов и допуском GC. Эти службы не раскрывают модулям пул БД или право произвольного удаления. Recovery каталогов и измерение файлов выполняются с ограниченной параллельностью; сбой измерения сохраняет dirty-состояние квот. Решения: [ADR 0084](adr/0084-derived-cache-generations.md), [ADR 0086](adr/0086-module-state-register.md), [ADR 0089](adr/0089-module-resource-catalog.md), [ADR 0090](adr/0090-module-data-recovery.md), [ADR 0091](adr/0091-bounded-resource-restore-batches.md). + +Pro подключает эти общие контракты вне публичного дерева ядра. Backup читает опубликованные байты через модуль в read-only роли; logical restore с `--to-default-storage` переносит их в обычные blobs. Производные каталоги и внутренний регистр координации не включаются в логическую копию и не заменяют опубликованные данные. Полный перечень исключений — `packages/infrastructure/src/backup-tables.ts`; эксплуатация — [CURRENT_STATE](CURRENT_STATE.md). diff --git a/docs/BACKUP_RECOVERY.md b/docs/BACKUP_RECOVERY.md index d0c21e48..8e17f590 100644 --- a/docs/BACKUP_RECOVERY.md +++ b/docs/BACKUP_RECOVERY.md @@ -1,6 +1,6 @@ # Backup и recovery: проект механизмов -Статус: **B1 реализован** (2026-10-02, [ADR 0054](adr/0054-built-in-backup-vault.md)): ручная согласованная копия во встроенный vault на диске/NAS, проверка и восстановление в пустую цель через операторский CLI. **B2 backend реализован** (2026-10-02, [ADR 0056](adr/0056-unattended-backups.md)): агент с расписанием, retention и prune, предупреждения, метрики, API `/api/v1/backup`, SDK и `arkvoryctl backup`. **Установщики B2 реализованы** (2026-10-02, [ADR 0057](adr/0057-backup-agent-service.md)): агент — третья служба systemd, WinSW и Compose, vault подключает `arkvory configure --backup-vault --init-vault` с проверкой и откатом. **Консоль B2 реализована** (2026-10-02): раздел «Резервные копии» с состоянием, предупреждениями, запуском копии и проверки, точками, заданиями и планом. Остальное в документе — проект следующих этапов. Правообладатель: Ian Panaev, бренд ProAnimaStudio. +Статус: **B1 реализован** (2026-10-02, [ADR 0054](adr/0054-built-in-backup-vault.md)): ручная согласованная копия во встроенный vault на диске/NAS, проверка и восстановление в пустую цель через операторский CLI. **B2 backend реализован** (2026-10-02, [ADR 0056](adr/0056-unattended-backups.md)): агент с расписанием, retention и prune, предупреждения, метрики, API `/api/v1/backup`, SDK и `arkvoryctl backup`. **Установщики B2 реализованы** (2026-10-02, [ADR 0057](adr/0057-backup-agent-service.md)): агент — третья служба systemd, WinSW и Compose, vault подключает `arkvory configure --backup-vault --init-vault` с проверкой и откатом. **Консоль B2 реализована** (2026-10-02): раздел «Резервные копии» с состоянием, предупреждениями, запуском копии и проверки, точками, заданиями и планом. Также реализованы шифрованный vault (ADR 0070), чтение опубликованных данных через backup-роль модулей и restore в default без исходных backend (ADR 0085). Проектные предложения ниже не заменяют действующую [инструкцию backup/restore](../wiki/ru/operate/backups.md); актуальные ограничения и происхождение приёмки — [CURRENT_STATE](CURRENT_STATE.md). Правообладатель: Ian Panaev, бренд ProAnimaStudio. Задача — получать самостоятельные проверяемые точки восстановления Arkvory без остановки обычной раздачи и приёма файлов, а восстанавливать их через понятный мастер даже при полной потере исходного сервера. Исходный масштаб: 4 ТБ, объекты десятков гигабайт и больше. Нельзя свести задачу к копированию каталога или запуску pg_dump: БД, неизменяемые blobs, конфигурация и автоочистка должны согласовать один состав копии. diff --git a/docs/CORE_RUNBOOK.md b/docs/CORE_RUNBOOK.md index bb6425cf..a9be5dc8 100644 --- a/docs/CORE_RUNBOOK.md +++ b/docs/CORE_RUNBOOK.md @@ -1,6 +1,6 @@ -# Запуск и использование первого ядра +# Запуск и эксплуатация Arkvory -Рабочий standalone backend: TypeScript → Node.js, Fastify, PostgreSQL, локальные неизменяемые файлы. Это версия для разработки и испытаний; границы гарантий описаны в [ADR 0004](adr/0004-native-standalone-core.md). +Документ описывает запуск из исходников, standalone-эксплуатацию и операторские команды. Выпущенные пакеты устанавливаются по [wiki](../wiki/ru/install/index.md); возможности текущего выпуска — [CURRENT_STATE](CURRENT_STATE.md). HA требует отдельной [инструкции кластера](../wiki/ru/operate/cluster.md), а не запуска нескольких API. Границы гарантий — [RELIABILITY](RELIABILITY.md#profiles). ## Быстрый старт diff --git a/docs/CURRENT_STATE.md b/docs/CURRENT_STATE.md new file mode 100644 index 00000000..59740ece --- /dev/null +++ b/docs/CURRENT_STATE.md @@ -0,0 +1,47 @@ +# Актуальное состояние Arkvory + +Сверено 2026-10-25. Это навигация по реализованным возможностям и ограничениям, а не новый план разработки. При изменении поведения обновляются соответствующая страница wiki, её переводы и этот обзор. Исторические отчёты и ADR сохраняют даты и исходные результаты. + +## Выпуски и совместимость + +- Бесплатное ядро: [Arkvory 0.6.3](https://github.com/ProAnima/Arkvory/releases/tag/v0.6.3), коммит `9844f5d605cc50ff9c71ac659c406255e84d91d0`. +- Дополнительный платный комплект: Arkvory Pro 0.1.0, выпущен 2026-10-24; описание для пользователей — [Модули и Pro](../wiki/ru/operate/modules.md#pro). Приватный репозиторий Pro не требуется для чтения публичной документации. +- Совместимая пара: ядро 0.6.3 и Pro 0.1.0, extension API 0.13, схема БД 52. Версия комплекта Pro и версии отдельных модулей — разные значения. +- Выпуски ядра и модулей подписываются отдельными ключами; ядру не нужна платная активация. Условия [лицензии ядра](../LICENSE.ru.md) не меняются с установкой Pro. + +## Что работает + +| Область | Реализовано | Основная инструкция | +| ----------------------- | ----------------------------------------------------------------------------------------------------------------------------------------- | --------------------------------------------------------------------------------------------------------------------- | +| Хранение и протоколы | UPack, файлы и история, OCI, Git LFS, npm/Unity; multipart/resume, Range, SHA-256, квоты, retention | [Работа с данными](../wiki/ru/use/transfers.md), [протоколы](../wiki/ru/protocols/index.md) | +| Развёртывание | Нативные службы Windows/Linux, установщики, standalone Compose, подписанные обновления | [Установка](../wiki/ru/install/index.md), [обновления](../wiki/ru/install/updates.md) | +| HA одной площадки | Linux, DRBD 9, Pacemaker, обязательный fencing; ha-2 со свидетелем и ha-3 | [Кластер](../wiki/ru/operate/cluster.md), [границы гарантий](RELIABILITY.md#profiles) | +| Вторая площадка | Асинхронное зеркало и ручной переход, шлюзы чтения | [Зеркала](../wiki/ru/operate/mirrors.md), [шлюзы](../wiki/ru/operate/read-gateways.md) | +| Резервные копии | Логическая согласованная копия, шифрованный vault, расписание, retention, verify, restore в пустую цель | [Резервные копии](../wiki/ru/operate/backups.md) | +| Модули | Установка подписанных пакетов ProAnimaStudio, проверка подписи/файлов/прав/ролей, включение при старте служб | [Модули](../wiki/ru/operate/modules.md), [архитектура](ARCHITECTURE.md) | +| Pro | Дедупликация, дельта-передачи совместимых клиентов, общий каталог и GC, квота логических данных, ограничение новых сборок по updatesUntil | [Pro](../wiki/ru/operate/modules.md#pro), [лицензирование](../wiki/ru/operate/licenses.md) | +| Данные Pro без лицензии | Чтение; логическая копия через установленный модуль и восстановление в обычное хранилище; новые загрузки без платных оптимизаций | [Restore в default](../wiki/ru/operate/backups.md#restore-default-storage), [хранение](../wiki/ru/operate/storage.md) | + +## Эксплуатационные границы + +1. Windows и Compose — standalone. Docker как оболочка испытательного стенда не доказывает поддержку модулей в поставляемой Compose-конфигурации: она их не загружает. +2. Сторонние плагины пока нельзя устанавливать и запускать. Реализовано управление доверенными ключами; ADR 0082 описывает более широкий план. Миграции схемы самих модулей и автоматический перезапуск служб при смене их набора не реализованы. +3. Логический backup сохраняет опубликованные байты, а не образ каталога модуля. На источнике нужен работающий путь чтения установленного модуля. `restore --to-default-storage` не требует исходного модуля на цели; место нужно под полный логический объём. Секреты активации и внутреннее состояние координации не переносятся автоматически вместе с логической копией. +4. Первое внедрение общего каталога требует остановки старых пишущих процессов. Неизвестный расход квоты не считается свободным местом. До восстановления и сверки каталогов нельзя обходить ограничения записи и GC; после восстановления проверяют новый Pro upload. +5. На приёмочном стенде с 4 млн чанков запись после восстановления локального индекса при уже готовом общем каталоге стала доступна через 32 мин 43 с без перезапуска. Это не гарантия RTO полного restore и не замер пропускной способности на 4 ТБ. +6. HA испытан с KVM/DRBD/Pacemaker/fencing на одном физическом хосте. Приёмка реальных доменов отказа и fencing нужна на целевой площадке. На Windows сохраняется ограничение directory fsync, описанное в [RELIABILITY](RELIABILITY.md#profiles). +7. S3-хранилище/интерфейс, S3-vault, мастер восстановления и автоматический restore drill не реализованы. ARM64 и macOS не входят в выпущенную матрицу Windows/Linux x64. + +## Проверки и происхождение результатов + +Ядро 0.6.3 прошло [полный main CI](https://github.com/ProAnima/Arkvory/actions/runs/40089751316) и [приёмку пакетов](https://github.com/ProAnima/Arkvory/actions/runs/40091244654) на Windows Server 2022/2025 и Ubuntu 22.04/24.04 x64. Подписи и хеши проверены при публикации. + +Приёмка Pro 0.1.0 — агрегат сохранённых проверок и новых целевых прогонов; это не повтор всей платформенной матрицы на финальном коммите. В выпуске Pro приложены `release-evidence.json`, `release-evidence.zip`, `artifact-inspection.json` и `SHA256SUMS`. Они сохраняют коммиты и ограничения исходных отчётов, включая локальную приёмку вместо недоступного приватного CI. Подтверждены сценарии scrub, эвакуации, зеркал и запись после восстановления; прежние RC-отчёты нельзя читать как актуальный список блокеров. + +## Как читать документацию + +- Wiki — пользовательские процедуры; английский текст является источником переводов. Японский и арабский разделы частично показывают английские страницы с предупреждением. Это не полный перевод всех страниц на 11 языков. +- `ARCHITECTURE`, `RELIABILITY`, `API_CONTRACTS`, `CORE_RUNBOOK`, `UPDATES` — действующие инженерные контракты и инструкции в пределах указанной области. +- `PROJECT_PLAN`, ранние разделы `ROADMAP`, проектные части backup/replication и ADR со статусом proposed — планы и история, не обещание поставленной функции. +- Датированные аудиты и `CORE_VALIDATION` — результаты конкретного коммита и стенда. Их не переписывают как новую приёмку. +- Полный список выполняемых проверок определяет [config/gates.json](../config/gates.json); обзор — [ENGINEERING_GATES](ENGINEERING_GATES.md) и [CI](CI.md). diff --git a/docs/DOCUMENTATION_AUDIT_2026-10-25.md b/docs/DOCUMENTATION_AUDIT_2026-10-25.md new file mode 100644 index 00000000..fa5255b7 --- /dev/null +++ b/docs/DOCUMENTATION_AUDIT_2026-10-25.md @@ -0,0 +1,36 @@ +# Сверка документации 2026-10-25 + +База: Arkvory 0.6.3 (`9844f5d6`) и дополнения о Pro из PR #61 (`eba7f983`). Цель — согласовать описания с поставленным поведением, не менять код, контракты, условия лицензирования или результаты старых испытаний. + +## Исправленные расхождения + +| Документ | Расхождение | Основание исправления | +| ---------------------------- | ----------------------------------------------------------------------------------------------------------- | ------------------------------------------------------------------------------------------------------------------------------------------- | +| FAQ, все полные переводы | Отрицал наличие HA | Профили ha-2/ha-3, `wiki/operate/cluster.md`, ADR 0072, успешные HA CI 0.6.3 | +| FAQ | При недоступности хаба обещал только отказ проверки обновлений; не учитывал GitHub fallback | `apps/deploy/src/hub.ts`, `docs/UPDATES.md` | +| FAQ | Описывал только три причины обращения к хабу, не учитывая платную активацию/продление | `apps/worker/src/license-loop.ts`, `packages/infrastructure/src/licence-hub.ts`; licence endpoint не заменяется GitHub | +| Modules / backups | «Каталоги модулей не входят в backup» не объясняло сохранение опубликованных байтов | `apps/backup/src/source.ts`, `restore-command.ts`, `backup-tables.ts`: source backup-роль, logical restore в default, исключённое состояние | +| UPDATES | Называл миграцию лицензирования 45 | `licence-store.ts` и `backup-tables.ts`: 47 | +| API_MAP / API_CONTRACT_GUARD | Называли текущей схему 32/34 и 11 | `schema-version.ts`: 52; исторические номера введения функций сохранены | +| ARCHITECTURE | Описывал загрузчик, но не пояснял текущие службы общего каталога, поколений кеша, регистра и восстановления | extension API 0.13, ADR 0084/0086/0089/0090/0091 | +| TESTING | Занижал состав verify до БД/браузера/аудита | `config/gates.json`: также docs, deployment, NAS, HA и восстановление модулей | +| CORE_RUNBOOK / ROADMAP | Представляли актуальное состояние через первый испытательный инкремент | Выпущенные версии, текущие инструкции установки и границы профилей | +| README / LOCALIZATION | Создавали впечатление полного перевода всей wiki на 11 языков | `COMPLETE` содержит девять языков; ja/ar частично используют включение английского оригинала | + +## Область сверки + +Проверены входные описания README, карта разделов wiki, заявления о доступности и ограничениях в guide/install/use/protocols/operate/reference, инструкции модулей, лицензий и backup/restore, номера схемы и актуальные статусы инженерных документов. Генерируемый справочник API не редактируется вручную: его источники — OpenAPI, operation policies и словари. Структуру переводов, ссылки и сборку сайта проверяют существующие гейты. + +Исторические ADR, датированные отчёты и исходный PROJECT_PLAN не превращены в новые результаты испытаний. Для навигации добавлен [CURRENT_STATE](CURRENT_STATE.md): поставленные возможности, подтверждённые версии, источники приёмки и реальные ограничения. Это обзор, а не доказательство выполнения каждой команды на пользовательском оборудовании. + +## Сохранённые реальные ограничения + +- Нет S3, ARM64/macOS-поставки, запуска сторонних плагинов и модулей в штатном Compose. +- Отдельная установка модулей, включение конфигурацией и перезапуск служб; автоматические миграции модулей отсутствуют. +- Сохраняются ограничения Windows directory fsync, неполные ja/ar-переводы, ручной переход на зеркало и ручное пробное восстановление backup. +- Pro: время восстановления зависит от каталога/диска; квоты и GC не обходятся; финальная приёмка использует целевые и сохранённые результаты. Нет заявления о производительности произвольной нагрузки 4 ТБ или испытанных независимых физических доменах отказа. +- Получение отзывов лицензий worker не означает автоматическую доставку списка отозванных версий модулей; это разные документы и механизмы. + +## Проверки изменения + +Изменены только Markdown-документы. Проверки выполняются штатными `npm run gate -- quick docs`; форматирование затрагивает только изменённые документы. Полный обязательный CI PR остаётся условием слияния. Новые продуктовые тесты для текстовых исправлений не добавляются; результаты текущего запуска и CI фиксируются в описании PR. diff --git a/docs/LOCALIZATION.md b/docs/LOCALIZATION.md index bcc644a6..0d35f4c0 100644 --- a/docs/LOCALIZATION.md +++ b/docs/LOCALIZATION.md @@ -2,7 +2,9 @@ | Переключатель в шапке | `apps/web/src/language-menu.ts`: кнопка с флагом и двумя буквами, список-popover со всеми языками (флаг, своё название, галочка); стрелки, Home, End, буква, Enter, Escape. Флаги — `apps/web/flags/<страна>.svg` (flag-icons, MIT; лицензия там же и в `THIRD-PARTY.txt`), сервер отдаёт их через `GET /console/flags/:file` (два символа и `.svg`). Флаг — страна, не язык: английский показан флагом Великобритании, португальский — Бразилии, арабский — Саудовской Аравии (`flag` в `languages.ts`) | -Состояние: 2026-10-05. Языки: английский (исходный), русский, испанский, французский, немецкий, португальский (Бразилия), китайский (упрощённый), японский, корейский, хинди, арабский — справа налево. Решение: [ADR 0068](adr/0068-documentation-site-and-languages.md). +Состояние: 2026-10-25. Языки: английский (исходный), русский, испанский, французский, немецкий, португальский (Бразилия), китайский (упрощённый), японский, корейский, хинди, арабский — справа налево. Решение: [ADR 0068](adr/0068-documentation-site-and-languages.md). + +Консоль поддерживает все перечисленные языки. Wiki полностью переведена на en, ru, es, de, zh, hi, ko, fr и pt; для ja/ar часть страниц включает английский оригинал с явным предупреждением. Актуальный перечень полных переводов задаёт `COMPLETE` в `wiki/.vitepress/structure.ts`. ## 1. Где живут тексты {#where} diff --git a/docs/PRODUCTION.md b/docs/PRODUCTION.md index 4eddd588..cc00b9b3 100644 --- a/docs/PRODUCTION.md +++ b/docs/PRODUCTION.md @@ -67,4 +67,4 @@ - Vault шифруется приложением по умолчанию; **recovery kit хранится вне сервера** (два экземпляра в двух местах) и проверяется (`vault key verify --vault <каталог> --key-file `): без kit и ключа агента копии не прочитать. Vault без шифрования (`--no-encryption`) оставляет шифрование и права тома обязанностью оператора. Шифрование не скрывает имена, размеры и число точек; удаление слота не перешифровывает прежние точки. - Нет S3/restic, offsite и immutable профиля, мастера восстановления и статуса restore drill ([BACKUP_RECOVERY](BACKUP_RECOVERY.md)). - На Windows API, worker и агент работают под общей учётной записью LocalService. -- Windows-приёмка служб и нативного установщика и Compose на Linux-хосте проверяются только в GitHub Actions ([CI](CI.md)). +- Проверки служб, нативных установщиков, контейнеров и HA выполняются на подходящих одноразовых стендах; публичный CI содержит обязательную матрицу ([CI](CI.md)). Локальный прогон без нужной инфраструктуры не считается прошедшим. Для модулей Pro дополнительно проверьте [совместимость, восстановление и ограничения](CURRENT_STATE.md#эксплуатационные-границы). diff --git a/docs/PROJECT_PLAN.md b/docs/PROJECT_PLAN.md index 4e3c19f2..d3b814a1 100644 --- a/docs/PROJECT_PLAN.md +++ b/docs/PROJECT_PLAN.md @@ -1,6 +1,6 @@ # План автономного хранилища пакетов и файлов -> Исходный целевой план продукта (2026-09-22); его статус и предложения не обновляются по мере реализации. Что реализовано сейчас: [README](../README.md), [ARCHITECTURE](ARCHITECTURE.md), [CORE_RUNBOOK](CORE_RUNBOOK.md); гарантии и границы профилей: [RELIABILITY](RELIABILITY.md#profiles). В частности, HA реализован репликацией тома DRBD ([ADR 0072](adr/0072-single-site-ha.md)), а не `ObjectBlobStore`; S3-backend не реализован. +> Исходный целевой план продукта (2026-09-22); его статус и предложения не обновляются по мере реализации. Сводка актуального выпуска: [CURRENT_STATE](CURRENT_STATE.md). Что реализовано сейчас: [README](../README.md), [ARCHITECTURE](ARCHITECTURE.md), [CORE_RUNBOOK](CORE_RUNBOOK.md); гарантии и границы профилей: [RELIABILITY](RELIABILITY.md#profiles). В частности, HA реализован репликацией тома DRBD ([ADR 0072](adr/0072-single-site-ha.md)), а не `ObjectBlobStore`; S3-backend не реализован. Дата: 22 сентября 2026 года. Статус: архитектурный план; каркас ProAnima Arkvory подготовлен, продуктовые функции ещё не реализованы. diff --git a/docs/ROADMAP.md b/docs/ROADMAP.md index 577e0255..6556e3fc 100644 --- a/docs/ROADMAP.md +++ b/docs/ROADMAP.md @@ -1,5 +1,7 @@ # Порядок реализации +Актуальные поставленные возможности, версии и ограничения: [CURRENT_STATE](CURRENT_STATE.md). Этапы ниже сохраняют порядок исходного плана; их номера не являются статусом выпуска. + ## Подготовлено - [x] Отдельный каталог проекта и перенесённый план. @@ -35,9 +37,9 @@ Backup/recovery выделен в самостоятельные вертика | 6. Миграция | Возобновляемый перенос 4 ТБ и пилот | Сверены байты, каталог, metadata и права | | 7. Переключение | Финальная дельта, hostname/TLS, откат | Исходное хранилище можно вывести из эксплуатации без пропущенных сценариев | -## Текущий инкремент +## Реализованные инкременты -Выполнены основные native сценарии этапов 1–2 и часть 3–4: [runbook 0.2](LIFECYCLE_AND_CATALOG.md). Приёмку всего roadmap не объявляем: файловый импорт не равен переносу 4 ТБ; очереди одного API не равны распределённой балансировке. Этапы 5–7 требуют инфраструктуры и внешних клиентов. +Первоначальные native-сценарии описаны в [runbook 0.2](LIFECYCLE_AND_CATALOG.md). Текущий выпуск также содержит HA, зеркала, резервное копирование и хост подписанных модулей; отдельный Pro добавляет дедупликацию и дельта-передачи. Сводка реализации и проверок — [CURRENT_STATE](CURRENT_STATE.md). Завершение отдельных этапов не означает приёмку произвольной нагрузки или всех предложений roadmap. История assets, чтение конкретной ревизии и атомарное восстановление реализованы в API/SDK/консоли: [ADR 0006](adr/0006-asset-history-and-restore.md). Логическое удаление и выборочный retention реализованы: [ARTIFACT_RETENTION](ARTIFACT_RETENTION.md). Физическая очистка работает без остановки: [ONLINE_CLEANUP](ONLINE_CLEANUP.md). diff --git a/docs/TESTING.md b/docs/TESTING.md index 12c50072..bc2b19f2 100644 --- a/docs/TESTING.md +++ b/docs/TESTING.md @@ -2,7 +2,7 @@ ## Что уже проверяется -Все проверки запускаются через единый реестр config/gates.json. `npm run gate -- quick` проверяет архитектурную политику, формат, TypeScript, lint, зависимости, сборку и unit-тесты. `verify` добавляет аудит зависимостей, реальную PostgreSQL/HTTP и браузер. `release` добавляет оба сценария 5 GiB с перезапусками. Старые npm aliases делегируют гейтам. [Команды и расширение](ENGINEERING_GATES.md), [результаты](CORE_VALIDATION.md), [инструкции](CORE_RUNBOOK.md). +Все проверки запускаются через единый реестр config/gates.json. `npm run gate -- quick` проверяет архитектурную политику, формат, TypeScript, lint, зависимости, сборку и unit-тесты. `verify` добавляет аудит зависимостей, PostgreSQL/HTTP, каталог ресурсов и восстановление квот модулей, браузер и документацию, установку пакетов и служб, контейнеры, NAS и HA-стенды. Точный состав задаёт config/gates.json. `release` добавляет оба сценария 5 GiB с перезапусками. Старые npm aliases делегируют гейтам. [Команды и расширение](ENGINEERING_GATES.md), [результаты текущего выпуска](CURRENT_STATE.md#проверки-и-происхождение-результатов), [инструкции](CORE_RUNBOOK.md). ## Проверки по уровням diff --git a/docs/UPDATES.md b/docs/UPDATES.md index af9a2d34..7a269963 100644 --- a/docs/UPDATES.md +++ b/docs/UPDATES.md @@ -108,11 +108,11 @@ node /manage.mjs updates-connect --root ## Модули -Пакеты модулей ([ADR 0078](adr/0078-open-core-modules-and-licenses.md), этап O1) ставятся командой хоста `arkvory module install --root … [--yes]`: подпись ключом модулей ProAnimaStudio, манифест, размер и SHA-256 каждого файла и совместимость проверяются в копии файла до любых изменений; без `--yes` команда только показывает модуль и его условия. Установленный пакет лежит в `modules///`, архив — в `modules/.packages/`, набор — в `modules/installed.json`. Изменение набора (`install`, `remove`) — запись `journal.json` с неизменным релизом и `modules.before/after`; прерванная запись блокирует следующие операции, `recover` возвращает прежний набор. Предыдущий пакет хранится до следующего успешного изменения. `module list` заново проверяет каждый пакет так, как это сделает загрузчик, и показывает отзыв. Список отзыва (`config/module-revocations.json`) принимается только с большим номером: из пакета модуля или командой `module revocations `; с хаба и в релизе ядра — этап O6. Службы читают набор при старте (ADR 0079, X4): новый модуль выключен, пока его не включит `ARKVORY_MODULES_FILE`; команда службы не перезапускает, перезапуск и откат набора по готовности — этап O2. Миграций модулей пока нет: пакет с шагами схемы не установится. Ключи авторов плагинов (ADR 0082) хранит `config/plugin-trust.json`, его меняют только `arkvory module trust add|remove`. Страница для операторов — wiki `operate/modules`. +Пакеты модулей ([ADR 0078](adr/0078-open-core-modules-and-licenses.md), этап O1) ставятся командой хоста `arkvory module install --root … [--yes]`: подпись ключом модулей ProAnimaStudio, манифест, размер и SHA-256 каждого файла и совместимость проверяются в копии файла до любых изменений; без `--yes` команда только показывает модуль и его условия. Установленный пакет лежит в `modules///`, архив — в `modules/.packages/`, набор — в `modules/installed.json`. Изменение набора (`install`, `remove`) — запись `journal.json` с неизменным релизом и `modules.before/after`; прерванная запись блокирует следующие операции, `recover` возвращает прежний набор. Предыдущий пакет хранится до следующего успешного изменения. `module list` заново проверяет каждый пакет так, как это сделает загрузчик, и показывает отзыв. Список отзыва (`config/module-revocations.json`) принимается только с большим номером: из пакета модуля или командой `module revocations `; автоматическая доставка списка отзывов версий модулей из хаба не реализована. Не путать его со списком отзывов лицензий, который получает worker. Службы читают набор при старте (ADR 0079, X4): новый модуль выключен, пока его не включит `ARKVORY_MODULES_FILE`; команда службы не перезапускает: оператор планирует перезапуск и проверяет готовность. Миграций модулей пока нет: пакет с шагами схемы не установится. Ключи авторов плагинов (ADR 0082) хранит `config/plugin-trust.json`, его меняют только `arkvory module trust add|remove`. Сторонние плагины пока не устанавливаются и не запускаются: список доверия — только подготовленная часть механизма. Страница для операторов — [модули и Pro](../wiki/ru/operate/modules.md); сводка выпуска — [CURRENT_STATE](CURRENT_STATE.md). ## Лицензии -Лицензии включают платные модули ([ADR 0078](adr/0078-open-core-modules-and-licenses.md), Р2; этапы O3 и O7). Бесплатному ядру лицензия не нужна, и без активированной лицензии установка не делает ни одного запроса о лицензиях. Команды хоста `arkvory license activate --key-file | refresh | deactivate | status | request | install … --root …` выполняет установленный релиз через launcher с окружением `runtime.json`, как `configure --init-vault`; в Compose они отклоняются (Compose не загружает модули). Обмен с хабом идёт по адресу `config/hub.json` (тот же хаб, что у обновлений; https, http только на loopback для тестов, проверка сертификата, без перенаправлений) и не зависит от статистики: тела запросов — ровно поля Р2. Обновляет активации worker примерно раз в сутки и при запуске; сбой сети или 5xx повторяется через 15 минут с удвоением до 6 часов, отказ 4xx (кроме `rate_limited`) ждёт действия администратора. Токены хранятся в `arkvory_license_activations` (миграция 45, входит в копию), секреты активации — файлы `config/licenses/.secret` учётной записи служб (вне БД, журналов и копий; на Linux unit worker получает `ReadWritePaths=-/config/licenses`). Ключ лицензии установка не хранит. Состояние видно в `arkvory license status` и `GET /api/v1/system/license`; страница для операторов — wiki `operate/licenses`. +Лицензии включают платные модули ([ADR 0078](adr/0078-open-core-modules-and-licenses.md), Р2; этапы O3 и O7). Бесплатному ядру лицензия не нужна, и без активированной лицензии установка не делает ни одного запроса о лицензиях. Команды хоста `arkvory license activate --key-file | refresh | deactivate | status | request | install … --root …` выполняет установленный релиз через launcher с окружением `runtime.json`, как `configure --init-vault`; в Compose они отклоняются (Compose не загружает модули). Обмен с хабом идёт по адресу `config/hub.json` (тот же хаб, что у обновлений; https, http только на loopback для тестов, проверка сертификата, без перенаправлений) и не зависит от статистики: тела запросов — ровно поля Р2. Обновляет активации worker примерно раз в сутки и при запуске; сбой сети или 5xx повторяется через 15 минут с удвоением до 6 часов, отказ 4xx (кроме `rate_limited`) ждёт действия администратора. Токены хранятся в `arkvory_license_activations` (миграция 47, входит в копию), секреты активации — файлы `config/licenses/.secret` учётной записи служб (вне БД, журналов и копий; на Linux unit worker получает `ReadWritePaths=-/config/licenses`). Ключ лицензии установка не хранит. Состояние видно в `arkvory license status` и `GET /api/v1/system/license`; страница для операторов — wiki `operate/licenses`. ## Безопасность и восстановление diff --git a/wiki/de/operate/backups.md b/wiki/de/operate/backups.md index 242e0e3c..7963e7c8 100644 --- a/wiki/de/operate/backups.md +++ b/wiki/de/operate/backups.md @@ -434,3 +434,5 @@ Lesen Sie das Agent-Log unter Linux mit `journalctl -u arkvory-backup`, unter Wi ## Wiederherstellung ohne ursprünglichen Speicher {#restore-default-storage} Fügen Sie dem Wiederherstellungsbefehl `--to-default-storage` hinzu, um alle Objekte ohne die ursprünglichen Volumes oder Module im Standardspeicher abzulegen. Planen Sie Platz für die vollständigen Objektdaten ein. Ohne `--yes` prüft und meldet der Befehl nur den Plan. Datenbank und Speicher müssen leer sein. Dieser Modus entfernt Platzierungsregeln und stellt veröffentlichte Inhalte als normale Blobs wieder her; konfigurieren Sie anschließend neue Platzierungsregeln. + +Logische Backups lesen veröffentlichte Objektbytes über das installierte Modul in seiner backup-Rolle; Modulverzeichnisse, Caches und privater Koordinationszustand werden nicht als Dateisystemabbild kopiert. Lassen Sie die Quellmodule bis zum Abschluss installiert und lesbar. [--to-default-storage](#restore-default-storage) stellt diese Objekte als gewöhnliche Kern-Blobs ohne Ursprungsmodul oder kostenpflichtige Lizenz wieder her; reservieren Sie deren volle logische Größe. Sichern Sie Installationsgeheimnisse separat und führen Sie vor erneuten kostenpflichtigen Schreibvorgängen die Lizenzwiederherstellung durch. diff --git a/wiki/de/operate/licenses.md b/wiki/de/operate/licenses.md index a10a8c42..83f7b5c3 100644 --- a/wiki/de/operate/licenses.md +++ b/wiki/de/operate/licenses.md @@ -5,7 +5,7 @@ description: Aktivieren Sie die Lizenz eines kostenpflichtigen Moduls online ode # Lizenzen -Der kostenlose Kern von Arkvory braucht keine Lizenz. Jede Funktion dieser Dokumentation arbeitet ohne sie, und kein Lizenzzustand schaltet eine davon ab oder macht Daten unlesbar. Eine Lizenz schaltet ein kostenpflichtiges Modul von ProAnimaStudio frei (siehe [Module](modules)). Bis Sie eine Lizenz aktivieren, sendet Arkvory nirgendwohin etwas über Lizenzen. +Der kostenlose Arkvory-Kern funktioniert ohne Lizenz für kostenpflichtige Module. Eine Lizenz aktiviert kostenpflichtige ProAnimaStudio-Funktionen einschließlich [Arkvory Pro](modules#pro). Ihr Ablauf macht bestehende Pro-Daten nicht unlesbar; bei nicht verfügbaren kostenpflichtigen Funktionen nutzen neue Uploads Kernspeicher und gewöhnliche Übertragungen. Bis Sie eine Lizenz aktivieren, sendet Arkvory keine Lizenzdaten. Die Befehle dieser Seite laufen auf dem Host der Installation, unter Linux als root, unter Windows als Administrator. Docker-Compose-Installationen laden keine Module und lehnen diese Befehle deshalb ab. diff --git a/wiki/de/operate/modules.md b/wiki/de/operate/modules.md index 3b020a84..ed1dfcaa 100644 --- a/wiki/de/operate/modules.md +++ b/wiki/de/operate/modules.md @@ -9,6 +9,24 @@ Ein Modulpaket fügt Arkvory eine Funktion hinzu. Arkvory installiert nur Pakete Die Dienste prüfen die installierten Module bei jedem Start erneut und laden sie. Ein Modul läuft erst, nachdem Sie es eingeschaltet haben. +## Arkvory Pro {#pro} + +Arkvory Pro ist ein optionales Paket kostenpflichtiger, signierter ProAnimaStudio-Module für den kostenlosen Arkvory-Kern. Pro 0.1.0 läuft mit Arkvory 0.6.3 auf Windows/Linux x64. Pakete und Lizenz erhalten Sie von ProAnimaStudio; die Module werden getrennt vom Kern installiert. Siehe [Installation](#install) und [Lizenzen](licenses). + +- **Deduplizierung:** speichert gemeinsame Chunks einmal und verwendet sie für mehrere Objekte. Der gemeinsame Katalog stimmt die Speicherbereinigung mit Veröffentlichung, Lesern und Backups ab. +- **Delta-Übertragungen:** verwenden Inhalte eines kompatiblen Clients erneut und übertragen fehlende Daten oder Patches. Das Paket enthält serverseitige Speicher- und Übertragungsmodule sowie ein Delta-Client-Modul. Die Einsparung hängt von Daten und Client ab; gewöhnliche HTTP-Downloads werden nicht automatisch zu Delta-Übertragungen. +- **Lizenzierung:** steuert kostenpflichtige Schreibvorgänge und Optimierungen. Bestehende Daten bleiben bei abgelaufener oder nicht verfügbarer Lizenz lesbar; neue Uploads nutzen Kernspeicher und gewöhnliche Übertragungen. Die Pro-Quote zählt logische Pro-Daten einschließlich angenommener, unvollständiger Uploads ohne Deduplizierungsrabatt. updatesUntil begrenzt den Anspruch auf neuere Modul-Builds. + +Module laden beim Dienststart; Docker Compose lädt keine Module. Sichern Sie Metadaten und Moduldaten vor Updates. Stoppen Sie bei der ersten Einführung des gemeinsamen Katalogs ältere schreibende API/worker-Prozesse; gemischte alte und neue Schreiber werden nicht unterstützt. Stellen Sie Daten und Lizenzzustand gemeinsam wieder her, warten Sie auf die Wiederherstellung und prüfen Sie einen neuen Pro-Upload vor dem normalen Schreibbetrieb. + +Große Kataloge brauchen Zeit: Im Abnahmetest waren 4 Millionen Chunks bei bereits wiederhergestelltem gemeinsamen Katalog nach 32 Minuten 43 Sekunden ohne Neustart beschreibbar. Dies garantiert keine Wiederherstellungszeit und misst keinen Durchsatz für 4 TB. HA-Tests auf einem physischen Host ersetzen keine Fencing- und Ausfalldomänentests am Einsatzort. Pro ändert die Lizenzbedingungen des Kerns nicht. + +## Modulfunktionen und Drittanbieter-Plugins {#module-capabilities} + +Signierte ProAnimaStudio-Module können Speicher, Übertragungsprotokolle und HTTP-Routen ergänzen und je nach Rolle Dienste für Hintergrundarbeit, begrenzte Berechnungen und koordinierte Bereinigung nutzen. Kostenlose Module benötigen keine Lizenz für kostenpflichtige Funktionen; kostenpflichtige Module deklarieren ihre Anforderungen. Jedes Paket muss zur extension API des Kerns passen und Signatur- und Integritätsprüfungen bestehen. + +Installation und Ausführung von Drittanbieter-Plugins sind in dieser Version nicht verfügbar. Sie können [vertrauenswürdige Autorenschlüssel](#trust) verwalten, aber ein hinzugefügter Schlüssel aktiviert keine Plugin-Installation. Die Modulschnittstelle ist keine Sandbox für beliebigen Code. + ## Ein Paket installieren {#install} 1. Kopieren Sie die Paketdatei `arkvory-module--.tgz` auf den Host. @@ -82,7 +100,7 @@ Um ein geändertes oder fehlendes Paket zu reparieren, installieren Sie es erneu Ein Modul, das eigene Indizes, Caches oder einen eigenen Zustand speichert, erhält ein Verzeichnis auf dem Daten-Volume: `module-data//` im Speicherverzeichnis von `default`. Sein Teil `data` ist für Backups gedacht, sein Teil `cache` nicht. Arkvory rechnet jeden Schreibvorgang auf die genehmigte Größe an, in MiB und in Dateien, für beide Teile zusammen. Ein Schreibvorgang darüber hinaus wird abgelehnt (`module_quota_exceeded`), und das Modul läuft weiter. Ohne genehmigte Größe kann das Modul nur lesen. Die [Reserve des Volumes](./storage#disk) gilt ebenfalls. Auf einem Lese-Gateway liest das Modul dieselben Dateien und kann sie nicht ändern. -Wenn Sie ein Modul entfernen, bleibt sein Verzeichnis erhalten. Löschen Sie `module-data//` selbst, wenn Sie die Daten nicht mehr brauchen. Backups enthalten Modulverzeichnisse noch nicht. +Logische Backups lesen veröffentlichte Objektbytes über das installierte Modul in seiner backup-Rolle; Modulverzeichnisse, Caches und privater Koordinationszustand werden nicht als Dateisystemabbild kopiert. Lassen Sie die Quellmodule bis zum Abschluss installiert und lesbar. [--to-default-storage](backups#restore-default-storage) stellt diese Objekte als gewöhnliche Kern-Blobs ohne Ursprungsmodul oder kostenpflichtige Lizenz wieder her; reservieren Sie deren volle logische Größe. Sichern Sie Installationsgeheimnisse separat und führen Sie vor erneuten kostenpflichtigen Schreibvorgängen die Lizenzwiederherstellung durch. Das Entfernen eines Moduls löscht nicht sein Datenverzeichnis; löschen Sie keine Dateien, auf die veröffentlichte Objekte verweisen. Stoppen Sie vor dem Wechsel auf Extension API 0.7.0 alle älteren API- und Worker-Prozesse, die Moduldaten schreiben. Alle neuen Schreiber teilen die Kontingentverwaltung über den PostgreSQL-Koordinator der Installation; auch temporäre Dateien zählen zum Kontingent. Gleichzeitiges Schreiben mit alten und neuen Prozessen wird nicht unterstützt. Nach einem Absturz baut Arkvory die Abrechnung bei Bedarf neu auf und entfernt temporäre Verzeichnisse des neuen Protokolls erst nach Erwerb der Datenbanksperre des vorherigen Besitzers. Alte temporäre Dateien werden nicht automatisch gelöscht und zählen weiter zum Kontingent; prüfen Sie sie separat bei gestoppten Schreibern. Backup-Prozesse haben nur Lesezugriff. diff --git a/wiki/de/reference/faq.md b/wiki/de/reference/faq.md index f0633507..6e4bf981 100644 --- a/wiki/de/reference/faq.md +++ b/wiki/de/reference/faq.md @@ -17,11 +17,11 @@ Arkvory reserviert standardmäßig bis zu 10 TiB Inhalt (`ARKVORY_CAPACITY_BYTES ### Ist Arkvory hochverfügbar? {#high-availability} -Nein. Eine Installation ist ein Server mit einer PostgreSQL-Datenbank und einem lokalen Inhaltsverzeichnis. Bleibt der Server stehen, warten die Clients und setzen ihre Übertragungen dann fort; die Dienste starten nach einem Absturz oder Stillstand selbst neu. Zum Schutz vor dem Verlust des Servers verwenden Sie [Backups](../operate/backups). Zum Lesen von einem zweiten Standort verwenden Sie [Spiegel](../operate/mirrors); das Umschalten auf einen Spiegel ist ein manueller Schritt, und Änderungen, die der Spiegel noch nicht erhalten hat, gehen verloren. +Ja, mit einem Linux-Cluster an einem Standort: ha-2 nutzt zwei Datenserver und einen separaten Zeugen; ha-3 nutzt drei Datenserver. DRBD 9, Pacemaker und geprüftes Fencing sind erforderlich. Schreibvorgänge benötigen normalerweise zwei vollständige Kopien. Windows und Docker Compose bleiben standalone. HA ersetzt keine Backups und schützt nicht vor dem Verlust des gesamten Standorts; Spiegel an einem zweiten Standort sind asynchron und erfordern manuelles Umschalten. Siehe [Cluster](../operate/cluster), [Backups](../operate/backups) und [Spiegel](../operate/mirrors). ### Funktioniert es offline? {#offline} -Der Server funktioniert ohne Internetzugang. Das Windows-Installationsprogramm enthält Node.js und PostgreSQL und installiert offline. Die Linux-Pakete enthalten Node.js, und der Paketmanager installiert PostgreSQL. Die Skript-Installer und Docker laden Dateien herunter. Updates lassen sich aus einer lokalen Kopie eines Releases installieren. Ist der Update-Hub nicht erreichbar, schlägt die Update-Prüfung fehl und wird in der Konsole angezeigt; alles andere ist nicht betroffen. Siehe [Eine Installation wählen](../install/index) und [Updates](../install/updates). +Der kostenlose Kern funktioniert ohne Internet. Der Windows-Installer enthält Node.js und PostgreSQL; Linux-Pakete enthalten Node.js und beziehen PostgreSQL über den Paketmanager. Skript-Installer und Docker benötigen möglicherweise Downloads. Updates können ein lokales Release verwenden. Ist der Hub unerreichbar, kann die Updatesuche auf GitHub zurückfallen; sind beide unerreichbar, schlägt sie fehl, ohne den Speicherbetrieb zu stoppen. Kostenpflichtige Module haben eine eigene Online- oder Offline-Lizenzlaufzeit: rechtzeitig verlängern. Siehe [Installation](../install/index), [Updates](../install/updates) und [Lizenzen](../operate/licenses). ## Speicher und Datenbank {#storage-and-database} @@ -51,7 +51,7 @@ Der Server sucht alle 6 Stunden nach einem Release, auch wenn die automatische I ### Was sendet Arkvory an ProAnimaStudio? {#hub-traffic} -Ihre Dateien und Daten bleiben auf Ihrem Server. Der Server kontaktiert den Hub von ProAnimaStudio (`hub.proanima.net`) und, wenn der Hub nicht erreichbar ist, GitHub, um drei Dinge zu erledigen: +Gespeicherte Inhalte bleiben auf Ihrem Server. Die Installation kontaktiert den ProAnimaStudio-Hub (`hub.proanima.net`) für die folgenden Zwecke. GitHub ist eine Alternative zur Releasesuche, nicht zur Lizenzaktivierung: - **Update-Prüfungen.** Die Anfrage enthält den Projektnamen, das Betriebssystem, die Prozessorarchitektur, die installierte Version und den Update-Kanal. Ist die Statistik eingeschaltet, enthält sie außerdem eine zufällige Installations-ID. - **Anonyme Statistiken.** Ein Ereignis nach jedem installierten Update mit der Installations-ID, der Version, dem System, der Architektur und dem Kanal. Es werden keine Namen, Adressen, Inhalte oder IP-Adressen gespeichert. Statistiken sind standardmäßig eingeschaltet; schalten Sie sie mit [[ui:updateStatistics]] in [[ui:updates]] oder mit `arkvory configure --statistics off` aus. Ohne Statistiken erreicht Sie eine neue Version erst, wenn sie für alle ausgerollt wird. @@ -59,6 +59,8 @@ Ihre Dateien und Daten bleiben auf Ihrem Server. Der Server kontaktiert den Hub `arkvory configure --hub-off` beendet den Kontakt mit dem Hub: Releases kommen dann nur noch von GitHub, und Feedback wird nach dem Neustart der Dienste ausgeschaltet. Eine leere `ARKVORY_HUB_URL` schaltet nur das Feedback aus. Siehe [Lizenz](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), Abschnitt 7. +Aktivierung und Verlängerung kostenpflichtiger Module kontaktieren ebenfalls den Hub und tauschen Lizenz- und Installationskennungen, Modulversionen und Aktivierungszugangsdaten aus. Ohne Aktivierung gibt es keinen Lizenzverkehr. Deaktivierte Statistik deaktiviert nicht die Lizenzierung. Mit `--hub-off` sind Online-Aktivierung und Verlängerung nicht verfügbar: Nutzen Sie das [Offline-Verfahren](../operate/licenses#offline) und beachten Sie den Ablauf. Kostenpflichtige Funktionen benötigen weiterhin eine Lizenz. + ### Laufen Backups von selbst? {#automatic-backups} Erst wenn Sie sie einrichten. Verbinden Sie einen Backup-Speicher mit `arkvory configure --backup-vault --vault-key-file ` und schalten Sie dann den täglichen Zeitplan in [[ui:backupPlan]] in [[ui:backups]] ein. Der Plan beginnt um 02:00 UTC und behält 7 tägliche, 4 wöchentliche und 6 monatliche Wiederherstellungspunkte. Solange der Zeitplan ausgeschaltet ist, zeigt die Konsole die Warnung, dass der tägliche Zeitplan aus ist. Siehe [Backups](../operate/backups). diff --git a/wiki/es/operate/backups.md b/wiki/es/operate/backups.md index 747d9426..a9293b61 100644 --- a/wiki/es/operate/backups.md +++ b/wiki/es/operate/backups.md @@ -434,3 +434,5 @@ Lea el registro del agente con `journalctl -u arkvory-backup` en Linux, en `logs ## Restaurar sin el almacenamiento original {#restore-default-storage} Añada `--to-default-storage` al comando de restauración para colocar todos los objetos en el almacenamiento predeterminado sin los volúmenes ni módulos originales. Reserve espacio para los bytes completos de los objetos. Sin `--yes`, el comando solo comprueba y muestra el plan. La base de datos y el almacenamiento deben estar vacíos. Este modo elimina las reglas de ubicación y restaura el contenido publicado como blobs normales; configure nuevas reglas después de la recuperación. + +Los backups lógicos capturan los bytes de objetos publicados mediante el módulo instalado en su rol backup; no copian el directorio del módulo, sus cachés ni su estado privado de coordinación como imagen del sistema de archivos. Mantenga los módulos de origen instalados y legibles hasta terminar la copia. [--to-default-storage](#restore-default-storage) restaura esos objetos como blobs normales del núcleo sin el módulo original ni licencia de pago; reserve su tamaño lógico completo. Guarde los secretos de instalación por separado y siga la recuperación de licencia antes de reactivar las escrituras de pago. diff --git a/wiki/es/operate/licenses.md b/wiki/es/operate/licenses.md index 2b5a82e6..07969ae4 100644 --- a/wiki/es/operate/licenses.md +++ b/wiki/es/operate/licenses.md @@ -5,7 +5,7 @@ description: Active la licencia de un módulo de pago en línea o sin conexión, # Licencias -El núcleo gratuito de Arkvory no necesita licencia. Todas las funciones de esta documentación funcionan sin ella, y ningún estado de licencia las desactiva ni deja los datos ilegibles. Una licencia habilita un módulo de pago de ProAnimaStudio (consulte [Módulos](modules)). Hasta que active una licencia, Arkvory no envía nada sobre licencias a ninguna parte. +El núcleo gratuito de Arkvory funciona sin licencia de módulos de pago. Una licencia habilita funciones de pago de ProAnimaStudio, incluido [Arkvory Pro](modules#pro). Su caducidad no impide leer los datos Pro existentes; si las funciones de pago no están disponibles, las nuevas cargas usan el almacenamiento del núcleo y las transferencias normales. Hasta que active una licencia, Arkvory no envía nada sobre licencias a ninguna parte. Los comandos de esta página se ejecutan en el host de la instalación, como root en Linux o como administrador en Windows. Las instalaciones con Docker Compose no cargan módulos, así que rechazan estos comandos. diff --git a/wiki/es/operate/modules.md b/wiki/es/operate/modules.md index 17a0fd0d..0ac843ae 100644 --- a/wiki/es/operate/modules.md +++ b/wiki/es/operate/modules.md @@ -9,6 +9,24 @@ Un paquete de módulo añade una función a Arkvory. Arkvory solo instala paquet Los servicios vuelven a verificar los módulos instalados y los cargan cada vez que se inician. Un módulo solo se ejecuta después de que usted lo active. +## Arkvory Pro {#pro} + +Arkvory Pro es un conjunto opcional de módulos de pago firmados por ProAnimaStudio para el núcleo gratuito de Arkvory. Pro 0.1.0 funciona con Arkvory 0.6.3 en Windows/Linux x64. Obtenga los paquetes y la licencia de ProAnimaStudio; se instalan por separado del núcleo. Consulte [Instalación](#install) y [Licencias](licenses). + +- **Deduplicación:** almacena una sola vez los fragmentos compartidos y los reutiliza entre objetos. El catálogo compartido coordina la recolección de basura con la publicación, los lectores y las copias de seguridad. +- **Transferencias delta:** reutilizan contenido disponible en un cliente compatible y transfieren los datos que faltan o parches. El conjunto incluye módulos de almacenamiento y transferencia del servidor y un módulo cliente delta. El ahorro depende de los datos y del cliente; las descargas HTTP normales no se convierten automáticamente en transferencias delta. +- **Licencias:** controlan las escrituras y optimizaciones de pago. Los datos existentes siguen siendo legibles si la licencia caduca o no está disponible; las nuevas cargas usan el almacenamiento del núcleo y las transferencias normales. La cuota Pro cuenta los datos lógicos de Pro, incluidas las cargas aceptadas sin terminar, sin descuento por deduplicación. updatesUntil limita el derecho a nuevas compilaciones de los módulos. + +Los módulos se cargan al iniciar los servicios; Docker Compose no los carga. Antes de actualizar, guarde una copia de los metadatos y los datos de los módulos. Al adoptar por primera vez el catálogo compartido, detenga los escritores API/worker antiguos; no se admite mezclar escritores antiguos y nuevos. Restaure juntos los datos y el estado de licencia, espere la recuperación y compruebe una nueva carga Pro antes de reanudar las escrituras normales. + +La recuperación de un catálogo grande puede tardar: en el entorno de aceptación, 4 millones de fragmentos con el catálogo compartido ya restaurado permitieron escribir tras 32 minutos y 43 segundos, sin reiniciar. No es una garantía de tiempo ni una medición de rendimiento con 4 TB. Las pruebas HA en un solo host físico no sustituyen las comprobaciones de fencing y dominios de fallo de su instalación. Pro no cambia la licencia del núcleo. + +## Capacidades de los módulos y plugins de terceros {#module-capabilities} + +Los módulos firmados de ProAnimaStudio pueden añadir almacenamiento, protocolos de transferencia y rutas HTTP, con servicios de trabajo en segundo plano, cómputo limitado y limpieza coordinada según sus roles. Los módulos gratuitos no necesitan una licencia de funciones de pago; los de pago declaran sus requisitos. Cada paquete debe ser compatible con la extension API del núcleo y superar las comprobaciones de firma e integridad. + +Esta versión no permite instalar ni ejecutar plugins de terceros. Puede mantener las [claves de autores de confianza](#trust), pero añadir una clave no habilita la instalación de plugins. La interfaz de módulos no es un entorno aislado para código arbitrario. + ## Instalar un paquete {#install} 1. Copie el archivo del paquete `arkvory-module--.tgz` al host. @@ -82,7 +100,7 @@ Para reparar un paquete cambiado o ausente, instálelo de nuevo. Todos los servi Un módulo que guarda índices, cachés o un estado propios obtiene un directorio en el volumen de datos: `module-data//` en el directorio de almacenamiento `default`. Su parte `data` está pensada para las copias de seguridad; su parte `cache`, no. Arkvory cuenta cada escritura contra el tamaño aprobado, en MiB y en archivos, para ambas partes juntas. Una escritura que lo supera se rechaza (`module_quota_exceeded`) y el módulo sigue funcionando. Sin un tamaño aprobado, el módulo solo puede leer. También se aplica la [reserva del volumen](./storage#disk). En una puerta de enlace de lectura, el módulo lee los mismos archivos y no puede cambiarlos. -Eliminar un módulo conserva su directorio. Elimine `module-data//` usted mismo cuando ya no necesite los datos. Las copias de seguridad todavía no incluyen los directorios de los módulos. +Los backups lógicos capturan los bytes de objetos publicados mediante el módulo instalado en su rol backup; no copian el directorio del módulo, sus cachés ni su estado privado de coordinación como imagen del sistema de archivos. Mantenga los módulos de origen instalados y legibles hasta terminar la copia. [--to-default-storage](backups#restore-default-storage) restaura esos objetos como blobs normales del núcleo sin el módulo original ni licencia de pago; reserve su tamaño lógico completo. Guarde los secretos de instalación por separado y siga la recuperación de licencia antes de reactivar las escrituras de pago. Eliminar un módulo no borra su directorio de datos; no borre archivos referenciados por objetos publicados. Antes de actualizar a extension API 0.7.0, detenga todos los procesos API y worker antiguos que escriban datos de módulos. Los nuevos escritores comparten el control de cuota mediante el coordinador PostgreSQL de la instalación; los archivos temporales también cuentan. No se admite escribir simultáneamente con procesos antiguos y nuevos. Tras un fallo, Arkvory reconstruye el recuento cuando hace falta y elimina directorios temporales del nuevo protocolo solo después de adquirir el bloqueo del propietario anterior en la base de datos. Los temporales antiguos no se eliminan automáticamente y siguen contando para la cuota; revíselos por separado con los escritores detenidos. Los procesos backup solo tienen acceso de lectura. diff --git a/wiki/es/reference/faq.md b/wiki/es/reference/faq.md index d4705bec..37c3bf84 100644 --- a/wiki/es/reference/faq.md +++ b/wiki/es/reference/faq.md @@ -17,11 +17,11 @@ Arkvory reserva hasta 10 TiB de contenido por defecto (`ARKVORY_CAPACITY_BYTES`) ### ¿Arkvory tiene alta disponibilidad? {#high-availability} -No. Una instalación es un servidor con una base de datos PostgreSQL y un directorio de contenido local. Si el servidor se detiene, los clientes esperan y luego reanudan sus transferencias; los servicios se reinician solos tras un fallo o un bloqueo. Para protegerse de la pérdida del servidor, use [copias de seguridad](../operate/backups). Para leer desde una segunda sede, use [espejos](../operate/mirrors); el cambio a un espejo es un paso manual, y los cambios que el espejo aún no había recibido se pierden. +Sí, con un clúster Linux en una sede: ha-2 usa dos servidores de datos y un testigo separado; ha-3 usa tres servidores de datos. Requiere DRBD 9, Pacemaker y fencing probado. Normalmente las escrituras requieren dos copias completas. Windows y Docker Compose siguen siendo standalone. HA no sustituye los backups ni protege contra la pérdida de toda la sede; los espejos en otra sede son asíncronos y requieren un cambio manual. Véase [Clúster](../operate/cluster), [Backups](../operate/backups) y [Espejos](../operate/mirrors). ### ¿Funciona sin conexión? {#offline} -El servidor funciona sin acceso a internet. El instalador de Windows incluye Node.js y PostgreSQL y se instala sin conexión. Los paquetes de Linux incluyen Node.js, y el gestor de paquetes instala PostgreSQL. Los instaladores por script y Docker descargan archivos. Las actualizaciones pueden instalarse desde una copia local de una versión. Si no se puede alcanzar el hub de actualizaciones, la comprobación de actualizaciones falla y se muestra en la consola; nada más se ve afectado. Véase [Elegir una instalación](../install/index) y [Actualizaciones](../install/updates). +El núcleo gratuito funciona sin internet. El instalador Windows incluye Node.js y PostgreSQL; los paquetes Linux incluyen Node.js y obtienen PostgreSQL del gestor de paquetes. Los instaladores por script y Docker pueden necesitar descargas. Puede actualizar desde una versión local. Si el hub es inaccesible, la búsqueda de actualizaciones puede recurrir a GitHub; si ambos fallan, la comprobación falla sin detener el almacenamiento. Los módulos de pago tienen su propia vigencia de licencia en línea o sin conexión: renuévela antes de caducar. Véase [Instalación](../install/index), [Actualizaciones](../install/updates) y [Licencias](../operate/licenses). ## Almacenamiento y base de datos {#storage-and-database} @@ -51,7 +51,7 @@ El servidor busca una versión cada 6 horas incluso cuando la instalación autom ### ¿Qué envía Arkvory a ProAnimaStudio? {#hub-traffic} -Sus archivos y datos permanecen en su servidor. El servidor contacta con el hub de ProAnimaStudio (`hub.proanima.net`), y con GitHub cuando no se puede alcanzar el hub, por tres cosas: +El contenido almacenado permanece en su servidor. La instalación contacta con el hub ProAnimaStudio (`hub.proanima.net`) para los fines siguientes. GitHub es una alternativa para encontrar versiones, no para activar licencias: - **Comprobaciones de actualizaciones.** La solicitud lleva el nombre del proyecto, el sistema operativo, la arquitectura del procesador, la versión instalada y el canal de actualizaciones. Con las estadísticas activadas, también lleva un ID de instalación aleatorio. - **Estadísticas anónimas.** Un evento tras cada actualización instalada, con el ID de instalación, la versión, el sistema, la arquitectura y el canal. No se almacenan nombres, direcciones, contenido ni direcciones IP. Las estadísticas están activadas por defecto; desactívelas con [[ui:updateStatistics]] en [[ui:updates]] o con `arkvory configure --statistics off`. Sin estadísticas, una versión nueva le llega solo cuando se despliega para todos. @@ -59,6 +59,8 @@ Sus archivos y datos permanecen en su servidor. El servidor contacta con el hub `arkvory configure --hub-off` deja de contactar con el hub: entonces las versiones llegan solo desde GitHub, y los comentarios se desactivan tras reiniciar los servicios. Un `ARKVORY_HUB_URL` vacío desactiva solo los comentarios. Véase [Licencia](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), sección 7. +La activación y renovación de módulos de pago también contactan con el hub e intercambian identificadores de licencia e instalación, versiones de módulos y credenciales de activación. Sin activación no hay tráfico de licencias. Desactivar estadísticas no desactiva las licencias. Con `--hub-off`, la activación y renovación en línea no están disponibles: siga el [procedimiento sin conexión](../operate/licenses#offline) y controle su caducidad. Las funciones de pago siguen necesitando licencia. + ### ¿Las copias de seguridad se ejecutan solas? {#automatic-backups} No hasta que las configure. Conecte un almacén con `arkvory configure --backup-vault --vault-key-file ` y luego active el programa diario en [[ui:backupPlan]] en [[ui:backups]]. El plan empieza a las 02:00 UTC y conserva 7 puntos de restauración diarios, 4 semanales y 6 mensuales. Hasta que el programa esté activado, la consola muestra el aviso de que el programa diario está desactivado. Véase [Copias de seguridad](../operate/backups). diff --git a/wiki/fr/operate/backups.md b/wiki/fr/operate/backups.md index d06b5e2d..7fee3c3a 100644 --- a/wiki/fr/operate/backups.md +++ b/wiki/fr/operate/backups.md @@ -434,3 +434,5 @@ Lisez le journal de l’agent avec `journalctl -u arkvory-backup` sous Linux, da ## Restaurer sans le stockage d’origine {#restore-default-storage} Ajoutez `--to-default-storage` à la commande de restauration pour placer tous les objets dans le stockage par défaut sans les volumes ni modules d’origine. Prévoyez de l’espace pour les données complètes des objets. Sans `--yes`, la commande vérifie et affiche uniquement le plan. La base de données et le stockage doivent être vides. Ce mode supprime les règles de placement et restaure les contenus publiés sous forme de blobs ordinaires ; configurez de nouvelles règles après la restauration. + +Les sauvegardes logiques lisent les octets des objets publiés via le module installé dans son rôle backup ; elles ne copient pas le répertoire du module, les caches et l’état privé de coordination comme une image du système de fichiers. Gardez les modules source installés et lisibles jusqu’à la fin de la copie. [--to-default-storage](#restore-default-storage) restaure ces objets comme des blobs ordinaires du cœur sans module d’origine ni licence payante ; prévoyez leur taille logique complète. Conservez les secrets d’installation séparément et suivez la récupération de licence avant de réactiver les écritures payantes. diff --git a/wiki/fr/operate/licenses.md b/wiki/fr/operate/licenses.md index 1e399ac5..ac0ba80a 100644 --- a/wiki/fr/operate/licenses.md +++ b/wiki/fr/operate/licenses.md @@ -5,7 +5,7 @@ description: Activez la licence d’un module payant en ligne ou hors ligne, vé # Licences -Le cœur gratuit d’Arkvory n’a besoin d’aucune licence. Toutes les fonctions de cette documentation marchent sans elle, et aucun état de licence ne les désactive ni ne rend les données illisibles. Une licence active un module payant de ProAnimaStudio (voir [Modules](modules)). Tant que vous n’avez pas activé de licence, Arkvory n’envoie rien sur les licences nulle part. +Le cœur gratuit d’Arkvory fonctionne sans licence de module payant. Une licence active les fonctions payantes de ProAnimaStudio, dont [Arkvory Pro](modules#pro). Son expiration ne rend pas les données Pro existantes illisibles ; si les fonctions payantes sont indisponibles, les nouveaux envois utilisent le stockage du cœur et les transferts ordinaires. Tant que vous n’avez pas activé de licence, Arkvory n’envoie rien sur les licences. Les commandes de cette page s’exécutent sur l’hôte de l’installation, en root sous Linux ou en administrateur sous Windows. Les installations Docker Compose ne chargent pas de modules : elles refusent donc ces commandes. diff --git a/wiki/fr/operate/modules.md b/wiki/fr/operate/modules.md index db52196f..b079fe79 100644 --- a/wiki/fr/operate/modules.md +++ b/wiki/fr/operate/modules.md @@ -9,6 +9,24 @@ Un paquet de module ajoute une fonction à Arkvory. Arkvory n'installe que les p Les services vérifient de nouveau les modules installés et les chargent à chaque démarrage. Un module ne s’exécute qu’une fois que vous l’avez activé. +## Arkvory Pro {#pro} + +Arkvory Pro est un ensemble facultatif de modules payants signés par ProAnimaStudio pour le cœur gratuit d’Arkvory. Pro 0.1.0 fonctionne avec Arkvory 0.6.3 sur Windows/Linux x64. Obtenez les paquets et la licence auprès de ProAnimaStudio ; ils s’installent séparément du cœur. Voir [Installation](#install) et [Licences](licenses). + +- **Déduplication :** stocke une seule fois les blocs partagés et les réutilise entre objets. Le catalogue partagé coordonne le ramasse-miettes avec la publication, les lecteurs et les sauvegardes. +- **Transferts delta :** réutilisent le contenu disponible sur un client compatible et transfèrent les données manquantes ou des correctifs. L’ensemble comprend les modules serveur de stockage et de transfert, ainsi qu’un module client delta. Le gain dépend des données et du client ; un téléchargement HTTP ordinaire ne devient pas automatiquement un transfert delta. +- **Licences :** contrôlent les écritures et optimisations payantes. Les données existantes restent lisibles si la licence expire ou devient indisponible ; les nouveaux envois utilisent le stockage du cœur et les transferts ordinaires. Le quota Pro compte les données logiques Pro, y compris les envois acceptés non terminés, sans réduction pour la déduplication. updatesUntil limite le droit aux nouvelles versions compilées des modules. + +Les modules se chargent au démarrage des services ; Docker Compose ne les charge pas. Sauvegardez les métadonnées et les données des modules avant une mise à jour. Lors de la première adoption du catalogue partagé, arrêtez les anciens processus API/worker qui écrivent ; leur coexistence avec les nouveaux n’est pas prise en charge. Restaurez ensemble les données et l’état de licence, attendez la récupération et vérifiez un nouvel envoi Pro avant de reprendre les écritures normales. + +Un grand catalogue peut être long à récupérer : sur le banc d’essai, 4 millions de blocs avec le catalogue partagé déjà restauré ont permis l’écriture après 32 minutes et 43 secondes, sans redémarrage. Ce n’est ni une garantie de délai ni une mesure de débit sur 4 To. La validation HA sur un seul hôte physique ne remplace pas les tests de fencing et de domaines de panne sur votre site. Pro ne change pas la licence du cœur. + +## Capacités des modules et plugins tiers {#module-capabilities} + +Les modules signés ProAnimaStudio peuvent ajouter du stockage, des protocoles de transfert et des routes HTTP, avec des services de tâches de fond, de calcul borné et de nettoyage coordonné selon leurs rôles. Les modules gratuits ne nécessitent pas de licence de fonctions payantes ; les modules payants déclarent leurs exigences. Chaque paquet doit correspondre à l’extension API du cœur et passer les contrôles de signature et d’intégrité. + +Cette version ne permet pas l’installation ni l’exécution de plugins tiers. Vous pouvez gérer les [clés des auteurs de confiance](#trust), mais ajouter une clé n’active pas l’installation de plugins. L’interface des modules n’est pas un bac à sable pour du code arbitraire. + ## Installer un paquet {#install} 1. Copiez le fichier du paquet `arkvory-module--.tgz` sur l'hôte. @@ -82,7 +100,7 @@ Pour réparer un paquet modifié ou absent, installez-le de nouveau. Tous les se Un module qui conserve ses propres index, caches ou état obtient un répertoire sur le volume de données : `module-data//` dans le répertoire de stockage `default`. Sa partie `data` est destinée aux sauvegardes, sa partie `cache` ne l’est pas. Arkvory compte chaque écriture dans la taille approuvée, en Mio et en fichiers, pour les deux parties ensemble. Une écriture au-delà est refusée (`module_quota_exceeded`) et le module continue de fonctionner. Sans taille approuvée, le module peut seulement lire. La [réserve du volume](./storage#disk) s’applique aussi. Sur une passerelle de lecture, le module lit les mêmes fichiers et ne peut pas les modifier. -La suppression d’un module conserve son répertoire. Supprimez `module-data//` vous-même lorsque vous n’avez plus besoin des données. Les sauvegardes n’incluent pas encore les répertoires des modules. +Les sauvegardes logiques lisent les octets des objets publiés via le module installé dans son rôle backup ; elles ne copient pas le répertoire du module, les caches et l’état privé de coordination comme une image du système de fichiers. Gardez les modules source installés et lisibles jusqu’à la fin de la copie. [--to-default-storage](backups#restore-default-storage) restaure ces objets comme des blobs ordinaires du cœur sans module d’origine ni licence payante ; prévoyez leur taille logique complète. Conservez les secrets d’installation séparément et suivez la récupération de licence avant de réactiver les écritures payantes. Retirer un module ne supprime pas son répertoire de données ; ne supprimez pas les fichiers référencés par des objets publiés. Avant de passer à extension API 0.7.0, arrêtez tous les anciens processus API et worker qui écrivent des données de modules. Les nouveaux processus partagent le suivi des quotas via le coordinateur PostgreSQL de l’installation ; les fichiers temporaires comptent aussi. L’écriture simultanée par des anciens et des nouveaux processus n’est pas prise en charge. Après un arrêt brutal, Arkvory reconstruit le suivi si nécessaire et ne supprime les répertoires temporaires du nouveau protocole qu’après avoir acquis le verrou en base de données de leur ancien propriétaire. Les anciens fichiers temporaires ne sont pas supprimés automatiquement et restent comptabilisés ; examinez-les séparément, une fois les processus d’écriture arrêtés. Les processus backup ont uniquement accès en lecture. diff --git a/wiki/fr/reference/faq.md b/wiki/fr/reference/faq.md index 2937ea38..44d70c92 100644 --- a/wiki/fr/reference/faq.md +++ b/wiki/fr/reference/faq.md @@ -17,11 +17,11 @@ Arkvory réserve jusqu’à 10 TiB de contenu par défaut (`ARKVORY_CAPACITY_BYT ### Arkvory est-il hautement disponible ? {#high-availability} -Non. Une installation correspond à un serveur, avec une base de données PostgreSQL et un répertoire de contenu local. Si le serveur s’arrête, les clients attendent puis reprennent leurs transferts ; les services redémarrent seuls après un plantage ou un blocage. Pour vous protéger de la perte du serveur, utilisez les [sauvegardes](../operate/backups). Pour lire depuis un second site, utilisez les [miroirs](../operate/mirrors) ; le basculement vers un miroir est une opération manuelle, et les changements que le miroir n’a pas encore reçus sont perdus. +Oui, avec un cluster Linux sur un site : ha-2 utilise deux serveurs de données et un témoin séparé ; ha-3 utilise trois serveurs de données. DRBD 9, Pacemaker et un fencing testé sont requis. Les écritures exigent normalement deux copies complètes. Windows et Docker Compose restent standalone. HA ne remplace pas les sauvegardes et ne protège pas contre la perte du site entier ; les miroirs sur un autre site sont asynchrones et nécessitent une bascule manuelle. Voir [Cluster](../operate/cluster), [Sauvegardes](../operate/backups) et [Miroirs](../operate/mirrors). ### Fonctionne-t-il hors ligne ? {#offline} -Le serveur fonctionne sans accès à internet. Le programme d’installation Windows inclut Node.js et PostgreSQL et s’installe hors ligne. Les paquets Linux incluent Node.js, et le gestionnaire de paquets installe PostgreSQL. Les installateurs par script et Docker téléchargent des fichiers. Les mises à jour peuvent être installées depuis une copie locale d’une version. Si le hub de mises à jour est injoignable, la vérification de mise à jour échoue et s’affiche dans la console ; rien d’autre n’est affecté. Voir [Choisir une installation](../install/index) et [Mises à jour](../install/updates). +Le cœur gratuit fonctionne sans internet. L’installateur Windows inclut Node.js et PostgreSQL ; les paquets Linux incluent Node.js et obtiennent PostgreSQL via le gestionnaire de paquets. Les scripts d’installation et Docker peuvent nécessiter des téléchargements. Les mises à jour peuvent utiliser une version locale. Si le hub est inaccessible, la recherche peut se rabattre sur GitHub ; si les deux sont inaccessibles, elle échoue sans arrêter le stockage. Les modules payants ont une durée de validité propre, en ligne ou hors ligne : prévoyez le renouvellement avant expiration. Voir [Installation](../install/index), [Mises à jour](../install/updates) et [Licences](../operate/licenses). ## Stockage et base de données {#storage-and-database} @@ -51,7 +51,7 @@ Le serveur recherche une version toutes les 6 heures, même lorsque l’installa ### Qu’est-ce qu’Arkvory envoie à ProAnimaStudio ? {#hub-traffic} -Vos fichiers et vos données restent sur votre serveur. Le serveur contacte le hub ProAnimaStudio (`hub.proanima.net`), et GitHub lorsque le hub est injoignable, pour trois choses : +Le contenu stocké reste sur votre serveur. L’installation contacte le hub ProAnimaStudio (`hub.proanima.net`) pour les usages ci-dessous. GitHub sert de recours pour trouver les versions, pas pour activer les licences : - **Vérifications de mise à jour.** La requête porte le nom du projet, le système d’exploitation, l’architecture du processeur, la version installée et le canal de mise à jour. Lorsque les statistiques sont activées, elle porte aussi un ID d’installation aléatoire. - **Statistiques anonymes.** Un événement après chaque mise à jour installée, avec l’ID d’installation, la version, le système, l’architecture et le canal. Aucun nom, aucune adresse, aucun contenu ni aucune adresse IP n’est stocké. Les statistiques sont activées par défaut ; désactivez-les avec [[ui:updateStatistics]] dans [[ui:updates]] ou avec `arkvory configure --statistics off`. Sans statistiques, une nouvelle version ne vous parvient que lorsqu’elle est déployée pour tout le monde. @@ -59,6 +59,8 @@ Vos fichiers et vos données restent sur votre serveur. Le serveur contacte le h `arkvory configure --hub-off` arrête le contact avec le hub : les versions proviennent alors uniquement de GitHub, et les commentaires se désactivent après le redémarrage des services. Un `ARKVORY_HUB_URL` vide désactive uniquement les commentaires. Voir [Licence](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), section 7. +L’activation et le renouvellement des modules payants contactent aussi le hub et échangent identifiants de licence et d’installation, versions des modules et identifiants d’activation. Sans activation, aucun trafic de licence. Désactiver les statistiques ne désactive pas les licences. Avec `--hub-off`, activation et renouvellement en ligne sont indisponibles : suivez la [procédure hors ligne](../operate/licenses#offline) et surveillez l’expiration. Les fonctions payantes exigent toujours une licence. + ### Les sauvegardes s’exécutent-elles toutes seules ? {#automatic-backups} Pas avant que vous ne les configuriez. Connectez un stockage des sauvegardes avec `arkvory configure --backup-vault --vault-key-file `, puis activez la planification quotidienne dans [[ui:backupPlan]] dans [[ui:backups]]. Le plan commence à 02:00 UTC et conserve 7 points de restauration quotidiens, 4 hebdomadaires et 6 mensuels. Tant que la planification n’est pas activée, la console affiche l’avertissement indiquant que la planification quotidienne est désactivée. Voir [Sauvegardes](../operate/backups). diff --git a/wiki/hi/operate/backups.md b/wiki/hi/operate/backups.md index 9f8fc084..fbbae872 100644 --- a/wiki/hi/operate/backups.md +++ b/wiki/hi/operate/backups.md @@ -434,3 +434,5 @@ Prometheus के लिए, API `arkvory_backup_last_success_timestamp_seconds` ## मूल संग्रहण के बिना पुनर्स्थापना {#restore-default-storage} सभी ऑब्जेक्ट को मूल वॉल्यूम या मॉड्यूल के बिना डिफ़ॉल्ट संग्रहण में रखने के लिए पुनर्स्थापना कमांड में `--to-default-storage` जोड़ें। ऑब्जेक्ट के पूरे डेटा के लिए जगह रखें। `--yes` के बिना कमांड केवल योजना की जाँच करता है और उसे दिखाता है। डेटाबेस और संग्रहण खाली होने चाहिए। यह मोड प्लेसमेंट नियम हटाता है और प्रकाशित सामग्री को सामान्य blob के रूप में पुनर्स्थापित करता है; पुनर्स्थापना के बाद नए नियम कॉन्फ़िगर करें। + +तार्किक बैकअप इंस्टॉल किए मॉड्यूल की backup भूमिका से प्रकाशित ऑब्जेक्ट के बाइट पढ़ता है; मॉड्यूल निर्देशिका, कैश और निजी समन्वय स्थिति को फ़ाइल सिस्टम इमेज की तरह कॉपी नहीं करता। कॉपी पूरी होने तक स्रोत मॉड्यूल इंस्टॉल और पढ़ने योग्य रखें। [--to-default-storage](#restore-default-storage) मूल मॉड्यूल या सशुल्क लाइसेंस के बिना इन्हें सामान्य कोर blob के रूप में बहाल करता है; पूरे तार्किक आकार की जगह रखें। इंस्टॉलेशन रहस्य अलग बचाएँ और सशुल्क लेखन दोबारा शुरू करने से पहले लाइसेंस रिकवरी करें। diff --git a/wiki/hi/operate/licenses.md b/wiki/hi/operate/licenses.md index c4dbbfdb..91bc1d6c 100644 --- a/wiki/hi/operate/licenses.md +++ b/wiki/hi/operate/licenses.md @@ -5,7 +5,7 @@ description: किसी सशुल्क मॉड्यूल का ला # लाइसेंस -Arkvory के मुफ़्त कोर को किसी लाइसेंस की ज़रूरत नहीं है। इस दस्तावेज़ का हर फ़ंक्शन बिना लाइसेंस के काम करता है, और कोई भी लाइसेंस स्थिति उन्हें बंद नहीं करती या डेटा को अपठनीय नहीं बनाती। लाइसेंस ProAnimaStudio के किसी सशुल्क मॉड्यूल को चालू करता है ([मॉड्यूल](modules) देखें)। जब तक आप लाइसेंस सक्रिय नहीं करते, Arkvory लाइसेंस के बारे में कहीं कुछ नहीं भेजता। +मुफ़्त Arkvory कोर सशुल्क मॉड्यूल लाइसेंस के बिना काम करता है। लाइसेंस [Arkvory Pro](modules#pro) सहित ProAnimaStudio की सशुल्क सुविधाएँ चालू करता है। समाप्ति मौजूदा Pro डेटा को अपठनीय नहीं बनाती; सशुल्क सुविधाएँ अनुपलब्ध होने पर नए अपलोड कोर स्टोरेज और सामान्य ट्रांसफ़र इस्तेमाल करते हैं। लाइसेंस सक्रिय करने से पहले Arkvory लाइसेंस की कोई जानकारी नहीं भेजता। इस पेज के कमांड इंस्टॉलेशन के होस्ट पर चलते हैं: Linux पर root के रूप में, Windows पर व्यवस्थापक के रूप में। Docker Compose इंस्टॉलेशन मॉड्यूल लोड नहीं करते, इसलिए वे इन कमांड को अस्वीकार करते हैं। diff --git a/wiki/hi/operate/modules.md b/wiki/hi/operate/modules.md index 97f40534..73ac8d66 100644 --- a/wiki/hi/operate/modules.md +++ b/wiki/hi/operate/modules.md @@ -9,6 +9,24 @@ description: होस्ट पर हस्ताक्षरित मॉड सेवाएँ हर बार शुरू होने पर इंस्टॉल किए गए मॉड्यूल फिर से जाँचती और लोड करती हैं। कोई मॉड्यूल तभी चलता है जब आप उसे चालू करते हैं। +## Arkvory Pro {#pro} + +Arkvory Pro मुफ़्त Arkvory कोर के लिए ProAnimaStudio के हस्ताक्षरित, सशुल्क मॉड्यूलों का वैकल्पिक समूह है। Pro 0.1.0 Windows/Linux x64 पर Arkvory 0.6.3 के साथ काम करता है। पैकेज और लाइसेंस ProAnimaStudio से लें; मॉड्यूल कोर से अलग इंस्टॉल होते हैं। [इंस्टॉलेशन](#install) और [लाइसेंस](licenses) देखें। + +- **डीडुप्लिकेशन:** साझा चंक को एक बार रखता है और कई ऑब्जेक्ट में दोबारा उपयोग करता है। साझा कैटलॉग प्रकाशन, पाठकों और बैकअप के साथ गार्बेज कलेक्शन का समन्वय करता है। +- **डेल्टा ट्रांसफ़र:** संगत क्लाइंट के पास मौजूद सामग्री का दोबारा उपयोग करते हैं और केवल अनुपलब्ध डेटा या पैच भेजते हैं। समूह में सर्वर स्टोरेज और ट्रांसफ़र मॉड्यूल तथा डेल्टा क्लाइंट मॉड्यूल हैं। बचत डेटा और क्लाइंट पर निर्भर है; सामान्य HTTP डाउनलोड अपने आप डेल्टा ट्रांसफ़र नहीं बनते। +- **लाइसेंसिंग:** सशुल्क लेखन और अनुकूलन नियंत्रित करती है। लाइसेंस समाप्त या अनुपलब्ध होने पर मौजूदा डेटा पढ़ने योग्य रहता है; नए अपलोड कोर स्टोरेज और सामान्य ट्रांसफ़र पर लौटते हैं। Pro कोटा स्वीकृत अधूरे अपलोड सहित Pro डेटा का तार्किक आकार गिनता है, डीडुप्लिकेशन की छूट के बिना। updatesUntil नए मॉड्यूल बिल्ड इस्तेमाल करने का अधिकार सीमित करता है। + +मॉड्यूल सेवाएँ शुरू होने पर लोड होते हैं; Docker Compose इंस्टॉलेशन उन्हें लोड नहीं करते। अपडेट से पहले मेटाडेटा और मॉड्यूल डेटा का बैकअप लें। साझा कैटलॉग पहली बार अपनाते समय पुराने API/worker लेखन प्रोसेस रोकें; पुराने और नए लेखकों को साथ चलाना समर्थित नहीं है। डेटा और लाइसेंस स्थिति साथ बहाल करें, रिकवरी पूरी होने दें और सामान्य लेखन से पहले एक नया Pro अपलोड जाँचें। + +बड़े कैटलॉग की रिकवरी लंबी हो सकती है: स्वीकृति स्टैंड पर पहले से बहाल साझा कैटलॉग वाले 40 लाख चंक बिना रीस्टार्ट 32 मिनट 43 सेकंड बाद लिखने योग्य हुए। यह रिकवरी समय की गारंटी या 4 TB थ्रूपुट माप नहीं है। एक भौतिक होस्ट पर HA परीक्षण आपकी साइट के fencing और विफलता डोमेन की जाँच का विकल्प नहीं है। Pro कोर के लाइसेंस की शर्तें नहीं बदलता। + +## मॉड्यूल क्षमताएँ और तृतीय-पक्ष प्लगइन {#module-capabilities} + +हस्ताक्षरित ProAnimaStudio मॉड्यूल स्टोरेज, ट्रांसफ़र प्रोटोकॉल और HTTP रूट जोड़ सकते हैं तथा अपनी भूमिकाओं के अनुसार पृष्ठभूमि कार्य, सीमित गणना और समन्वित डेटा सफ़ाई की सेवाएँ पा सकते हैं। मुफ़्त मॉड्यूलों को सशुल्क सुविधाओं का लाइसेंस नहीं चाहिए; सशुल्क मॉड्यूल अपनी आवश्यकताएँ घोषित करते हैं। हर पैकेज को कोर की extension API से संगत होना और हस्ताक्षर तथा अखंडता जाँच पास करनी होती है। + +इस रिलीज़ में तृतीय-पक्ष प्लगइन इंस्टॉल और चलाना उपलब्ध नहीं है। आप [भरोसेमंद लेखक कुंजियाँ](#trust) रख सकते हैं, लेकिन कुंजी जोड़ने से प्लगइन इंस्टॉलेशन चालू नहीं होता। मॉड्यूल इंटरफ़ेस को मनमाने कोड के लिए सैंडबॉक्स न समझें। + ## पैकेज इंस्टॉल करें {#install} 1. पैकेज फ़ाइल `arkvory-module--.tgz` को होस्ट पर कॉपी करें। @@ -82,7 +100,7 @@ Arkvory पैकेज को तब अस्वीकार करता ह जो मॉड्यूल अपने इंडेक्स, कैश या स्थिति रखता है, उसे डेटा वॉल्यूम पर एक डायरेक्टरी मिलती है: `default` की स्टोरेज डायरेक्टरी में `module-data//`। इसका `data` भाग बैकअप के लिए है, `cache` भाग नहीं। Arkvory हर लेखन को स्वीकृत आकार के विरुद्ध गिनता है, MiB में और फ़ाइलों में, दोनों भागों को मिलाकर। इससे आगे का लेखन अस्वीकार किया जाता है (`module_quota_exceeded`) और मॉड्यूल चलता रहता है। स्वीकृत आकार के बिना मॉड्यूल केवल पढ़ सकता है। [वॉल्यूम का रिज़र्व](./storage#disk) भी लागू होता है। रीड गेटवे पर मॉड्यूल वही फ़ाइलें पढ़ता है और उन्हें बदल नहीं सकता। -मॉड्यूल हटाने पर उसकी डायरेक्टरी बनी रहती है। जब डेटा की ज़रूरत न रहे, तो `module-data//` खुद हटाएँ। बैकअप में अभी मॉड्यूल डायरेक्टरी शामिल नहीं होतीं। +तार्किक बैकअप इंस्टॉल किए मॉड्यूल की backup भूमिका से प्रकाशित ऑब्जेक्ट के बाइट पढ़ता है; मॉड्यूल निर्देशिका, कैश और निजी समन्वय स्थिति को फ़ाइल सिस्टम इमेज की तरह कॉपी नहीं करता। कॉपी पूरी होने तक स्रोत मॉड्यूल इंस्टॉल और पढ़ने योग्य रखें। [--to-default-storage](backups#restore-default-storage) मूल मॉड्यूल या सशुल्क लाइसेंस के बिना इन्हें सामान्य कोर blob के रूप में बहाल करता है; पूरे तार्किक आकार की जगह रखें। इंस्टॉलेशन रहस्य अलग बचाएँ और सशुल्क लेखन दोबारा शुरू करने से पहले लाइसेंस रिकवरी करें। मॉड्यूल हटाने से उसकी डेटा निर्देशिका नहीं मिटती; प्रकाशित ऑब्जेक्ट द्वारा संदर्भित फ़ाइलें न मिटाएँ। extension API 0.7.0 में अपग्रेड करने से पहले मॉड्यूल डेटा लिखने वाली सभी पुरानी API और worker प्रक्रियाएँ रोकें। सभी नई लेखक प्रक्रियाएँ स्थापना के PostgreSQL coordinator से साझा कोटा लेखांकन करती हैं; अस्थायी फ़ाइलें भी कोटा में गिनी जाती हैं। पुराने और नए संस्करणों से एक साथ लिखना समर्थित नहीं है। क्रैश के बाद Arkvory आवश्यकतानुसार लेखांकन फिर बनाता है और पिछले स्वामी का डेटाबेस लॉक प्राप्त करने के बाद ही नए प्रोटोकॉल की अस्थायी डायरेक्टरी हटाता है। पुरानी अस्थायी फ़ाइलें अपने आप नहीं हटतीं और कोटा में गिनी जाती रहती हैं; लेखक प्रक्रियाएँ रोककर उनकी अलग से जाँच करें। backup प्रक्रियाओं को केवल पढ़ने की अनुमति है. diff --git a/wiki/hi/reference/faq.md b/wiki/hi/reference/faq.md index 2f5d38ba..297e238c 100644 --- a/wiki/hi/reference/faq.md +++ b/wiki/hi/reference/faq.md @@ -17,11 +17,11 @@ Arkvory डिफ़ॉल्ट रूप से 10 TiB तक सामग् ### क्या Arkvory उच्च उपलब्धता वाला है? {#high-availability} -नहीं। एक इंस्टॉलेशन एक सर्वर है, जिसमें एक PostgreSQL डेटाबेस और एक स्थानीय कंटेंट डायरेक्टरी होती है। सर्वर रुक जाए तो क्लाइंट प्रतीक्षा करते हैं और फिर अपने ट्रांसफ़र जारी रखते हैं; क्रैश या हैंग के बाद सेवाएँ स्वयं फिर से शुरू हो जाती हैं। सर्वर के खोने से बचाव के लिए [बैकअप](../operate/backups) इस्तेमाल करें। दूसरी साइट से पढ़ने के लिए [मिरर](../operate/mirrors) इस्तेमाल करें; मिरर पर स्विच करना एक मैन्युअल चरण है, और जो बदलाव मिरर को नहीं मिले थे वे खो जाते हैं। +हाँ, एक साइट के Linux क्लस्टर में: ha-2 दो डेटा सर्वर और अलग witness का उपयोग करता है; ha-3 तीन डेटा सर्वर का। DRBD 9, Pacemaker और जाँचा हुआ fencing आवश्यक है। सामान्यतः लेखन के लिए दो पूर्ण प्रतियाँ चाहिए। Windows और Docker Compose standalone हैं। HA बैकअप का विकल्प नहीं है और पूरी साइट के नुकसान से नहीं बचाता; दूसरी साइट के मिरर असमकालिक हैं और मैन्युअल स्विच चाहते हैं। [क्लस्टर](../operate/cluster), [बैकअप](../operate/backups) और [मिरर](../operate/mirrors) देखें। ### क्या यह ऑफ़लाइन काम करता है? {#offline} -सर्वर इंटरनेट एक्सेस के बिना काम करता है। Windows इंस्टॉलर में Node.js और PostgreSQL शामिल हैं और यह ऑफ़लाइन इंस्टॉल होता है। Linux पैकेजों में Node.js शामिल है, और पैकेज प्रबंधक PostgreSQL इंस्टॉल करता है। स्क्रिप्ट इंस्टॉलर और Docker फ़ाइलें डाउनलोड करते हैं। अपडेट किसी रिलीज़ की स्थानीय प्रति से इंस्टॉल किए जा सकते हैं। यदि अपडेट हब तक न पहुँचा जा सके, तो अपडेट जाँच विफल होती है और कंसोल में दिखाई जाती है; और कुछ प्रभावित नहीं होता। [इंस्टॉलेशन चुनें](../install/index) और [अपडेट](../install/updates) देखें। +मुफ़्त कोर इंटरनेट के बिना काम करता है। Windows इंस्टॉलर में Node.js और PostgreSQL हैं; Linux पैकेज Node.js रखते हैं और PostgreSQL पैकेज मैनेजर से लेते हैं। स्क्रिप्ट इंस्टॉलर और Docker को डाउनलोड चाहिए हो सकते हैं। अपडेट स्थानीय रिलीज़ से हो सकते हैं। हब न पहुँचने पर अपडेट खोज GitHub का सहारा ले सकती है; दोनों अनुपलब्ध हों तो जाँच विफल होती है, स्टोरेज बंद नहीं होता। सशुल्क मॉड्यूल के ऑनलाइन या ऑफ़लाइन लाइसेंस की अपनी वैधता होती है: समाप्ति से पहले नवीनीकरण करें। [इंस्टॉलेशन](../install/index), [अपडेट](../install/updates) और [लाइसेंस](../operate/licenses) देखें। ## स्टोरेज और डेटाबेस {#storage-and-database} @@ -51,7 +51,7 @@ PostgreSQL, हर इंस्टॉलेशन के लिए एक डे ### Arkvory, ProAnimaStudio को क्या भेजता है? {#hub-traffic} -आपकी फ़ाइलें और डेटा आपके सर्वर पर ही रहते हैं। सर्वर तीन चीज़ों के लिए ProAnimaStudio हब (`hub.proanima.net`) से संपर्क करता है, और हब तक न पहुँच पाने पर GitHub से: +संग्रहीत सामग्री आपके सर्वर पर रहती है। इंस्टॉलेशन नीचे दिए उद्देश्यों के लिए ProAnimaStudio हब (`hub.proanima.net`) से संपर्क करता है। GitHub रिलीज़ खोज का वैकल्पिक स्रोत है, लाइसेंस सक्रिय करने का नहीं: - **अपडेट जाँच।** अनुरोध में प्रोजेक्ट का नाम, ऑपरेटिंग सिस्टम, प्रोसेसर आर्किटेक्चर, इंस्टॉल किया गया संस्करण और अपडेट चैनल होते हैं। सांख्यिकी चालू होने पर इसमें एक यादृच्छिक इंस्टॉलेशन ID भी होती है। - **अनाम सांख्यिकी।** हर इंस्टॉल किए गए अपडेट के बाद एक इवेंट, जिसमें इंस्टॉलेशन ID, संस्करण, सिस्टम, आर्किटेक्चर और चैनल होते हैं। कोई नाम, पता, सामग्री या IP पता संग्रहीत नहीं होता। सांख्यिकी डिफ़ॉल्ट रूप से चालू हैं; उन्हें [[ui:updates]] में [[ui:updateStatistics]] से या `arkvory configure --statistics off` से बंद करें। सांख्यिकी के बिना, नया संस्करण आपके पास केवल तब पहुँचता है जब वह सबके लिए रोल आउट हो गया हो। @@ -59,6 +59,8 @@ PostgreSQL, हर इंस्टॉलेशन के लिए एक डे `arkvory configure --hub-off` हब से संपर्क करना बंद कर देता है: तब रिलीज़ केवल GitHub से आती हैं, और सेवाएँ रीस्टार्ट होने के बाद फ़ीडबैक बंद हो जाता है। खाली `ARKVORY_HUB_URL` केवल फ़ीडबैक बंद करता है। [लाइसेंस](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), अनुच्छेद 7 देखें। +सशुल्क मॉड्यूल का सक्रियण और नवीनीकरण भी हब से संपर्क करते हैं और लाइसेंस व इंस्टॉलेशन पहचान, मॉड्यूल संस्करण तथा सक्रियण क्रेडेंशियल भेजते हैं। बिना सक्रियण लाइसेंस ट्रैफ़िक नहीं होता। आँकड़े बंद करने से लाइसेंसिंग बंद नहीं होती। `--hub-off` में ऑनलाइन सक्रियण और नवीनीकरण अनुपलब्ध हैं: [ऑफ़लाइन प्रक्रिया](../operate/licenses#offline) अपनाएँ और समाप्ति का ध्यान रखें। सशुल्क सुविधाओं के लिए लाइसेंस फिर भी आवश्यक है। + ### क्या बैकअप अपने-आप चलते हैं? {#automatic-backups} जब तक आप उन्हें सेट न करें, नहीं। `arkvory configure --backup-vault --vault-key-file ` से बैकअप स्टोरेज (vault) जोड़ें, फिर [[ui:backups]] में [[ui:backupPlan]] से दैनिक शेड्यूल चालू करें। योजना 02:00 UTC पर शुरू होती है और 7 दैनिक, 4 साप्ताहिक और 6 मासिक पुनर्स्थापना बिंदु रखती है। जब तक शेड्यूल चालू न हो, कंसोल चेतावनी दिखाता है कि दैनिक शेड्यूल बंद है। [बैकअप](../operate/backups) देखें। diff --git a/wiki/ko/operate/backups.md b/wiki/ko/operate/backups.md index a96a58c3..4455bc5f 100644 --- a/wiki/ko/operate/backups.md +++ b/wiki/ko/operate/backups.md @@ -434,3 +434,5 @@ Prometheus를 위해 API는 `arkvory_backup_last_success_timestamp_seconds`(가 ## 원래 저장소 없이 복원 {#restore-default-storage} 복원 명령에 `--to-default-storage`를 추가하면 원래 볼륨이나 모듈 없이 모든 객체를 기본 저장소에 복원합니다. 전체 객체 데이터가 들어갈 공간을 확보하세요. `--yes`가 없으면 명령은 계획을 검사하고 표시하기만 합니다. 데이터베이스와 저장소는 비어 있어야 합니다. 이 모드는 배치 규칙을 삭제하고 게시된 내용을 일반 blob으로 복원합니다. 복원 후 새 배치 규칙을 설정하세요. + +논리 백업은 설치된 모듈의 backup 역할을 통해 게시된 객체 바이트를 읽으며 모듈 디렉터리, 캐시, 내부 조정 상태를 파일 시스템 이미지로 복사하지 않습니다. 복사가 끝날 때까지 원본 모듈을 설치된 읽기 가능 상태로 유지하세요. [--to-default-storage](#restore-default-storage)는 원본 모듈이나 유료 라이선스 없이 일반 코어 blob으로 객체를 복원합니다. 전체 논리 크기의 공간을 확보하세요. 설치 비밀 정보는 별도로 보관하고 유료 쓰기를 다시 켜기 전에 라이선스 복구 절차를 따르세요. diff --git a/wiki/ko/operate/licenses.md b/wiki/ko/operate/licenses.md index 173b8770..9517d724 100644 --- a/wiki/ko/operate/licenses.md +++ b/wiki/ko/operate/licenses.md @@ -5,7 +5,7 @@ description: 유료 모듈의 라이선스를 온라인 또는 오프라인으 # 라이선스 -Arkvory의 무료 코어에는 라이선스가 필요 없습니다. 이 문서의 모든 기능은 라이선스 없이 작동하며, 어떤 라이선스 상태도 기능을 끄거나 데이터를 읽을 수 없게 만들지 않습니다. 라이선스는 ProAnimaStudio의 유료 모듈을 켭니다([모듈](modules) 참조). 라이선스를 활성화하기 전까지 Arkvory는 라이선스에 관한 어떤 것도 어디로도 보내지 않습니다. +무료 Arkvory 코어는 유료 모듈 라이선스 없이 작동합니다. 라이선스는 [Arkvory Pro](modules#pro)를 포함한 ProAnimaStudio의 유료 기능을 활성화합니다. 만료되어도 기존 Pro 데이터는 읽을 수 있으며 유료 기능을 사용할 수 없으면 새 업로드는 코어 저장소와 일반 전송을 사용합니다. 라이선스를 활성화하기 전까지 Arkvory는 라이선스 정보를 보내지 않습니다. 이 페이지의 명령은 설치가 있는 호스트에서 Linux에서는 root로, Windows에서는 관리자로 실행합니다. Docker Compose 설치는 모듈을 로드하지 않으므로 이 명령을 거부합니다. diff --git a/wiki/ko/operate/modules.md b/wiki/ko/operate/modules.md index b6d5668f..ce1b1b39 100644 --- a/wiki/ko/operate/modules.md +++ b/wiki/ko/operate/modules.md @@ -9,6 +9,24 @@ description: 호스트에 서명된 모듈 패키지를 설치하고 활성화 서비스는 시작할 때마다 설치된 모듈을 다시 확인하고 로드합니다. 모듈은 활성화한 뒤에만 실행됩니다. +## Arkvory Pro {#pro} + +Arkvory Pro는 무료 Arkvory 코어에 추가하는 선택적 유료 모듈 모음이며 ProAnimaStudio가 서명합니다. Pro 0.1.0은 Windows/Linux x64에서 Arkvory 0.6.3과 함께 작동합니다. 모듈 패키지와 라이선스는 ProAnimaStudio에서 받으며 코어와 별도로 설치합니다. [설치](#install)와 [라이선스](licenses)를 참고하세요. + +- **중복 제거:** 공유 청크를 한 번 저장하고 여러 객체에서 재사용합니다. 공유 카탈로그가 게시, 읽기, 백업과 가비지 수집을 조정합니다. +- **델타 전송:** 호환 클라이언트에 이미 있는 내용을 재사용하고 없는 데이터나 패치를 전송합니다. 모음에는 서버 저장소·전송 모듈과 델타 클라이언트 모듈이 포함됩니다. 절감량은 데이터와 클라이언트에 따라 다르며 일반 HTTP 다운로드가 자동으로 델타 전송이 되지는 않습니다. +- **라이선스:** 유료 쓰기와 최적화를 제어합니다. 라이선스가 만료되거나 사용할 수 없어도 기존 데이터는 읽을 수 있으며 새 업로드는 코어 저장소와 일반 전송을 사용합니다. Pro 할당량은 수락했지만 완료하지 않은 업로드를 포함한 Pro의 논리적 데이터 크기를 계산하며 중복 제거에 따른 할인은 없습니다. updatesUntil은 새 모듈 빌드를 사용할 권한을 제한합니다. + +모듈은 서비스 시작 시 로드되며 Docker Compose 설치는 모듈을 로드하지 않습니다. 업그레이드 전 메타데이터와 모듈 데이터를 백업하세요. 공유 카탈로그를 처음 도입할 때 이전 API/worker 쓰기 프로세스를 중지하세요. 이전·새 쓰기 프로세스 혼용은 지원하지 않습니다. 데이터와 라이선스 상태를 함께 복원하고 복구를 기다린 후 새 Pro 업로드를 확인하고 정상 쓰기를 재개하세요. + +큰 카탈로그 복구에는 시간이 걸립니다. 인수 환경에서는 공유 카탈로그가 이미 복원된 400만 청크가 재시작 없이 32분 43초 후 쓰기 가능해졌습니다. 이는 복구 시간 보장이나 4 TB 처리량 측정이 아닙니다. 단일 물리 호스트의 HA 검증은 실제 현장의 fencing 및 장애 도메인 검사를 대체하지 않습니다. Pro는 코어 라이선스 조건을 바꾸지 않습니다. + +## 모듈 기능과 타사 플러그인 {#module-capabilities} + +서명된 ProAnimaStudio 모듈은 저장소, 전송 프로토콜, HTTP 경로를 추가하며 역할에 따라 백그라운드 작업, 제한된 계산, 조정된 데이터 정리 서비스를 받습니다. 무료 모듈에는 유료 기능 라이선스가 필요하지 않으며 유료 모듈은 요구 사항을 선언합니다. 각 패키지는 코어 extension API와 호환되어야 하며 서명 및 무결성 검사를 통과해야 합니다. + +이 버전에서는 타사 플러그인 설치와 실행을 지원하지 않습니다. [신뢰하는 작성자 키](#trust)를 관리할 수 있지만 키 추가가 플러그인 설치를 활성화하지는 않습니다. 모듈 인터페이스를 임의 코드의 샌드박스로 취급하지 마세요. + ## 패키지 설치 {#install} 1. 패키지 파일 `arkvory-module--.tgz`를 호스트에 복사합니다. @@ -82,7 +100,7 @@ Arkvory는 다음 경우 패키지를 거부합니다. 자체 인덱스, 캐시 또는 상태를 보관하는 모듈은 데이터 볼륨에 디렉터리를 받습니다. `default`의 스토리지 디렉터리 안의 `module-data//`입니다. 그중 `data` 부분은 백업 대상이고 `cache` 부분은 그렇지 않습니다. Arkvory는 모든 쓰기를 두 부분을 합쳐 MiB와 파일 수로 승인된 크기에 대해 계산합니다. 이를 넘는 쓰기는 거부되며(`module_quota_exceeded`) 모듈은 계속 실행됩니다. 승인된 크기가 없으면 모듈은 읽기만 할 수 있습니다. [볼륨의 예비 영역](./storage#disk)도 적용됩니다. 읽기 게이트웨이에서 모듈은 같은 파일을 읽지만 변경할 수는 없습니다. -모듈을 제거해도 디렉터리는 남습니다. 데이터가 더 이상 필요 없으면 `module-data//`를 직접 삭제하세요. 백업은 아직 모듈 디렉터리를 포함하지 않습니다. +논리 백업은 설치된 모듈의 backup 역할을 통해 게시된 객체 바이트를 읽으며 모듈 디렉터리, 캐시, 내부 조정 상태를 파일 시스템 이미지로 복사하지 않습니다. 복사가 끝날 때까지 원본 모듈을 설치된 읽기 가능 상태로 유지하세요. [--to-default-storage](backups#restore-default-storage)는 원본 모듈이나 유료 라이선스 없이 일반 코어 blob으로 객체를 복원합니다. 전체 논리 크기의 공간을 확보하세요. 설치 비밀 정보는 별도로 보관하고 유료 쓰기를 다시 켜기 전에 라이선스 복구 절차를 따르세요. 모듈을 제거해도 데이터 디렉터리는 삭제되지 않습니다. 게시된 객체가 참조하는 파일을 삭제하지 마세요. extension API 0.7.0으로 업그레이드하기 전에 모듈 데이터를 쓰는 모든 이전 API 및 worker 프로세스를 중지하세요. 새 쓰기 프로세스는 설치의 PostgreSQL 조정자를 통해 할당량 계산을 공유하며 임시 파일도 할당량에 포함됩니다. 이전 프로세스와 새 프로세스의 혼합 쓰기는 지원하지 않습니다. 충돌 후 Arkvory는 필요에 따라 사용량을 다시 계산하고 이전 소유자의 데이터베이스 잠금을 획득한 뒤에만 새 프로토콜의 임시 디렉터리를 회수합니다. 기존 임시 파일은 자동 삭제되지 않으며 계속 할당량에 포함됩니다. 쓰기 프로세스를 중지한 상태에서 별도로 확인하세요. backup 프로세스는 읽기만 가능합니다. diff --git a/wiki/ko/reference/faq.md b/wiki/ko/reference/faq.md index 66df588c..9c172ef5 100644 --- a/wiki/ko/reference/faq.md +++ b/wiki/ko/reference/faq.md @@ -17,11 +17,11 @@ Arkvory는 기본적으로 최대 10 TiB의 콘텐츠(`ARKVORY_CAPACITY_BYTES`) ### Arkvory는 고가용성을 지원하나요? {#high-availability} -아니요. 하나의 설치는 PostgreSQL 데이터베이스 하나와 로컬 콘텐츠 디렉터리 하나를 가진 서버 한 대입니다. 서버가 멈추면 클라이언트는 기다렸다가 전송을 재개합니다. 서비스는 충돌이나 중단 후 스스로 다시 시작합니다. 서버 손실에 대비하려면 [백업](../operate/backups)을 사용하세요. 두 번째 사이트에서 읽으려면 [미러](../operate/mirrors)를 사용하세요. 미러로 전환하는 것은 수동 단계이며, 미러가 아직 받지 못한 변경 사항은 손실됩니다. +단일 사이트 Linux 클러스터에서 가능합니다. ha-2는 데이터 서버 두 대와 별도 witness를, ha-3는 데이터 서버 세 대를 사용합니다. DRBD 9, Pacemaker와 검증된 fencing이 필요합니다. 일반적으로 쓰기에는 완전한 복사본 두 개가 필요합니다. Windows와 Docker Compose는 standalone입니다. HA는 백업을 대체하거나 사이트 전체 손실을 보호하지 않습니다. 다른 사이트의 미러는 비동기이며 수동 전환이 필요합니다. [클러스터](../operate/cluster), [백업](../operate/backups), [미러](../operate/mirrors)를 보세요. ### 오프라인에서도 동작하나요? {#offline} -서버는 인터넷 접속 없이 동작합니다. Windows 설치 프로그램에는 Node.js와 PostgreSQL이 포함되어 있어 오프라인으로 설치합니다. Linux 패키지에는 Node.js가 포함되어 있고, 패키지 관리자가 PostgreSQL을 설치합니다. 스크립트 설치 프로그램과 Docker는 파일을 다운로드합니다. 업데이트는 릴리스의 로컬 복사본에서 설치할 수 있습니다. 업데이트 허브에 연결할 수 없으면 업데이트 확인이 실패하고 콘솔에 표시되며, 그 밖에는 아무 영향이 없습니다. [설치 선택](../install/index) 및 [업데이트](../install/updates)를 참조하세요. +무료 코어는 인터넷 없이 작동합니다. Windows 설치 프로그램에는 Node.js와 PostgreSQL이 포함되고 Linux 패키지는 Node.js를 포함하며 PostgreSQL은 패키지 관리자로 받습니다. 스크립트 설치와 Docker는 다운로드가 필요할 수 있습니다. 로컬 릴리스로 업데이트할 수 있습니다. 허브에 연결할 수 없으면 업데이트 검색은 GitHub로 대체할 수 있으며 둘 다 불가능하면 저장소를 중단하지 않고 검사만 실패합니다. 유료 모듈에는 별도의 온라인·오프라인 라이선스 유효기간이 있으므로 만료 전에 갱신하세요. [설치](../install/index), [업데이트](../install/updates), [라이선스](../operate/licenses)를 참고하세요. ## 스토리지 및 데이터베이스 {#storage-and-database} @@ -51,7 +51,7 @@ PostgreSQL이며, 설치마다 데이터베이스 하나를 사용합니다. Win ### Arkvory는 ProAnimaStudio로 무엇을 전송하나요? {#hub-traffic} -파일과 데이터는 서버에 남아 있습니다. 서버는 세 가지 목적으로 ProAnimaStudio 허브(`hub.proanima.net`)에 연결하고, 허브에 연결할 수 없으면 GitHub에 연결합니다. +저장된 콘텐츠는 서버에 남습니다. 설치는 아래 목적으로 ProAnimaStudio 허브(`hub.proanima.net`)에 연결합니다. GitHub는 릴리스 검색의 대체 경로이며 라이선스 활성화용이 아닙니다. - **업데이트 확인.** 요청에는 프로젝트 이름, 운영 체제, 프로세서 아키텍처, 설치된 버전, 업데이트 채널이 포함됩니다. 통계가 켜져 있으면 무작위 설치 ID도 포함됩니다. - **익명 통계.** 업데이트가 설치된 후 한 번 이벤트를 보내며, 여기에는 설치 ID, 버전, 시스템, 아키텍처, 채널이 포함됩니다. 이름, 주소, 콘텐츠, IP 주소는 저장되지 않습니다. 통계는 기본적으로 켜져 있으며, [[ui:updates]]의 [[ui:updateStatistics]] 또는 `arkvory configure --statistics off`로 끌 수 있습니다. 통계가 없으면 새 버전은 모든 사용자에게 배포될 때만 도달합니다. @@ -59,6 +59,8 @@ PostgreSQL이며, 설치마다 데이터베이스 하나를 사용합니다. Win `arkvory configure --hub-off`는 허브 연결을 중단합니다. 그러면 릴리스는 GitHub에서만 오고, 피드백은 서비스 재시작 후 꺼집니다. `ARKVORY_HUB_URL`을 비우면 피드백만 꺼집니다. [라이선스](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md) 섹션 7을 참조하세요. +유료 모듈 활성화와 갱신도 허브에 연결하며 라이선스·설치 식별자, 모듈 버전, 활성화 자격 증명을 교환합니다. 활성화하지 않으면 라이선스 트래픽은 없습니다. 통계를 꺼도 라이선스 기능은 꺼지지 않습니다. `--hub-off`에서는 온라인 활성화와 갱신이 불가능하므로 [오프라인 절차](../operate/licenses#offline)를 사용하고 만료를 관리하세요. 유료 기능에는 여전히 라이선스가 필요합니다. + ### 백업은 스스로 실행되나요? {#automatic-backups} 직접 설정하기 전에는 실행되지 않습니다. `arkvory configure --backup-vault --vault-key-file `로 보관소를 연결한 다음, [[ui:backups]]의 [[ui:backupPlan]]에서 매일 일정을 켜세요. 계획은 02:00 UTC에 시작하며 매일 7개, 매주 4개, 매월 6개의 복원 지점을 유지합니다. 일정이 켜지기 전까지 콘솔은 매일 일정이 꺼져 있다는 경고를 표시합니다. [백업](../operate/backups)을 참조하세요. diff --git a/wiki/operate/backups.md b/wiki/operate/backups.md index e637aec9..50934374 100644 --- a/wiki/operate/backups.md +++ b/wiki/operate/backups.md @@ -434,3 +434,5 @@ Read the agent log with `journalctl -u arkvory-backup` on Linux, in `logs\` of t ## Restore without the original storage {#restore-default-storage} Add `--to-default-storage` to the restore command to place all objects in the default storage without the original volumes or modules. Reserve space for the full object bytes. Without `--yes`, the command only checks and reports the plan. The database and storage must be empty. This mode clears placement rules and restores published content as ordinary blobs; configure new placement rules after recovery. + +Logical backups capture published object bytes through the installed module in its backup role; they do not copy the module directory, caches or private coordination state as a filesystem image. Keep the source modules installed and readable until capture finishes. A restore with [--to-default-storage](#restore-default-storage) can recover these objects as ordinary core blobs without the original module or paid licence; reserve their full logical size. Preserve installation secrets separately and follow the licence recovery procedure before enabling paid writes again. diff --git a/wiki/operate/licenses.md b/wiki/operate/licenses.md index f524af52..89dafd27 100644 --- a/wiki/operate/licenses.md +++ b/wiki/operate/licenses.md @@ -5,7 +5,7 @@ description: Activate the licence of a paid module online or offline, check its # Licences -The free core of Arkvory needs no licence. Every function of this documentation works without one, and no licence state turns any of them off or makes data unreadable. A licence enables a paid module of ProAnimaStudio (see [Modules](modules)). Until you activate a licence, Arkvory sends nothing about licences anywhere. +The free Arkvory core works without a paid-module licence. A licence enables paid ProAnimaStudio features, including [Arkvory Pro](modules#pro). Expiry does not make existing Pro data unreadable; new uploads use core storage and ordinary transfers when paid features are unavailable. Until you activate a licence, Arkvory sends nothing about licences anywhere. The commands of this page run on the host of the installation, as root on Linux or as an administrator on Windows. Docker Compose installations do not load modules, so they refuse these commands. diff --git a/wiki/operate/modules.md b/wiki/operate/modules.md index 01b48122..c1d505f6 100644 --- a/wiki/operate/modules.md +++ b/wiki/operate/modules.md @@ -9,6 +9,24 @@ A module package adds a feature to Arkvory. Arkvory installs only packages whose The services check the installed modules again and load them each time they start. A module runs only after you enable it. +## Arkvory Pro {#pro} + +Arkvory Pro is an optional set of paid, signed ProAnimaStudio modules for the free Arkvory core. Pro 0.1.0 works with Arkvory 0.6.3 on Windows/Linux x64. Obtain the module packages and licence from ProAnimaStudio; they are installed separately from the core. See [installation](#install) and [licences](licenses). + +- **Deduplication** stores shared chunks once and reuses them across objects. The shared catalog coordinates garbage collection with publication, readers and backups. +- **Delta transfers** reuse content already available to a compatible client and transfer the missing data or patches. The bundle contains server storage/transfer modules and a delta client module. Savings depend on the data and client; ordinary HTTP downloads do not automatically become delta transfers. +- **Licensing** controls paid writes and optimizations. Existing data remains readable when the licence expires or is unavailable; new uploads fall back to core storage and ordinary transfers. The Pro quota counts logical Pro data, including accepted unfinished uploads, without a deduplication discount. A licence's updatesUntil limits eligibility for newer module builds. + +Modules load at service startup; Docker Compose installations do not load them. Back up metadata and module data before an upgrade. For the first adoption of the shared catalog, stop older API/worker writers; mixed old/new writers are unsupported. Restore data and licence state together, wait for recovery, and verify a new Pro upload before resuming normal writes. + +Recovery of a large catalog can take time: on the acceptance stand, 4 million chunks with an already restored shared catalog became writable after 32 minutes 43 seconds, without restarting. This is not a restore-time guarantee or a 4 TB throughput measurement. HA acceptance on one physical host does not replace fencing and failure-domain checks on your site. Pro does not change the core's licence terms. + +## Module capabilities and third-party plugins {#module-capabilities} + +Signed ProAnimaStudio modules can add storage, transfer protocols and HTTP routes, with services for background work, bounded computation and coordinated data cleanup according to their roles. Free modules need no paid feature licence; paid modules declare their licence requirements. Each package must match the core's extension API and pass signature and integrity checks. + +Third-party plugin installation and execution are not available in this release. You can maintain the [trusted author keys](#trust), but adding a key does not enable plugin installation. Do not treat the module interface as a sandbox for arbitrary code. + ## Install a package {#install} 1. Copy the package file `arkvory-module--.tgz` to the host. @@ -82,7 +100,7 @@ Install the package again to repair a changed or missing package. Every service A module that keeps indexes, caches or state of its own gets a directory on the data volume: `module-data//` in the storage directory of `default`. Its `data` part is meant for backups, its `cache` part is not. Arkvory counts every write against the approved size, in MiB and in files, for both parts together. A write beyond it is refused (`module_quota_exceeded`) and the module keeps running. Without an approved size, the module can only read. The [reserve of the volume](./storage#disk) applies too. On a read gateway the module reads the same files and cannot change them. -Removing a module keeps its directory. Delete `module-data//` yourself when you no longer need the data. Backups do not include module directories yet. +Logical backups capture published object bytes through the installed module in its backup role; they do not copy the module directory, caches or private coordination state as a filesystem image. Keep the source modules installed and readable until capture finishes. A restore with [--to-default-storage](backups#restore-default-storage) can recover these objects as ordinary core blobs without the original module or paid licence; reserve their full logical size. Preserve installation secrets separately and follow the licence recovery procedure before enabling paid writes again. Removing a module does not delete its data directory; do not delete files still referenced by published objects. Before upgrading to extension API 0.7.0, stop all older API and worker processes that write module data. All new writers share quota accounting through the installation’s PostgreSQL coordinator; temporary files also count toward the quota. Mixed old and new writers are unsupported. After a crash, Arkvory rebuilds accounting when needed and reclaims temporary directories of the new protocol only after acquiring the previous owner’s database lock. Legacy temporary files are not removed automatically and continue to count toward the quota; review them separately with writers stopped. Backup processes have read-only access. diff --git a/wiki/pt/operate/backups.md b/wiki/pt/operate/backups.md index ae890f5c..31f6f8f8 100644 --- a/wiki/pt/operate/backups.md +++ b/wiki/pt/operate/backups.md @@ -434,3 +434,5 @@ Leia o log do agente com `journalctl -u arkvory-backup` no Linux, em `logs\` na ## Restaurar sem o armazenamento original {#restore-default-storage} Adicione `--to-default-storage` ao comando de restauração para colocar todos os objetos no armazenamento padrão sem os volumes ou módulos originais. Reserve espaço para os bytes completos dos objetos. Sem `--yes`, o comando apenas verifica e apresenta o plano. O banco de dados e o armazenamento devem estar vazios. Este modo remove as regras de posicionamento e restaura o conteúdo publicado como blobs comuns; configure novas regras após a recuperação. + +Backups lógicos capturam os bytes dos objetos publicados pelo módulo instalado no papel backup; não copiam diretórios de módulos, caches e estado privado de coordenação como imagem do sistema de arquivos. Mantenha os módulos de origem instalados e legíveis até terminar a cópia. [--to-default-storage](#restore-default-storage) restaura esses objetos como blobs normais do núcleo sem o módulo original ou licença paga; reserve o tamanho lógico completo. Guarde segredos da instalação separadamente e siga a recuperação da licença antes de reativar gravações pagas. diff --git a/wiki/pt/operate/licenses.md b/wiki/pt/operate/licenses.md index 8f9c9b5a..4956e866 100644 --- a/wiki/pt/operate/licenses.md +++ b/wiki/pt/operate/licenses.md @@ -5,7 +5,7 @@ description: Ative a licença de um módulo pago online ou offline, verifique o # Licenças -O núcleo gratuito do Arkvory não precisa de licença. Todas as funções desta documentação funcionam sem ela, e nenhum estado de licença desliga qualquer uma delas ou torna os dados ilegíveis. Uma licença habilita um módulo pago da ProAnimaStudio (veja [Módulos](modules)). Até você ativar uma licença, o Arkvory não envia nada sobre licenças a lugar nenhum. +O núcleo gratuito do Arkvory funciona sem licença de módulos pagos. Uma licença habilita recursos pagos da ProAnimaStudio, incluindo [Arkvory Pro](modules#pro). A expiração não torna os dados Pro existentes ilegíveis; quando os recursos pagos estão indisponíveis, novos uploads usam o armazenamento do núcleo e transferências comuns. Até você ativar uma licença, o Arkvory não envia nada sobre licenças. Os comandos desta página rodam no host da instalação, como root no Linux ou como administrador no Windows. Instalações com Docker Compose não carregam módulos e por isso recusam esses comandos. diff --git a/wiki/pt/operate/modules.md b/wiki/pt/operate/modules.md index fecb58e3..e5d92f7c 100644 --- a/wiki/pt/operate/modules.md +++ b/wiki/pt/operate/modules.md @@ -9,6 +9,24 @@ Um pacote de módulo adiciona uma função ao Arkvory. O Arkvory instala apenas Os serviços verificam de novo os módulos instalados e os carregam sempre que iniciam. Um módulo só é executado depois que você o ativa. +## Arkvory Pro {#pro} + +Arkvory Pro é um conjunto opcional de módulos pagos e assinados da ProAnimaStudio para o núcleo gratuito do Arkvory. Pro 0.1.0 funciona com Arkvory 0.6.3 em Windows/Linux x64. Obtenha os pacotes e a licença com a ProAnimaStudio; os módulos são instalados separadamente do núcleo. Veja [Instalação](#install) e [Licenças](licenses). + +- **Deduplicação:** armazena os chunks compartilhados uma vez e os reutiliza entre objetos. O catálogo compartilhado coordena a coleta de lixo com publicação, leitores e backups. +- **Transferências delta:** reutilizam conteúdo disponível em um cliente compatível e transferem os dados ausentes ou patches. O conjunto inclui módulos de armazenamento e transferência do servidor e um módulo cliente delta. A economia depende dos dados e do cliente; downloads HTTP comuns não viram transferências delta automaticamente. +- **Licenciamento:** controla gravações e otimizações pagas. Os dados existentes continuam legíveis se a licença expirar ou ficar indisponível; novos uploads usam o armazenamento do núcleo e transferências comuns. A cota Pro conta os dados lógicos Pro, incluindo uploads aceitos ainda incompletos, sem desconto por deduplicação. updatesUntil limita o direito a builds mais recentes dos módulos. + +Os módulos carregam na inicialização dos serviços; Docker Compose não os carrega. Faça backup dos metadados e dos dados dos módulos antes de atualizar. Na primeira adoção do catálogo compartilhado, pare os processos API/worker antigos que gravam; misturar escritores antigos e novos não é suportado. Restaure dados e estado da licença juntos, aguarde a recuperação e verifique um novo upload Pro antes de retomar as gravações normais. + +Recuperar um catálogo grande pode demorar: no ambiente de aceitação, 4 milhões de chunks com o catálogo compartilhado já restaurado permitiram gravações após 32 minutos e 43 segundos, sem reiniciar. Isso não garante um prazo de recuperação nem mede a vazão com 4 TB. A aceitação HA em um único host físico não substitui testes de fencing e domínios de falha no seu ambiente. Pro não altera a licença do núcleo. + +## Recursos dos módulos e plugins de terceiros {#module-capabilities} + +Módulos assinados da ProAnimaStudio podem adicionar armazenamento, protocolos de transferência e rotas HTTP, com serviços de trabalho em segundo plano, computação limitada e limpeza coordenada conforme seus papéis. Módulos gratuitos não precisam de licença de recursos pagos; os pagos declaram seus requisitos. Cada pacote deve corresponder à extension API do núcleo e passar pelas verificações de assinatura e integridade. + +Esta versão não permite instalar nem executar plugins de terceiros. Você pode manter as [chaves de autores confiáveis](#trust), mas adicionar uma chave não habilita a instalação de plugins. A interface de módulos não é uma sandbox para código arbitrário. + ## Instalar um pacote {#install} 1. Copie o arquivo do pacote `arkvory-module--.tgz` para o host. @@ -82,7 +100,7 @@ Para reparar um pacote alterado ou ausente, instale-o de novo. Todos os serviço Um módulo que guarda índices, caches ou estado próprios recebe um diretório no volume de dados: `module-data//` no diretório de armazenamento de `default`. A parte `data` dele é destinada a backups; a parte `cache`, não. O Arkvory desconta cada gravação do tamanho aprovado, em MiB e em arquivos, para as duas partes juntas. Uma gravação além dele é recusada (`module_quota_exceeded`), e o módulo continua rodando. Sem um tamanho aprovado, o módulo só pode ler. A [reserva do volume](./storage#disk) também vale. Em um gateway de leitura, o módulo lê os mesmos arquivos e não pode alterá-los. -Remover um módulo mantém o diretório dele. Exclua `module-data//` você mesmo quando não precisar mais dos dados. Os backups ainda não incluem os diretórios de módulos. +Backups lógicos capturam os bytes dos objetos publicados pelo módulo instalado no papel backup; não copiam diretórios de módulos, caches e estado privado de coordenação como imagem do sistema de arquivos. Mantenha os módulos de origem instalados e legíveis até terminar a cópia. [--to-default-storage](backups#restore-default-storage) restaura esses objetos como blobs normais do núcleo sem o módulo original ou licença paga; reserve o tamanho lógico completo. Guarde segredos da instalação separadamente e siga a recuperação da licença antes de reativar gravações pagas. Remover um módulo não apaga seu diretório de dados; não apague arquivos referenciados por objetos publicados. Antes de atualizar para extension API 0.7.0, pare todos os processos API e worker antigos que gravam dados de módulos. Os novos processos compartilham a contabilização da quota pelo coordenador PostgreSQL da instalação; arquivos temporários também contam. A gravação simultânea por processos antigos e novos não é suportada. Após uma falha, o Arkvory reconstrói a contabilização quando necessário e remove diretórios temporários do novo protocolo somente após obter o bloqueio do proprietário anterior no banco. Arquivos temporários antigos não são removidos automaticamente e continuam contando para a quota; revise-os separadamente com os processos de gravação parados. Processos backup têm acesso somente de leitura. diff --git a/wiki/pt/reference/faq.md b/wiki/pt/reference/faq.md index cacf5b9f..e208ed34 100644 --- a/wiki/pt/reference/faq.md +++ b/wiki/pt/reference/faq.md @@ -17,11 +17,11 @@ O Arkvory reserva até 10 TiB de conteúdo por padrão (`ARKVORY_CAPACITY_BYTES` ### O Arkvory tem alta disponibilidade? {#high-availability} -Não. Uma instalação é um único servidor com um banco de dados PostgreSQL e um diretório local de conteúdo. Se o servidor parar, os clientes esperam e depois retomam suas transferências; os serviços reiniciam sozinhos após uma falha ou um travamento. Para proteção contra a perda do servidor, use [backups](../operate/backups). Para leitura a partir de um segundo site, use [espelhos](../operate/mirrors); a troca para um espelho é um passo manual, e as alterações que o espelho ainda não recebeu são perdidas. +Sim, com um cluster Linux em um local: ha-2 usa dois servidores de dados e uma testemunha separada; ha-3 usa três servidores de dados. DRBD 9, Pacemaker e fencing testado são necessários. Normalmente as gravações exigem duas cópias completas. Windows e Docker Compose continuam standalone. HA não substitui backups nem protege contra a perda de todo o local; espelhos em outro local são assíncronos e exigem troca manual. Veja [Cluster](../operate/cluster), [Backups](../operate/backups) e [Espelhos](../operate/mirrors). ### Ele funciona offline? {#offline} -O servidor funciona sem acesso à internet. O instalador do Windows inclui o Node.js e o PostgreSQL e instala offline. Os pacotes do Linux incluem o Node.js, e o gerenciador de pacotes instala o PostgreSQL. Os instaladores por script e o Docker baixam arquivos. As atualizações podem ser instaladas a partir de uma cópia local de uma versão. Se o hub de atualizações não puder ser alcançado, a verificação de atualização falha e é mostrada no console; nada mais é afetado. Consulte [Escolher uma instalação](../install/index) e [Atualizações](../install/updates). +O núcleo gratuito funciona sem internet. O instalador Windows inclui Node.js e PostgreSQL; pacotes Linux incluem Node.js e obtêm PostgreSQL pelo gerenciador de pacotes. Instaladores por script e Docker podem precisar de downloads. Atualizações podem usar uma versão local. Se o hub estiver inacessível, a busca pode recorrer ao GitHub; se ambos estiverem inacessíveis, ela falha sem parar o armazenamento. Módulos pagos têm validade própria de licença online ou offline: planeje renovar antes de expirar. Veja [Instalação](../install/index), [Atualizações](../install/updates) e [Licenças](../operate/licenses). ## Armazenamento e banco de dados {#storage-and-database} @@ -51,7 +51,7 @@ O servidor procura uma versão a cada 6 horas mesmo quando a instalação autom ### O que o Arkvory envia para a ProAnimaStudio? {#hub-traffic} -Seus arquivos e dados permanecem no seu servidor. O servidor contata o hub da ProAnimaStudio (`hub.proanima.net`), e o GitHub quando o hub não pode ser alcançado, para três coisas: +O conteúdo armazenado fica no seu servidor. A instalação contata o hub ProAnimaStudio (`hub.proanima.net`) para os fins abaixo. GitHub é uma alternativa para buscar versões, não para ativar licenças: - **Verificações de atualização.** A solicitação carrega o nome do projeto, o sistema operacional, a arquitetura do processador, a versão instalada e o canal de atualização. Com as estatísticas ativadas, ela também carrega um ID de instalação aleatório. - **Estatísticas anônimas.** Um evento após cada atualização instalada, com o ID de instalação, a versão, o sistema, a arquitetura e o canal. Nenhum nome, endereço, conteúdo ou endereço IP é armazenado. As estatísticas ficam ativadas por padrão; desative-as com [[ui:updateStatistics]] em [[ui:updates]] ou com `arkvory configure --statistics off`. Sem estatísticas, uma nova versão chega até você somente quando é distribuída para todos. @@ -59,6 +59,8 @@ Seus arquivos e dados permanecem no seu servidor. O servidor contata o hub da Pr `arkvory configure --hub-off` impede o contato com o hub: as versões então vêm somente do GitHub, e o feedback é desativado após a reinicialização dos serviços. Um `ARKVORY_HUB_URL` vazio desativa somente o feedback. Consulte a [Licença](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), seção 7. +Ativação e renovação de módulos pagos também contatam o hub e trocam identificadores de licença e instalação, versões dos módulos e credenciais de ativação. Sem ativação não há tráfego de licenças. Desativar estatísticas não desativa o licenciamento. Com `--hub-off`, ativação e renovação online ficam indisponíveis: use o [procedimento offline](../operate/licenses#offline) e acompanhe a validade. Recursos pagos continuam exigindo licença. + ### Os backups são executados sozinhos? {#automatic-backups} Não, até você configurá-los. Conecte um armazenamento de backups (vault) com `arkvory configure --backup-vault --vault-key-file ` e depois ative o agendamento diário em [[ui:backupPlan]] em [[ui:backups]]. O plano começa às 02:00 UTC e mantém 7 pontos de restauração diários, 4 semanais e 6 mensais. Enquanto o agendamento estiver desativado, o console mostra o aviso de que o agendamento diário está desligado. Consulte [Backups](../operate/backups). diff --git a/wiki/reference/faq.md b/wiki/reference/faq.md index 304dae79..d0bd6436 100644 --- a/wiki/reference/faq.md +++ b/wiki/reference/faq.md @@ -17,11 +17,11 @@ Arkvory reserves up to 10 TiB of content by default (`ARKVORY_CAPACITY_BYTES`), ### Is Arkvory highly available? {#high-availability} -No. One installation is one server with one PostgreSQL database and a local content directory. If the server stops, clients wait and then resume their transfers; the services restart by themselves after a crash or a hang. For protection against the loss of the server, use [backups](../operate/backups). For reading from a second site, use [mirrors](../operate/mirrors); switching to a mirror is a manual step, and changes the mirror had not yet received are lost. +Yes, with a Linux cluster on one site: ha-2 uses two data servers and a separate witness; ha-3 uses three data servers. DRBD 9, Pacemaker and tested fencing are required. Normally writes require two complete copies. Windows and Docker Compose remain standalone. HA does not replace backups or protect against losing the whole site; mirrors on a second site are asynchronous and require a manual switch. See [Cluster](../operate/cluster), [Backups](../operate/backups) and [Mirrors](../operate/mirrors). ### Does it work offline? {#offline} -The server works without internet access. The Windows installer includes Node.js and PostgreSQL and installs offline. The Linux packages include Node.js, and the package manager installs PostgreSQL. The script installers and Docker download files. Updates can be installed from a local copy of a release. If the update hub cannot be reached, the update check fails and is shown in the console; nothing else is affected. See [Choose an installation](../install/index) and [Updates](../install/updates). +The free core works without internet access. The Windows installer includes Node.js and PostgreSQL; Linux packages include Node.js and obtain PostgreSQL through the package manager. Script installers and Docker may need downloads. Updates can use a local release. If the hub is unreachable, update discovery can fall back to GitHub; if both are unreachable, it fails without stopping storage. Paid modules have separate online or offline licence validity: plan renewal before expiry. See [Installation](../install/index), [Updates](../install/updates) and [Licences](../operate/licenses). ## Storage and database {#storage-and-database} @@ -51,7 +51,7 @@ The server checks for a release every 6 hours even when automatic installation i ### What does Arkvory send to ProAnimaStudio? {#hub-traffic} -Your files and data stay on your server. The server contacts the ProAnimaStudio hub (`hub.proanima.net`), and GitHub when the hub cannot be reached, for three things: +Your stored content stays on your server. The installation contacts the ProAnimaStudio hub (`hub.proanima.net`) for the purposes below. GitHub is a fallback for release discovery, not for licence activation: - **Update checks.** The request carries the project name, the operating system, the processor architecture, the installed version and the update channel. With statistics on, it also carries a random installation ID. - **Anonymous statistics.** One event after each installed update, with the installation ID, the version, the system, the architecture and the channel. No names, addresses, content or IP addresses are stored. Statistics are on by default; turn them off with [[ui:updateStatistics]] in [[ui:updates]] or with `arkvory configure --statistics off`. Without statistics, a new version reaches you only when it is rolled out to everyone. @@ -59,6 +59,8 @@ Your files and data stay on your server. The server contacts the ProAnimaStudio `arkvory configure --hub-off` stops contacting the hub: releases then come from GitHub only, and feedback turns off after the services restart. An empty `ARKVORY_HUB_URL` turns off feedback alone. See [License](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), section 7. +Paid-module activation and refresh also contact the hub and exchange licence/installation identifiers, module versions and activation credentials. Without activation there is no licence traffic. Disabling statistics does not disable licensing. With `--hub-off`, online activation and renewal are unavailable: use the [offline licence procedure](../operate/licenses#offline) and track its expiry. This does not remove the need for a licence for paid features. + ### Do backups run by themselves? {#automatic-backups} Not until you set them up. Connect a vault with `arkvory configure --backup-vault --vault-key-file `, then turn on the daily schedule in [[ui:backupPlan]] in [[ui:backups]]. The plan starts at 02:00 UTC and keeps 7 daily, 4 weekly and 6 monthly restore points. Until the schedule is on, the console shows the warning that the daily schedule is off. See [Backups](../operate/backups). diff --git a/wiki/ru/operate/backups.md b/wiki/ru/operate/backups.md index 993b23ab..d6197478 100644 --- a/wiki/ru/operate/backups.md +++ b/wiki/ru/operate/backups.md @@ -434,3 +434,5 @@ arkvoryctl backup status --json || echo "backup problem" ## Восстановление без исходного хранилища {#restore-default-storage} Добавьте `--to-default-storage` к команде восстановления, чтобы поместить все объекты в основное хранилище без исходных томов или модулей. Подготовьте место для полных байтов объектов. Без `--yes` команда только проверяет и показывает план. База данных и хранилище должны быть пустыми. Этот режим удаляет правила размещения и восстанавливает опубликованные данные как обычные объекты; настройте новые правила после восстановления. + +Логическая копия читает байты опубликованных объектов через установленный модуль в роли backup; она не копирует каталог модуля, кеши и внутреннее состояние координации как образ файловой системы. Сохраняйте модули источника установленными и доступными для чтения до завершения копирования. Восстановление с [--to-default-storage](#restore-default-storage) возвращает эти объекты как обычные blobs ядра без исходного модуля и платной лицензии; предусмотрите место под полный логический размер. Секреты установки сохраняйте отдельно; перед возобновлением платной записи выполните процедуру восстановления лицензии. diff --git a/wiki/ru/operate/licenses.md b/wiki/ru/operate/licenses.md index 891b88ed..66f54b14 100644 --- a/wiki/ru/operate/licenses.md +++ b/wiki/ru/operate/licenses.md @@ -5,7 +5,7 @@ description: Активируйте лицензию платного модул # Лицензии -Бесплатному ядру Arkvory лицензия не нужна. Все функции из этой документации работают без неё, и ни одно состояние лицензии не выключает их и не делает данные нечитаемыми. Лицензия включает платный модуль ProAnimaStudio (см. [Модули](modules)). Пока вы не активировали лицензию, Arkvory никуда не отправляет ничего о лицензиях. +Бесплатное ядро Arkvory работает без лицензии на платные модули. Лицензия включает платные функции ProAnimaStudio, в том числе [Arkvory Pro](modules#pro). Истечение лицензии не делает существующие данные Pro нечитаемыми; при недоступности платных функций новые загрузки используют хранилище ядра и обычную передачу. Пока вы не активировали лицензию, Arkvory никуда не отправляет ничего о лицензиях. Команды этой страницы выполняются на хосте установки: от root в Linux или от администратора в Windows. Установки Docker Compose не загружают модули, поэтому эти команды там отклоняются. diff --git a/wiki/ru/operate/modules.md b/wiki/ru/operate/modules.md index 44249601..86bcb063 100644 --- a/wiki/ru/operate/modules.md +++ b/wiki/ru/operate/modules.md @@ -9,6 +9,24 @@ description: Установка подписанных пакетов модул Службы заново проверяют установленные модули и загружают их при каждом запуске. Модуль работает только после того, как вы его включите. +## Arkvory Pro {#pro} + +Arkvory Pro — дополнительный набор платных подписанных модулей ProAnimaStudio для бесплатного ядра Arkvory. Pro 0.1.0 работает с Arkvory 0.6.3 на Windows/Linux x64. Пакеты модулей и лицензию получают у ProAnimaStudio; модули устанавливаются отдельно от ядра. См. [установку](#install) и [лицензии](licenses). + +- **Дедупликация** хранит общие чанки один раз и переиспользует их в разных объектах. Общий каталог согласует сборку мусора с публикацией, чтением и резервным копированием. +- **Дельта-передачи** используют содержимое, уже доступное совместимому клиенту, и передают недостающие данные или патчи. Комплект содержит серверные модули хранения и передачи, а также клиентский модуль дельты. Экономия зависит от данных и клиента; обычное HTTP-скачивание автоматически не становится дельта-передачей. +- **Лицензирование** управляет платной записью и оптимизациями. При истечении или недоступности лицензии существующие данные остаются читаемыми; новые загрузки переходят в хранилище ядра и на обычную передачу. Квота Pro считает логические данные Pro, включая принятые незавершённые загрузки, без скидки за дедупликацию. Поле updatesUntil лицензии ограничивает право на новые сборки модулей. + +Модули загружаются при старте служб; установки Docker Compose их не загружают. Перед обновлением сохраните копию метаданных и данных модулей. При первом внедрении общего каталога остановите старые пишущие API/worker: смешанная работа старых и новых писателей не поддерживается. Восстанавливайте данные и состояние лицензии вместе, дождитесь восстановления и проверьте новую загрузку в Pro перед возвратом обычной записи. + +Восстановление большого каталога может быть долгим: на приёмочном стенде запись при 4 млн чанков и уже восстановленном общем каталоге стала доступна через 32 минуты 43 секунды без перезапуска. Это не гарантия времени восстановления и не замер пропускной способности на 4 ТБ. Проверка HA на одном физическом хосте не заменяет проверку fencing и доменов отказа вашей площадки. Pro не меняет условия лицензии ядра. + +## Возможности модулей и сторонние плагины {#module-capabilities} + +Подписанные модули ProAnimaStudio могут добавлять хранилища, протоколы передачи и HTTP-маршруты, получать службы фоновой работы, ограниченных вычислений и согласованной очистки данных согласно своим ролям. Бесплатным модулям не нужна лицензия на платные функции; платные объявляют свои лицензионные требования. Каждый пакет должен соответствовать extension API ядра и пройти проверку подписи и целостности. + +Установка и выполнение сторонних плагинов в этом выпуске недоступны. Можно вести [список доверенных ключей авторов](#trust), но добавление ключа не включает установку плагинов. Интерфейс модулей не является песочницей для произвольного кода. + ## Установить пакет {#install} 1. Скопируйте файл пакета `arkvory-module--.tgz` на хост. @@ -82,7 +100,7 @@ Arkvory отклоняет пакет, если: Модуль, который хранит собственные индексы, кеши или состояние, получает каталог на томе данных: `module-data//` в каталоге хранилища файлов `default`. Его часть `data` предназначена для резервного копирования, часть `cache` — нет. Arkvory учитывает каждую запись в утверждённом размере, в МиБ и в файлах, для обеих частей вместе. Запись сверх него отклоняется (`module_quota_exceeded`), а модуль продолжает работать. Без утверждённого размера модуль может только читать. Действует и [резерв тома](./storage#disk). На шлюзе чтения модуль читает те же файлы и не может их изменить. -При удалении модуля его каталог сохраняется. Удалите `module-data//` сами, когда данные больше не нужны. Резервные копии пока не включают каталоги модулей. +Логическая копия читает байты опубликованных объектов через установленный модуль в роли backup; она не копирует каталог модуля, кеши и внутреннее состояние координации как образ файловой системы. Сохраняйте модули источника установленными и доступными для чтения до завершения копирования. Восстановление с [--to-default-storage](backups#restore-default-storage) возвращает эти объекты как обычные blobs ядра без исходного модуля и платной лицензии; предусмотрите место под полный логический размер. Секреты установки сохраняйте отдельно; перед возобновлением платной записи выполните процедуру восстановления лицензии. Удаление модуля не удаляет каталог его данных; не удаляйте файлы, на которые ссылаются опубликованные объекты. Перед переходом на extension API 0.7.0 остановите все старые процессы API и worker, записывающие данные модулей. Новые писатели используют общий учёт квоты через PostgreSQL coordinator установки; временные файлы тоже входят в квоту. Смешанная запись старыми и новыми процессами не поддерживается. После сбоя Arkvory при необходимости перестраивает учёт и удаляет временные каталоги нового протокола только после получения блокировки прежнего владельца в БД. Старые временные файлы автоматически не удаляются и продолжают занимать квоту; разбирайте их отдельно при остановленных писателях. Процессы backup имеют только доступ на чтение. diff --git a/wiki/ru/reference/faq.md b/wiki/ru/reference/faq.md index bc89d78c..8da56aef 100644 --- a/wiki/ru/reference/faq.md +++ b/wiki/ru/reference/faq.md @@ -17,11 +17,11 @@ description: Короткие точные ответы на частые воп ### Обеспечивает ли Arkvory высокую доступность? {#high-availability} -Нет. Одна установка — это один сервер с одной базой данных PostgreSQL и локальным каталогом содержимого. Если сервер остановится, клиенты ждут, а затем возобновляют передачи; службы сами перезапускаются после сбоя или зависания. Для защиты от потери сервера используйте [резервные копии](../operate/backups). Для чтения со второй площадки используйте [зеркала](../operate/mirrors); переключение на зеркало выполняется вручную, а изменения, которые зеркало ещё не получило, теряются. +Да, в Linux-кластере одной площадки: ha-2 использует два сервера данных и отдельного свидетеля; ha-3 — три сервера данных. Нужны DRBD 9, Pacemaker и проверенный fencing. Обычно запись требует двух полных копий. Windows и Docker Compose остаются standalone. HA не заменяет резервные копии и не защищает от потери всей площадки; зеркала на второй площадке асинхронны и требуют ручного перехода. См. [Кластер](../operate/cluster), [Резервные копии](../operate/backups) и [Зеркала](../operate/mirrors). ### Работает ли Arkvory без интернета? {#offline} -Сервер работает без доступа в интернет. Установщик для Windows включает Node.js и PostgreSQL и устанавливает всё без сети. Пакеты для Linux включают Node.js, а PostgreSQL ставит менеджер пакетов. Скриптовые установщики и Docker скачивают файлы. Обновления можно устанавливать из локальной копии релиза. Если хаб обновлений недоступен, проверка обновлений завершается ошибкой, которую показывает консоль; больше ничего не затрагивается. См. [Выбор установки](../install/index) и [Обновления](../install/updates). +Бесплатное ядро работает без интернета. Установщик Windows включает Node.js и PostgreSQL; пакеты Linux включают Node.js и получают PostgreSQL через пакетный менеджер. Скриптовым установщикам и Docker могут потребоваться скачивания. Обновления можно ставить из локального релиза. При недоступности хаба поиск обновлений может перейти на GitHub; если недоступны оба, проверка завершается ошибкой, не останавливая хранилище. У платных модулей свой срок действия онлайн- или офлайн-лицензии: планируйте продление до истечения. См. [Установку](../install/index), [Обновления](../install/updates) и [Лицензии](../operate/licenses). ## Хранилище и база данных {#storage-and-database} @@ -51,7 +51,7 @@ PostgreSQL, по одной базе данных на установку. Ус ### Что Arkvory отправляет в ProAnimaStudio? {#hub-traffic} -Ваши файлы и данные остаются на вашем сервере. Сервер обращается к хабу ProAnimaStudio (`hub.proanima.net`), а когда хаб недоступен, — к GitHub по трём поводам: +Хранимое содержимое остаётся на вашем сервере. Установка обращается к хабу ProAnimaStudio (`hub.proanima.net`) для перечисленных ниже задач. GitHub служит резервным источником релизов, но не активации лицензий: - **Проверка обновлений.** Запрос содержит название проекта, операционную систему, архитектуру процессора, установленную версию и канал обновлений. Если статистика включена, в нём также есть случайный ID установки. - **Анонимная статистика.** Одно событие после каждого установленного обновления: ID установки, версия, система, архитектура и канал. Имена, адреса, содержимое и IP-адреса не сохраняются. Статистика включена по умолчанию; чтобы выключить её, снимите флажок [[ui:updateStatistics]] в разделе [[ui:updates]] или выполните `arkvory configure --statistics off`. Без статистики новая версия доходит до вас, только когда её выкатят всем. @@ -59,6 +59,8 @@ PostgreSQL, по одной базе данных на установку. Ус `arkvory configure --hub-off` прекращает обращения к хабу: релизы тогда берутся только с GitHub, а обратная связь выключается после перезапуска служб. Пустое значение `ARKVORY_HUB_URL` выключает только обратную связь. См. [лицензию](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md), раздел 7. +Активация и обновление лицензий платных модулей также обращаются к хабу: передаются идентификаторы лицензии и установки, версии модулей и учётные данные активации. Без активации лицензионных запросов нет. Отключение статистики не отключает лицензирование. При `--hub-off` онлайн-активация и продление недоступны: используйте [офлайн-процедуру](../operate/licenses#offline) и следите за сроком действия. Требование лицензии для платных функций сохраняется. + ### Выполняется ли резервное копирование само? {#automatic-backups} Нет, пока вы его не настроите. Подключите хранилище копий командой `arkvory configure --backup-vault <папка> --vault-key-file `, затем включите ежедневное расписание в [[ui:backupPlan]] в разделе [[ui:backups]]. План начинается в 02:00 UTC и хранит 7 ежедневных, 4 еженедельных и 6 ежемесячных точек восстановления. Пока расписание не включено, консоль показывает предупреждение о том, что ежедневное расписание выключено. См. [Резервные копии](../operate/backups). diff --git a/wiki/zh/operate/backups.md b/wiki/zh/operate/backups.md index 7ec324c5..f89b7f5c 100644 --- a/wiki/zh/operate/backups.md +++ b/wiki/zh/operate/backups.md @@ -434,3 +434,5 @@ arkvoryctl backup status --json || echo "backup problem" ## 无需原始存储即可恢复 {#restore-default-storage} 在恢复命令中添加 `--to-default-storage`，将所有对象恢复到默认存储，无需原始卷或模块。请为完整对象数据预留空间。不带 `--yes` 时，命令仅检查并报告计划。数据库和存储必须为空。此模式会清除放置规则，并将已发布内容恢复为普通 blob；请在恢复后配置新的放置规则。 + +逻辑备份通过已安装模块的 backup 角色读取已发布对象的字节；不会将模块目录、缓存和内部协调状态作为文件系统映像复制。复制完成前，请保持源模块已安装且可读取。[--to-default-storage](#restore-default-storage) 可在不使用原模块或付费许可证的情况下，将这些对象恢复为普通核心 blob；请预留完整逻辑大小的空间。安装秘密应单独保存，重新启用付费写入前请执行许可证恢复流程。 diff --git a/wiki/zh/operate/licenses.md b/wiki/zh/operate/licenses.md index c8d957ad..cc382e3c 100644 --- a/wiki/zh/operate/licenses.md +++ b/wiki/zh/operate/licenses.md @@ -5,7 +5,7 @@ description: 在线或离线激活付费模块的许可证，检查其状态， # 许可证 -Arkvory 的免费核心不需要许可证。本文档中的每项功能都无需许可证即可使用，任何许可证状态都不会关闭它们，也不会让数据无法读取。许可证用于启用 ProAnimaStudio 的付费模块（见[模块](modules)）。在您激活许可证之前，Arkvory 不会向任何地方发送任何与许可证有关的内容。 +免费的 Arkvory 核心无需付费模块许可证即可运行。许可证启用 ProAnimaStudio 的付费功能，包括 [Arkvory Pro](modules#pro)。过期不会导致已有 Pro 数据无法读取；付费功能不可用时，新上传使用核心存储和普通传输。在您激活许可证之前，Arkvory 不会发送任何许可证相关信息。 本页命令在安装所在的主机上运行：Linux 上以 root 身份，Windows 上以管理员身份。Docker Compose 安装不加载模块，因此会拒绝这些命令。 diff --git a/wiki/zh/operate/modules.md b/wiki/zh/operate/modules.md index b498bf98..c0eedc40 100644 --- a/wiki/zh/operate/modules.md +++ b/wiki/zh/operate/modules.md @@ -9,6 +9,24 @@ description: 在主机上安装、启用、检查和移除已签名的模块包 服务每次启动时都会重新检查并加载已安装的模块。模块只有在您启用后才会运行。 +## Arkvory Pro {#pro} + +Arkvory Pro 是用于免费 Arkvory 核心的可选付费模块集，由 ProAnimaStudio 签名。Pro 0.1.0 可配合 Arkvory 0.6.3 在 Windows/Linux x64 上使用。请向 ProAnimaStudio 获取模块包和许可证；模块与核心分别安装。参见[安装](#install)和[许可证](licenses)。 + +- **去重：**共享数据块只存储一次，并在多个对象间复用。共享目录协调垃圾回收与发布、读取和备份。 +- **增量传输：**复用兼容客户端已有的内容，只传输缺少的数据或补丁。模块集包含服务端存储和传输模块以及增量客户端模块。节省量取决于数据和客户端；普通 HTTP 下载不会自动变成增量传输。 +- **许可证：**控制付费写入和优化。许可证过期或不可用时，已有数据仍可读取；新上传回退到核心存储和普通传输。Pro 配额计算 Pro 数据的逻辑大小，包括已接受但尚未完成的上传，去重不会减少配额用量。updatesUntil 限制使用较新模块构建的权利。 + +模块在服务启动时加载；Docker Compose 安装不加载模块。升级前请备份元数据和模块数据。首次采用共享目录时，停止旧的 API/worker 写入进程；不支持新旧写入进程混用。恢复时保持数据与许可证状态配套，等待恢复完成，并验证一次新的 Pro 上传后再恢复正常写入。 + +大目录恢复可能较慢：验收环境中，共享目录已恢复的 400 万数据块在 32 分 43 秒后可写，无需重启。这不是恢复时限保证，也不是 4 TB 吞吐量测试。单台物理主机上的 HA 验收不能替代实际站点的 fencing 和故障域检查。Pro 不改变核心的许可条款。 + +## 模块能力与第三方插件 {#module-capabilities} + +ProAnimaStudio 签名模块可以增加存储、传输协议和 HTTP 路由，并按角色获得后台任务、受限计算和协调数据清理服务。免费模块不需要付费功能许可证；付费模块声明各自的许可要求。每个包必须兼容核心的 extension API，并通过签名和完整性检查。 + +此版本尚不支持安装和运行第三方插件。您可以维护[受信任的作者密钥](#trust)，但添加密钥不会启用插件安装。不要将模块接口视为任意代码的沙箱。 + ## 安装包 {#install} 1. 将包文件 `arkvory-module--.tgz` 复制到主机。 @@ -82,7 +100,7 @@ description: 在主机上安装、启用、检查和移除已签名的模块包 保存自有索引、缓存或状态的模块会在数据卷上获得一个目录：`default` 存储目录中的 `module-data//`。其中 `data` 部分用于备份，`cache` 部分则不用于备份。Arkvory 把每次写入都计入批准的大小，以 MiB 和文件数计算，两部分合计。超出该大小的写入会被拒绝（`module_quota_exceeded`），模块继续运行。没有批准的大小时，模块只能读取。[卷的预留空间](./storage#disk)同样适用。在读取网关上，模块读取相同的文件，但不能更改它们。 -移除模块时会保留其目录。不再需要这些数据时，请自行删除 `module-data//`。备份目前还不包含模块目录。 +逻辑备份通过已安装模块的 backup 角色读取已发布对象的字节；不会将模块目录、缓存和内部协调状态作为文件系统映像复制。复制完成前，请保持源模块已安装且可读取。[--to-default-storage](backups#restore-default-storage) 可在不使用原模块或付费许可证的情况下，将这些对象恢复为普通核心 blob；请预留完整逻辑大小的空间。安装秘密应单独保存，重新启用付费写入前请执行许可证恢复流程。 移除模块不会删除其数据目录；请勿删除已发布对象仍引用的文件。 升级到 extension API 0.7.0 前，请停止所有写入模块数据的旧版 API 和 worker 进程。新版写入进程通过安装实例的 PostgreSQL 协调器共享配额核算；临时文件也计入配额。不支持新旧进程混合写入。崩溃后，Arkvory 会按需重建核算，并且只有取得前任所有者的数据库锁后，才会回收新协议的临时目录。旧版临时文件不会自动删除，仍计入配额；请在停止写入进程后单独检查这些文件。backup 进程只有读取权限。 diff --git a/wiki/zh/reference/faq.md b/wiki/zh/reference/faq.md index 895655f5..ad049b8c 100644 --- a/wiki/zh/reference/faq.md +++ b/wiki/zh/reference/faq.md @@ -17,11 +17,11 @@ Arkvory 默认最多保留 10 TiB 的内容（`ARKVORY_CAPACITY_BYTES`），计 ### Arkvory 是高可用的吗？ {#high-availability} -不是。一个安装实例就是一台带一个 PostgreSQL 数据库和本地内容目录的服务器。如果服务器停止，客户端会等待，然后继续其传输；服务在崩溃或卡死后会自行重启。要防范服务器丢失，请使用[备份](../operate/backups)。要从第二个站点读取，请使用[镜像](../operate/mirrors)；切换到镜像是一个手动步骤，并且镜像尚未收到的更改会丢失。 +支持单站点 Linux 集群：ha-2 使用两个数据服务器和独立见证节点；ha-3 使用三个数据服务器。需要 DRBD 9、Pacemaker 和经过测试的 fencing。正常写入需要两份完整副本。Windows 和 Docker Compose 仍为 standalone。HA 不能替代备份，也不能防止整个站点丢失；第二站点镜像是异步的，需要手动切换。参见[集群](../operate/cluster)、[备份](../operate/backups)和[镜像](../operate/mirrors)。 ### 它可以离线工作吗？ {#offline} -服务器无需互联网访问即可工作。Windows 安装程序包含 Node.js 和 PostgreSQL，可离线安装。Linux 软件包包含 Node.js，包管理器会安装 PostgreSQL。脚本安装程序和 Docker 会下载文件。更新可以从发行版的本地副本安装。如果无法访问更新中心，更新检查会失败并在控制台中显示；其他任何内容都不受影响。参见[选择安装方式](../install/index)和[更新](../install/updates)。 +免费核心可以离线运行。Windows 安装程序包含 Node.js 和 PostgreSQL；Linux 包包含 Node.js，并通过包管理器获取 PostgreSQL。脚本安装程序和 Docker 可能需要下载。更新可使用本地发行版。中心不可达时，更新发现可回退到 GitHub；两者都不可达时，检查失败，但存储继续运行。付费模块的在线或离线许可证有单独有效期，请在过期前续期。参见[安装](../install/index)、[更新](../install/updates)和[许可证](../operate/licenses)。 ## 存储与数据库 {#storage-and-database} @@ -51,7 +51,7 @@ PostgreSQL，每个安装实例一个数据库。Windows 安装程序包含 Post ### Arkvory 会向 ProAnimaStudio 发送什么？ {#hub-traffic} -您的文件和数据保留在您的服务器上。服务器联系 ProAnimaStudio 中心（`hub.proanima.net`），并在无法访问中心时联系 GitHub，用于三件事： +存储的内容保留在您的服务器上。安装会为以下用途联系 ProAnimaStudio 中心（`hub.proanima.net`）。GitHub 是发行版发现的后备来源，不用于许可证激活： - **更新检查。** 请求携带项目名称、操作系统、处理器架构、已安装版本和更新渠道。开启统计后，它还会携带一个随机安装 ID。 - **匿名统计。** 每次安装更新后有一个事件，包含安装 ID、版本、系统、架构和渠道。不会存储名称、地址、内容或 IP 地址。统计默认开启；通过 [[ui:updates]] 中的 [[ui:updateStatistics]] 或 `arkvory configure --statistics off` 关闭它们。没有统计时，新版本只有在向所有人推出时才会到达您这里。 @@ -59,6 +59,8 @@ PostgreSQL，每个安装实例一个数据库。Windows 安装程序包含 Post `arkvory configure --hub-off` 会停止联系中心：此后发行版仅来自 GitHub，反馈会在服务重启后关闭。空的 `ARKVORY_HUB_URL` 会仅关闭反馈。参见[许可证](https://github.com/ProAnima/Arkvory/blob/main/LICENSE.md)第 7 节。 +付费模块的激活和续期也会联系中心，交换许可证和安装标识、模块版本及激活凭据。未激活时没有许可证流量。关闭统计不会关闭许可证功能。使用 `--hub-off` 后，在线激活和续期不可用：请使用[离线流程](../operate/licenses#offline)，并注意有效期。付费功能仍然需要许可证。 + ### 备份会自行运行吗？ {#automatic-backups} 在您设置之前不会。使用 `arkvory configure --backup-vault --vault-key-file ` 连接一个备份存储，然后在 [[ui:backups]] 中的 [[ui:backupPlan]] 开启每日计划。计划从 02:00 UTC 开始，保留 7 个每日、4 个每周和 6 个每月恢复点。在计划开启之前，控制台会显示每日计划已关闭的警告。参见[备份](../operate/backups)。