Files
SHiNE-server/deploy/DEPLOY_SERVER_INSTRUCTIONS.md
T

69 lines
3.3 KiB
Markdown

# Инструкция по деплою SHiNE на сервер
## Целевые контуры
Production:
- `shineup.me` — основной production;
- `server2.shineup.me` — второй production.
Тестовые/devnet-серверы:
- `t1.shineup.me`;
- `t2.shineup.me`;
- `t3.shineup.me`;
- `test.shineup.me` — общий рабочий тестовый сервер с тестовыми пользователями; не очищать и не пересоздавать без отдельного подтверждения.
В документации и скриптах использовать домены, а не IP. SSH-пользователь — `player`.
## Безопасность
- Production-деплой на `shineup.me` или `server2.shineup.me` выполнять только после отдельного подтверждения.
- Перед production-деплоем проверить свежий backup в `deploy/backup/archive/<date>/MANIFEST.txt`.
- Не коммитить секреты, `.env`, JWK, TURN shared secrets, приватные ключи и локальные конфиги.
- Если пользователь просит «задеплой» без указания контура, сначала уточнить: production или test.
## Команды
Все команды выполнять из корня `SHiNE-product/`.
Production:
```bash
bash deploy/scripts/production_shineupme_server.sh
bash deploy/scripts/production_shineupme_ui.sh
bash deploy/scripts/production_server2_server.sh
bash deploy/scripts/production_server2_ui.sh
```
Тестовые серверы:
```bash
bash deploy/scripts/test_t1_server.sh
bash deploy/scripts/test_t1_ui.sh
bash deploy/scripts/test_t2_server.sh
bash deploy/scripts/test_t2_ui.sh
bash deploy/scripts/test_t3_server.sh
bash deploy/scripts/test_t3_ui.sh
```
Не путать `server2.shineup.me` и `t2.shineup.me`.
Скрипт сервера собирает jar через `./gradlew shadowJar`, копирует jar и список email-доменов через `rsync`, обновляет systemd unit и перезапускает сервис. Для локальной проверки использовать `./gradlew startLocal` или `./gradlew startLocalWithBuild`.
Не использовать удалённые Gradle deploy-задачи: штатный путь — скрипты из `deploy/scripts/`.
## Настройки серверов
| Контур | SSH | Каталог сервера | Сервис | Порт |
|---|---|---|---|---:|
| `shineup.me` | `player@shineup.me` | `/home/player/SHiNE/shine-server` | `shine-server` | 7070 |
| `server2.shineup.me` | `player@server2.shineup.me` | `/home/player/SHiNE/shine-server` | `shine-server` | 7070 |
| `t1.shineup.me` | `player@t1.shineup.me` | `/home/player/t1/server` | `shine-t1` | 7101 |
| `t2.shineup.me` | `player@t2.shineup.me` | `/home/player/t2/server` | `shine-t2` | 7102 |
| `t3.shineup.me` | `player@t3.shineup.me` | `/home/player/t3/server` | `shine-t3` | 7103 |
| `test.shineup.me` | `player@t4.shineup.me` | `/home/player/t4/server` | `shine-test` | 7104 |
Источники истины для деталей и backup: `deploy/AGENTS.md`, `deploy/README.md`, `deploy/backup/README.md` и сами скрипты `deploy/scripts/`.