Skip to content
Alex Miarsky edited this page Nov 10, 2026 · 1 revision

Perforce-like проекты: установка и приёмка

Новый режим принадлежит отдельному проекту file_project. Сервер одновременно обслуживает Classic и файловые проекты. ТХ — рабочий клиент, ТС — просмотр и администрирование. Шаблон perforce_like встроен в wheel сервера: отдельный дамп БД не нужен. Смена типа существующего Classic-проекта не является установкой.

Установка

  1. Перед обновлением сохраните согласованную резервную копию системной БД, всех проектных БД, конфигурации и приватного файлового хранилища. Установите Python 3.14 и wheel сервера: python -m pip install "./tactic_stream-VERSION-py3-none-any.whl[postgres]" для PostgreSQL; для SQLite уберите [postgres]. Новая установка: python -m tactic_stream --data-dir PATH init, пароль администратора вводится интерактивно. Обновление существующей: python -m tactic_stream --data-dir PATH upgrade с её собственным конфигом.

  2. В Configuration ТС включите files, сохранив остальные службы: services/enable=tactic|queue|files. После Save явно остановите и запустите сервер в согласованное окно обслуживания. Save не перезапускает сервер. Проверьте реально работающий процесс files в monitor status: значение в XML само по себе не подтверждает исправность воркера. Он проверяет uploads, собирает draft и выполняет retention/GC.

  3. Создайте новый проект через мастер, выбрав Perforce-like file project. Эквивалент через штатный API для авторизованного администратора с текущим проектом admin:

    server.execute_cmd('tactic.command.ProjectTemplateInstallerCmd', {
        'template_code': 'perforce_like', 'project_code': 'files_demo',
        'project_title': 'Files Demo',
    })

    Используются штатные Command/CreateProjectCmd и установка схемы. Существующий код проекта не перезаписывается: повторное создание выдаёт ошибку.

  4. В Workspace actions создайте depot, основной stream и workspace. Привяжите depot к существующему доступному для записи repository alias. Приватные blobs располагаются в соседней папке NAME.file-projects, вне публичного asset alias; depot без привязки использует DATA/file-projects. Выдайте сервисной учётной записи права на папки. Одной резервной копии БД недостаточно для восстановления содержимого файлов.

  5. Настройте штатные права project/search-type и file_depot view/edit для нужных проектов и depot. Проверьте обычного пользователя: read-only не может писать, чужие pending changelists/tasks не становятся редактируемыми. Воркер повторно проверяет права владельца и не публикует его данные от имени admin.

  6. Распакуйте исходный runtime ТХ в новую папку, установите закреплённые зависимости из requirements.txt, запустите launch.py/launch.pyw. Используйте существующий экран подключения и собственный preset: тикеты и settings не входят в поставку. Выберите новый проект, workspace и локальную папку; задайте mappings и исключения. Для независимых клиентов создавайте отдельные workspace. Classic-проект сохраняет свой Classic Commit Queue.

  7. В Storage administration задайте квоты, параллельность и retention перед большим прогоном. По умолчанию квоты не ограничены, параллельность передачи — 4, срок заброшенных uploads/tasks — 7 дней, reverted — 30 дней, shelves и опубликованная история хранятся постоянно. Начните с GC dry-run. GC сохраняет историю, shelves, Have и активные задачи; blobs вручную не удаляйте.

Apache должен проксировать /file-project/, сохранять Range и разрешать потоковые тела минимум 64 МиБ. Метаданные ограничены 1000 записями/3 МиБ на запрос, блоки и архивы — 64 МиБ. Для общей установки используйте PostgreSQL; SQLite последовательно обрабатывает записи. Защита квот, ссылок и GC также использует блокировку политики хранилища проекта: параллельная передача байтов не означает параллельный submit. При конкуренции до получения блокировки политики сервер возвращает обозначенный HTTP 503; SDK ограниченно повторяет тот же запрос метаданных с паузами. Воркер сохраняет queued/running задачу при временной конкуренции. Произвольные 503, ошибки триггеров, SHA или прав автоматически не повторяются.

Работа и восстановление

