Навести порядок в 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,57 @@
+# AGENTS для deploy
+
+## Главное
+
+- Все вопросы деплоя SHiNE решать через эту папку `deploy/`.
+- Скрипты лежат в `deploy/scripts/`.
+- Production-серверы: `shineup.me` и `server2.shineup.me`.
+- Test/devnet серверы: `t1.shineup.me`, `t2.shineup.me`, `t3.shineup.me`, `t4.shineup.me`.
+- TURN-серверы: `turn1.shineup.me`, `turn2.shineup.me`, `turn3.shineup.me`.
+- В deploy-документах и скриптах использовать домены, а не IP.
+
+## Production safety
+
+- Любой deploy на `shineup.me` или `server2.shineup.me` выполнять только после отдельного явного подтверждения пользователя.
+- Перед production deploy обязательно проверить, что свежий бэкап лежит в `deploy/backup/archive/`.
+- Production wrappers требуют наличие `deploy/backup/archive/<date>/MANIFEST.txt`.
+- Секреты, `.env`, JWK, TURN shared secrets и приватные ключи не коммитить.
+
+## Как деплоить
+
+Сервер:
+
+```bash
+bash deploy/scripts/<target>_server.sh
+```
+
+UI:
+
+```bash
+bash deploy/scripts/<target>_ui.sh
+```
+
+Для настоящего `t2.shineup.me` использовать:
+
+```bash
+bash deploy/scripts/test_t2_server.sh
+bash deploy/scripts/test_t2_ui.sh
+```
+
+Не путать `server2.shineup.me` и `t2.shineup.me`.
+
+## Документы
+
+- `README.md` — карта deploy-папки.
+- `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` — сервер + Caddy + UI с нуля.
+- `SETUP_TURN_SERVER.md` — TURN с нуля.
+- `backup/README.md` — backup.
+
+## Gradle
+
+- Gradle deploy-задачи удалены.
+- Для сборки jar общий server deploy script вызывает `./gradlew shadowJar`.
+- Для локального запуска можно использовать `./gradlew startLocal`.