Назначение: Практическое руководство. Продукт: ShariX Open. Для кого: Оператор развёртывания, администратор. Темы: Эксплуатация: установка и диагностика.

Раздел: Эксплуатация ShariX Open.

Руководство автономно: для ShariX Open не требуются закрытая wiki или исходники другого продукта. Пример installation root — /opt/sharix-open-webapp-base; допустим другой доступный путь. Имена Unix-пользователей и systemd namespace берутся из конфигурации, не из hostname или названия каталога.

Сделать штатный backup БД, media и installation-local конфигурации. Зафиксировать root, ветки/SHA, actual SYSTEMD_SERVICE_NAME, bind/port и пользователей. Не переносить namespace/секреты другой установки. Прочитать diff/status всех owners. Обновлять известные исходники через Git; уже опубликованные изменения не применять вторым патчем. Патч новой разработки пользователь размещает в /tmp, проверяет git apply –check и применяет как владелец checkout; не продолжать после ошибки. При первом переходе env storage остановить main именно этой установки, исключив одновременное веб-сохранение. Соседние сайты не останавливать.

Под root, из фактического root:

cd /opt/sharix-open-webapp-base &&
./bin/configure_local_configs.sh --sync-install-cfg

Проверить conf-real/bin/install.cfg по справочнику настроек. Sync добавляет отсутствующие параметры, не затирает заданные локальные значения. На совсем новой установке первый запуск создаёт install.cfg и останавливается для его заполнения — это ожидаемо, не окончание установки.

cd /opt/sharix-open-webapp-base &&
./bin/install.sh bootstrap --strict --use-current-checkouts --permissions=repair

Явный repair нужен при принятии старого root-owned дерева/переезде или смене nginx-группы. Он может быть долгим: обходит существующие файлы, включая Git/venv. Обычные последующие проверки не повторяют этот обход. Если требуемых checkout ещё нет, не использовать –use-current-checkouts для их получения. Для nginx=1 возможен отдельный вопрос об установке пакета — см. nginx-руководство.

При отсутствии Git identity предлагаются значения из example: ShariX Developer и info@sharix-app.org. y — добавить только недостающие поля, e — свои, Enter/N — пропустить; non-interactive не предполагает согласия. Это author metadata, не пароль Git. Настроенные значения не заменяются, root credentials не копируются. После групп/ACL выполнить новый вход: su - sharix_open_deploy для example.

Применённую разработку сначала проверить и опубликовать во всех owning repositories. Нельзя отключать source-publication guard ради dirty/unpublished source.

cd /opt/sharix-open-webapp-base &&
./bin/install.sh deploy --strict --use-current-checkouts \
  --permissions=check --deps=auto --no-restart

–use-current-checkouts исключает clone/fetch/checkout/pull: он нужен после явно подготовленного Git-среза. Он НЕ исключает dependencies, LDAP, migrations, seed, collectstatic или запись конфигурации. –no-restart также не делает проход read-only и не означает безопасную онлайн-миграцию любой схемы. На вопрос о LDAP отвечать по реальной задаче. Отказ от sync не доказывает работоспособность XMPP-аккаунтов и не исправляется бессмысленным restart.

После успешной подготовки root:

cd /opt/sharix-open-webapp-base &&
./bin/install.sh activate --strict --use-current-checkouts --permissions=check

Activate сверяет настоящее runtime-чтение конфигов, source/Git context и запись нужных output/logs; проверка только от root/deploy этого не заменяет. Activate отдельно запускает или перечитывает включённый nginx после проверки синтаксиса и фактического include сайта. Основное приложение и handlers запускаются следующей фазой restart. Nginx=0 эту интеграцию не выполняет. Затем в новом deploy login:

cd /opt/sharix-open-webapp-base &&
./bin/install.sh restart

Запускаются main и настроенные handler modes своего namespace; отключённые не включать ради зелёного списка. При изменении каталога/units/grants снова нужен root activate. Deploy не получает произвольный root shell или общий sudo на installer/nginx/daemon-reload.

У подготовленной установки, под deploy:

cd /opt/sharix-open-webapp-base &&
./bin/install.sh deploy --strict --permissions=check --deps=auto

Без prepared flag скрипт пытается обновить Git штатно. При ручном подготовленном pull/релизном срезе добавить –use-current-checkouts осознанно. Root bootstrap не нужен на каждое обновление. Команда deploy может менять schema/data; для релизов сохраняется отдельный утверждённый backup/rehearsal/update contract.

После mv старый venv не считается переносимым. Проверка без установки: python3 bin/utils/venv_paths.py –project .. Не пересоздавать уже исправный venv повторно из-за старой ошибки валидатора. START/DONE/FAILED и периодический WAIT показывают фазу; WAIT не доказывает прогресс I/O. Не запускать второй installer и не удалять lock ради обхода активного процесса. Не включать общий shell xtrace.

Из deploy login, после успешного запуска:

./venv/bin/python manage.py check
./bin/check_acceptance.sh --with-runtime-audit

Проверить main journal, действительный listening port, HTML и CSS с DEBUG=False, реальный вход и нужный бизнес-сценарий, функциональную health обработчиков/XMPP. systemctl active не заменяет эту проверку. При отказе restart читать причину и повторять только ./bin/install.sh restart, не весь migrate/seed/pip цикл. См. диагностику, nginx/статику и перенос установки.

Для переноса /root → /opt с nginx использовать отдельную пошаговую процедуру: update до mv → остановка namespace → mv всего дерева → relocate preview/apply → bootstrap repair → deploy rebuild без restart → activate → restart. Нельзя сначала загрузить сломанные старые ссылки или исправлять их массовым sed.

