Навести порядок в deploy и документации проекта

2026-07-20 17:28:35 +04:00
parent fa1f7358b7
commit d2f65b169c
99 changed files with 1035 additions and 1708 deletions
@@ -0,0 +1,78 @@
+# Deploy SHiNE
+
+Эта папка — единая точка входа по деплою SHiNE.
+
+## Правило
+
+- Все deploy-документы, deploy-скрипты и backup-инструкции держать здесь.
+- Deploy-привязки задавать через домены, а не через IP.
+- Production-серверы менять только после отдельного явного подтверждения пользователя.
+- Production deploy выполнять только после обновления локального бэкапа в `deploy/backup/archive/`.
+
+## Контуры
+
+- Основной production: `shineup.me`.
+- Второй production: `server2.shineup.me`.
+- Test/devnet стенд: `t1.shineup.me`, `t2.shineup.me`, `t3.shineup.me`, `t4.shineup.me`.
+
+## Основные документы
+
+- `PRODUCTION_SERVERS.md` — production-контуры.
+- `TEST_SERVERS.md` — test/devnet-контуры.
+- `TURN_SERVERS.md` — TURN-серверы.
+- `CONFIGURE_TURN_IN_SHINE.md` — как подключить TURN к SHiNE backend.
+- `SETUP_SERVER_FROM_ZERO.md` — настройка SHiNE-сервера и UI с нуля.
+- `SETUP_TURN_SERVER.md` — настройка TURN через Caddy/DNS/TLS.
+- `AGENT_BOT_CODER_LOCAL_SYSTEMD.md` — локальный systemd-deploy Telegram-бота агента-кодера.
+- `AGENTS.md` — правила для агента при деплое.
+
+## Скрипты
+
+Общие скрипты:
+
+- `scripts/deploy_server.sh` — обновить существующий серверный jar и перезапустить systemd service.
+- `scripts/deploy_ui.sh` — обновить существующий UI, проверить Caddy root и подставить `deploy-config.js`.
+
+Production wrappers:
+
+- `scripts/production_shineupme_server.sh`
+- `scripts/production_shineupme_ui.sh`
+- `scripts/production_server2_server.sh`
+- `scripts/production_server2_ui.sh`
+
+Test/devnet wrappers:
+
+- `scripts/test_t1_server.sh`
+- `scripts/test_t1_ui.sh`
+- `scripts/test_t2_server.sh`
+- `scripts/test_t2_ui.sh`
+- `scripts/test_t3_server.sh`
+- `scripts/test_t3_ui.sh`
+- `scripts/test_t4_server.sh`
+- `scripts/test_t4_ui.sh`
+
+## Примеры
+
+UI на настоящий тестовый `t2.shineup.me`:
+
+```bash
+bash deploy/scripts/test_t2_ui.sh
+```
+
+Сервер на настоящий тестовый `t2.shineup.me`:
+
+```bash
+bash deploy/scripts/test_t2_server.sh
+```
+
+Production UI на `server2.shineup.me`:
+
+```bash
+bash deploy/scripts/production_server2_ui.sh
+```
+
+Production server на `shineup.me`:
+
+```bash
+bash deploy/scripts/production_shineupme_server.sh
+```