SHiNE-server/deploy/AGENTS.md

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 deploy/scripts/<target>_server.sh

UI:

bash deploy/scripts/<target>_ui.sh

Для настоящего t2.shineup.me использовать:

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.