При первом включении nginx меняется static group. Сообщение «run root bootstrap» означает полный вызов, под root:

cd /opt/sharix-open-webapp-base &&
./bin/install.sh bootstrap --strict --use-current-checkouts --permissions=repair &&
./bin/install.sh activate --strict --use-current-checkouts --permissions=check

Буквальных команд root bootstrap или bootstrap нет. В дальнейшем использовать check, без повторного полного repair. Deploy restart продолжать только после успешного системного этапа.

Регистрация и deploy preflight проверяют подробное sudo-правило для точной команды с явным target root и Options: !authenticate. Успех sudo -n -l показывает разрешение, но не доказывает NOPASSWD: просмотр списка имеет отдельную семантику listpw. Скрипт использует абсолютные пути из регистрации. Пример без выполнения команды, с собственным фактическим namespace:

# Заменить example.service сервисом своей установки.
LC_ALL=C /usr/bin/sudo -n -ll -u root -- /usr/bin/systemctl restart example.service

Неоднозначный ответ или отсутствие явного passwordless-правила останавливают preflight до restart; неудачная регистрация откатывает управляемое правило. Это не расширение sudo-доступа и не доказательство успешного запуска сервиса.

Отсутствующий и не включённый модуль получает NOT APPLICABLE. Включённый без исходников и отсутствующее ядро остаются ошибкой. Отключённые опциональные модули исключаются из проверок целиком: исходники, шаблоны, переводы, зависимости и runtime не проверяются и не исправляются. Проверяются активные владельцы и обязательное ядро. Смешанные guards сохраняют проверки ядра. Не устанавливать Appointments/Onboarding/Translations лишь ради зелёного теста. Состав берётся из canonical repository catalogue и local_apps resolver; дополнительный реестр состояния не создаётся. Подробности — root README.

Порядок сверён с опубликованным ShariX Open root 4e1fe4c: install.sh, relocate, nginx lifecycle, проверка sudo, сохранение install.cfg и config 84597d4. Проверены тела функций и порядок вызовов, а не только help или сообщения коммитов. Обычные команды не меняют release tags. Код реализован; результат конкретного хоста подтверждают отдельно по runtime, HTTP/XMPP и пользовательскому сценарию. Наличие source-check или status=review не является приёмкой произвольной установки или внешнего HTTPS.

Сверено 2026-10-27 по опубликованному ShariX Open root ec9bf2a и ShariX Open config 84597d4. Проверены исполняемые пути install.sh, install_roles.sh, install_permissions.py, deploy_control.sh, install_nginx.sh и env/state helpers; не только сообщения Git. Владелец подтвердил успешный запуск ShariX Open после исправлений. Установка nginx с новым вопросом и повторная независимая проверка Testopen ещё требуют отдельной host-приёмки. Это не объявление релиза и не подтверждение production. Редакционный status=review относится к статье, не к наличию реализации.

Отключённый опциональный модуль находится вне приёмки целиком. Не проверять, не компилировать и не исправлять его исходники, шаблоны, переводы, зависимости или runtime ради прохождения приёмки. Не устанавливать и не включать его для получения зелёного результата. Наличие checkout не делает модуль активным.

Активный состав определяется штатным resolver по конфигурации установки. Отключённая или неподключённая опциональная часть получает NOT APPLICABLE. Обязательное ядро, активные модули и ошибки определения состава остаются блокирующими; смешанный guard сохраняет обязательную часть, исключая отключённую опциональную.

Это действующее требование владельца и замена прежнего указания проверять исходники и переводы выключенного модуля. Оно не означает, что все подготовленные исправления приёмки уже применены на серверах. Результат конкретной установки подтверждается отдельно.

Перед запуском обновлённого корневого wrapper получить все shared-зависимости, от которых зависит его контракт вызова. Для текущей приёмки это dbsynce и design_template: одной передачи dbsynce недостаточно.

./bin/repositories.sh status --repo dbsynce --repo design_template
./bin/repositories.sh pull --shared --repo dbsynce --repo design_template
./venv/bin/python bin/checks/ui_reliability.py

Команды исходников выполнять от назначенного deploy login в каталоге своей установки, после проверки чистоты checkout и сохранения исходных SHA. При конфликте, ошибке pull или неподходящей configured branch остановиться; не делать reset и не переключать ветку вручную ради приёмки.

Корневой UI wrapper передаёт include_path для исключения отключённых модулей. Совместимый опубликованный design_template — 5687c82: ui_reliability_audit.py; main(argv) сохраняется, include_path добавлен как необязательный keyword argument. Старый audit вызывает TypeError. Не устранять ошибку удалением фильтра или повторным запуском без него: это возвращает проверку отключённых модулей.

При изменении результата resolver обязательно актуализировать все существующие тесты его контракта и после последней правки повторить полный затронутый набор. Для Translations различаются absent (не подключён), disabled (подключён, но выключен) и enabled; первые два состояния не читают исходники опционального модуля. Отсутствующие исходники или guards активного модуля остаются ошибкой.

Эта запись подтверждена опубликованным shared-кодом и изолированными fixture-проверками. Исправление двух ожиданий installer-теста подготовлено локально; полный набор из 54 тестов прошёл локально. Применение патча и полная приёмка конкретных серверов подтверждаются отдельно. Эта правка теста и инструмента приёмки не требует миграций или restart; изменение бизнес-кода проходит обычные фазы deploy/restart.