SHA256
104 lines
6.8 KiB
Markdown
104 lines
6.8 KiB
Markdown
# Test/devnet серверы SHiNE
|
||
|
||
Основной test/devnet стенд состоит из трёх независимых SHiNE-инстансов:
|
||
|
||
- `t1.shineup.me`
|
||
- `t2.shineup.me`
|
||
- `t3.shineup.me`
|
||
|
||
Отдельно работает общий тестовый сервер:
|
||
|
||
- `test.shineup.me` — бывший T4, с уже работающими тестовыми пользователями. Не очищать и не пересоздавать без отдельного подтверждения.
|
||
|
||
Это не production. Все deploy-цели задаются через домены.
|
||
|
||
Текущее фактическое состояние на `2026-07-28`:
|
||
|
||
- `t1`, `t2`, `t3` и `test.shineup.me` работают без `SQLite`;
|
||
- все четыре контура используют `PostgreSQL 18.4`;
|
||
- PostgreSQL на test-хосте общий для всех четырёх контуров и запущен в Docker-контейнере `shine-test-postgres`;
|
||
- все четыре контура используют один и тот же Helius devnet RPC/WS endpoint;
|
||
- во всех четырёх UI включён web push client-код и встроен один и тот же test `VAPID` public key.
|
||
|
||
## Общие параметры
|
||
|
||
- SSH: `player@tX.shineup.me`
|
||
- Solana cluster: `devnet`
|
||
- Solana RPC: `https://devnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY`
|
||
- Solana WS: `wss://devnet.helius-rpc.com/?api-key=YOUR_HELIUS_API_KEY`
|
||
- Приведённые Helius URLs предназначены **только для приватных серверных конфигов**. `YOUR_HELIUS_API_KEY` — плейсхолдер. Не передавайте такой URL напрямую в публичный UI: посетители увидят ключ.
|
||
- Caddy config: `/etc/caddy/Caddyfile`
|
||
- На t2 маршрут `GET /api/files/user-server` направлен в Jetty `127.0.0.1:7102`
|
||
перед SPA fallback; `/dm-files/*` также направлен в Jetty для legacy DM.
|
||
Проверка: HTTP-ответ на неизвестный login — JSON с кодом 404, не HTML с кодом 200.
|
||
- Для новых R2-вложений отдельно требуются публичные DNS/Cloudflare custom domains
|
||
`files.t2.shineup.me` и `dm-files.t2.shineup.me`. На 17.11.2026 они не
|
||
разрешаются в DNS, поэтому скачивание новых вложений остаётся недоступным
|
||
до настройки этих доменов у владельца зоны и корзин R2.
|
||
- Общий PostgreSQL container: `shine-test-postgres`
|
||
- PostgreSQL image: `postgres:18`
|
||
- PostgreSQL engine version на `2026-07-28`: `18.4`
|
||
- Web push в UI: общий test `VAPID` public key `BOdoWZndZRaNe9kyUFsJ5-xEfFABXNKennAKg15Z7ycAwUIQ7yDV_sIWWYJCwJriN4g9oU-CyJPrn1U6lfxuDbI`
|
||
|
||
## Инстансы
|
||
|
||
| Домен | Логин сервера | Сервер | UI | Порт | systemd | PostgreSQL DB | PostgreSQL user |
|
||
|---|---|---|---|---|---|---|---|
|
||
| `t1.shineup.me` | `server_t1` | `/home/player/t1/server` | `/home/player/t1/UI` | `7101` | `shine-t1.service` | `shine_t1_db` | `shine_t1` |
|
||
| `t2.shineup.me` | `server_t2` | `/home/player/t2/server` | `/home/player/t2/UI` | `7102` | `shine-t2.service` | `shine_t2_db` | `shine_t2` |
|
||
| `t3.shineup.me` | `server_t3` | `/home/player/t3/server` | `/home/player/t3/UI` | `7103` | `shine-t3.service` | `shine_t3_db` | `shine_t3` |
|
||
| `test.shineup.me` | `test_server@shine` | `/home/player/t4/server` | `/home/player/t4/UI` | `7104` | `shine-test.service` | `shine_test_db` | `shine_t2` |
|
||
|
||
## Deploy
|
||
|
||
Для UI-деплоя установите `DEPLOY_SOLANA_ENDPOINT` **явно**. Скрипты теперь не содержат API-ключей и завершаются ошибкой, если endpoint не указан.
|
||
|
||
Рекомендуется использовать собственный RPC gateway, например `/solana-rpc` на домене соответствующего стенда (после настройки Caddy по `deploy/SOLANA_RPC_GATEWAY_CADDY_SNIPPET.md`). Так ключ Helius остаётся на сервере и не попадает в клиентский JavaScript. Если gateway не настроен, можно временно использовать публичный Solana devnet RPC с ограничениями по нагрузке.
|
||
|
||
Пример (только при настроенном `/solana-rpc`):
|
||
|
||
```bash
|
||
DEPLOY_SOLANA_ENDPOINT="https://t1.shineup.me/solana-rpc" bash deploy/scripts/test_t1_ui.sh
|
||
```
|
||
|
||
Для остальных стендов замените `t1` на `t2` или `t3`. Для общего тестового сервера используйте `test.shineup.me`; не выполняйте на нём очистку или пересоздание. Не вставляйте URL с личным ключом Helius в `DEPLOY_SOLANA_ENDPOINT`: значение будет опубликовано в `shine-UI/js/deploy-config.js` на сайте.
|
||
|
||
```bash
|
||
bash deploy/scripts/test_t1_server.sh
|
||
DEPLOY_SOLANA_ENDPOINT="https://t1.shineup.me/solana-rpc" bash deploy/scripts/test_t1_ui.sh
|
||
|
||
bash deploy/scripts/test_t2_server.sh
|
||
DEPLOY_SOLANA_ENDPOINT="https://t2.shineup.me/solana-rpc" bash deploy/scripts/test_t2_ui.sh
|
||
|
||
bash deploy/scripts/test_t3_server.sh
|
||
DEPLOY_SOLANA_ENDPOINT="https://t3.shineup.me/solana-rpc" bash deploy/scripts/test_t3_ui.sh
|
||
|
||
DEPLOY_SOLANA_ENDPOINT="https://test.shineup.me/solana-rpc" bash deploy/scripts/deploy_ui.sh
|
||
```
|
||
|
||
## Проверка
|
||
|
||
```bash
|
||
curl -I https://t1.shineup.me
|
||
curl -I https://t2.shineup.me
|
||
curl -I https://t3.shineup.me
|
||
curl -I https://test.shineup.me
|
||
```
|
||
|
||
На сервере:
|
||
|
||
```bash
|
||
sudo systemctl --no-pager --full status caddy shine-t1 shine-t2 shine-t3 shine-test
|
||
sudo docker ps --format 'table {{.Names}}\t{{.Image}}\t{{.Status}}'
|
||
```
|
||
|
||
## Operational-нюанс
|
||
|
||
Общий Helius devnet endpoint тоже может начать ограничивать запросы, если несколько инстансов одновременно делают тяжёлый bootstrap. Если после деплоя какой-то инстанс завис на bootstrap Arweave/Solana sync, рестартовать сервисы по одному с паузой.
|
||
|
||
Отдельный нюанс по web push:
|
||
|
||
- у `t1`, `t2`, `t3` и `test.shineup.me` в UI уже есть одинаковый встроенный `VAPID` public key;
|
||
- то есть `t3` и `test.shineup.me` используют тот же web push клиентский код, что и `t1` / `t2`;
|
||
- если позже понадобится разделить push-ключи по тестовым контурам, это нужно делать отдельным UI deploy с новым `DEPLOY_WEBPUSH_VAPID_PUBLIC`.
|