Сценарий Ожидаемое поведение
Reconcile Явное сканирование показывает новые, изменённые и отсутствующие файлы относительно Have и сервера. SHA считается вне UI-потока.
Checkout Обычный допускает нескольких владельцев; эксклюзивный запрещает другого владельца. Локальные файлы не перезаписываются.
Upload Видны общий счётчик файлов/байтов и текущий путь. Upload готовит draft; Submit публикует весь changelist отдельно.
Shelve/unshelve Shelf сохраняет неизменяемые байты и версии. Unshelve запускает пакетную интеграцию; конфликты разрешаются до Submit.
Ошибка submit Права, триггеры и откат всего changelist сохранены. Части не публикуются. При потерянном ответе сначала проверьте серверное состояние.
Get latest Закреплённый manifest → проверка SHA → сохранение локальных файлов → подтверждение Have. Изменённые/неотслеживаемые файлы защищены без явного force.
Stop waiting Останавливает работу клиента, сохраняя серверную задачу, журнал и частичные байты для Resume. Это отдельное действие от отмены серверной задачи.
Cancel task Отменяет staging и восстанавливает исходный pending draft. Опубликованные данные сохраняются. Большая интеграция отменяется несколькими чанками.
Потеря соединения При необходимости войдите снова; сохраните workspace root и журнал upload, затем Resume. Потерянный ответ не требует новой задачи.
Рестарт воркера/сервера Сохранённые задачи обнаруживаются заново. Повтор offset/manifest/seal/submit/Have не создаёт лишних версий.
Изменился локальный источник Resume отвергает новый fingerprint. Отмените прежнюю задачу и начните новую передачу.
Ошибка квоты/SHA/прав Показывается серверная ошибка, публикации нет. Исправьте причину, проверьте draft/task и явно повторите или отмените.

Журналы upload лежат вне workspace. Для докачки сохраняйте их и временные .tactic-BLOB.part. При выключенном files новый upload отказывает до выделения серверной задачи; завершённую передачу всё ещё можно проверить/повторить. После включения службы требуется явный рестарт. Временная неисправность включённого воркера диагностируется через monitor и прогресс задачи, восстановление сохраняется.

Проверки и границы готовности

Архивный upload читает до 1000 blob одним штатным Search-запросом. Блокировки хранилища и changelist защищают от параллельных transfer и legacy upload. У каждого файла сохраняются native-права редактирования, проверка SHA и триггеры сохранения. Ошибка откатывает метаданные и новые байты всего пакета. Помеченную конкуренцию серверной блокировки повторяем до 120 секунд на команду или блок, с отображением ожидания и возможностью остановить его. Освобождение lease при сбое upload тоже повторяет помеченную конкуренцию; при потере воркера или сети остаётся восстановление по истечению lease. Ошибки прав, SHA и триггеров сохраняют отказ и откат.

tools/file_project_checks.py проверяет SQLite; --postgres создаёт и удаляет собственный PostgreSQL-контейнер. tests/test_file_workspace_ui.py выполняет сценарии в настоящем Edge, tests/test_handler_file_workspace_ui.py — в offscreen Qt. test_monitor.Runtime.test_owned_file_worker_restart_and_real_transfer проверяет настоящий рестарт и остановку собственных процессов. Benchmark tools/file_transfer_benchmark.py использует новые случайные байты и проверяет HTTP upload/submit/download/Have. tools/file_project_scale.py проверяет записи каталога, версий и Have; это не передача миллиона физических файлов.

В поставке verification/ содержит переносимые проверки native API, передач и monitor. После установки wheel: python verification/tools/file_project_checks.py; --postgres использует отдельный Docker-контейнер. Для проверки воркера задайте PYTHONPATH=verification/tests и выполните python -m unittest test_monitor.Runtime.test_claimed_upload_recovers_after_file_worker_process_death. Инъекция сбоя оставляет сохранённый lease на 60 секунд: восстановление ограничено его сроком и не является мгновенным. Контрольные суммы файлов — в manifest.json; протокол автоматических проверок не заменяет ручную приёмку.

На проверенных Python 3.14/PySide6 6.11.1 и 6.11.2 диагностика ResourceWarning воспроизводит оставшийся Property при завершении интерпретатора даже с одним свойством обычного QObject, без приложения/сети/потоков. Предупреждение не скрыто и не считается успешной приёмкой освобождения ресурсов. Фикстуры при этом останавливают собственные воркеры и удаляют свои окна.

Поставка содержит wheel сервера, исходный ТХ и протокол проверок. Это не Windows EXE/Electron и не подтверждение production-приёмки. Физический миллион файлов/терабайты, целевые сеть и диски, чистая целевая Windows и полная ручная приёмка ТХ требуют отдельного прогона. Существующие release gates сохраняются; offscreen и тест метаданных не заменяют эти проверки.

Clone this wiki locally