Aidar/SHiNE-server
SHA256
2
0
Fork 0
Code Issues Pull Requests 1 Actions Packages Projects Releases Wiki Activity

Исправить устойчивость UI-деплоя и проверку Caddy

Browse Source
This commit is contained in:
AidarKC 2026-05-19 21:50:05 +03:00
parent f3262c2d64
commit 62b8534769
3 changed files with 36 additions and 6 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

17
Dev_Docs/deploy/README.md
View File

@ -14,6 +14,23 @@
- Деплой UI: `./gradlew deployUI` - Деплой UI: `./gradlew deployUI`
- Локальный запуск: `./gradlew startLocal` - Локальный запуск: `./gradlew startLocal`
## UI-деплой и Caddy (обязательно)
- Целевая директория UI-деплоя: `/home/player/SHiNE/SHiNE-UI`.
- `Caddyfile` на сервере должен смотреть в ту же директорию через `root * /home/player/SHiNE/SHiNE-UI`.
- В `deploy_shine-PWA.sh` добавлена проверка: если `root` в `Caddyfile` не совпадает, деплой прерывается с ошибкой.
- Для ручного обхода проверки (только осознанно): `ALLOW_CADDY_MISMATCH=1 ./gradlew deployUI`.
- При необходимости можно явно переопределить путь деплоя:
- `REMOTE_UI_DIR=/нужный/путь ./gradlew deployUI`
- `EXPECTED_CADDY_UI_ROOT=/нужный/путь ./gradlew deployUI`
### Важно для локального UI (history-router / Ctrl+F5)
- Локальный UI **обязательно** поднимать только через `./gradlew startLocal`.
- Эта задача запускает `scripts/local_spa_server.py`, который делает SPA fallback: любой неизвестный путь (`/m/...`, `/channel/...`) возвращает `index.html`.
- Это обязательно для корректной работы `Ctrl+F5` на внутренних роутов без `404`.
- Рабочий URL выводится задачей в консоль в формате: `http://localhost:<WEB_PORT>/?localWsPort=<WS_PORT>`.
## Обязательные правила ## Обязательные правила
1. Перед серверным деплоем проверить локально. 1. Перед серверным деплоем проверить локально.

4
VERSION.properties
View File

@ -1,2 +1,2 @@
client.version=1.2.75 client.version=1.2.76
server.version=1.2.69 server.version=1.2.70

21
deploy_shine-PWA.sh
View File

@ -3,7 +3,9 @@ set -euo pipefail
SRC_DIR="shine-UI" SRC_DIR="shine-UI"
REMOTE_HOST="${REMOTE_HOST:-player@93.170.12.154}" REMOTE_HOST="${REMOTE_HOST:-player@93.170.12.154}"
REMOTE_BASE_DIR="${REMOTE_BASE_DIR:-/home/player/SHiNE}" REMOTE_UI_DIR="${REMOTE_UI_DIR:-/home/player/SHiNE/SHiNE-UI}"
EXPECTED_CADDY_UI_ROOT="${EXPECTED_CADDY_UI_ROOT:-/home/player/SHiNE/SHiNE-UI}"
ALLOW_CADDY_MISMATCH="${ALLOW_CADDY_MISMATCH:-0}"
BUILD_VERSION="$(date -u +%Y%m%d%H%M%S)" BUILD_VERSION="$(date -u +%Y%m%d%H%M%S)"
VERSION_FILE="VERSION.properties" VERSION_FILE="VERSION.properties"
export BUILD_VERSION export BUILD_VERSION
@ -21,9 +23,8 @@ if [[ -z "$CLIENT_VERSION" ]]; then
fi fi
export CLIENT_VERSION export CLIENT_VERSION
TARGET_DIR="SHiNE-UI"
TARGET_URL="https://shineup.me" TARGET_URL="https://shineup.me"
REMOTE_DIR="${REMOTE_BASE_DIR}/${TARGET_DIR}" REMOTE_DIR="${REMOTE_UI_DIR}"
cleanup() { cleanup() {
rm -rf "$TMP_DIR" rm -rf "$TMP_DIR"
@ -37,7 +38,7 @@ fi
echo "==> Preparing staged UI copy with build version: $BUILD_VERSION" echo "==> Preparing staged UI copy with build version: $BUILD_VERSION"
echo "==> Client version from $VERSION_FILE: $CLIENT_VERSION" echo "==> Client version from $VERSION_FILE: $CLIENT_VERSION"
echo "==> Deploy target: $TARGET_URL ($TARGET_DIR)" echo "==> Deploy target: $TARGET_URL ($REMOTE_DIR)"
rsync -a "$SRC_DIR"/ "$TMP_DIR"/ rsync -a "$SRC_DIR"/ "$TMP_DIR"/
INDEX_FILE="$TMP_DIR/index.html" INDEX_FILE="$TMP_DIR/index.html"
@ -52,6 +53,18 @@ perl -0pi -e 's/window\.__SHINE_CLIENT_VERSION__\s*=\s*'\''[^'\'']*'\'';/window.
echo "==> Checking SSH connectivity to $REMOTE_HOST" echo "==> Checking SSH connectivity to $REMOTE_HOST"
ssh -o BatchMode=yes -o ConnectTimeout=10 "$REMOTE_HOST" "echo SSH OK" >/dev/null ssh -o BatchMode=yes -o ConnectTimeout=10 "$REMOTE_HOST" "echo SSH OK" >/dev/null
echo "==> Validating Caddy UI root"
CADDY_ROOT_LINE="$(ssh "$REMOTE_HOST" "sudo grep -n 'root \\* ' /etc/caddy/Caddyfile | head -n 1 || true")"
if [[ -n "$CADDY_ROOT_LINE" && "$CADDY_ROOT_LINE" != *"$EXPECTED_CADDY_UI_ROOT"* ]]; then
echo "ERROR: Caddy root mismatch. Found: $CADDY_ROOT_LINE" >&2
echo "Expected path fragment: $EXPECTED_CADDY_UI_ROOT" >&2
if [[ "$ALLOW_CADDY_MISMATCH" != "1" ]]; then
echo "Set ALLOW_CADDY_MISMATCH=1 to bypass this check." >&2
exit 1
fi
echo "WARN: proceeding due to ALLOW_CADDY_MISMATCH=1"
fi
echo "==> Preparing remote directory: $REMOTE_DIR" echo "==> Preparing remote directory: $REMOTE_DIR"
ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_DIR'" ssh "$REMOTE_HOST" "mkdir -p '$REMOTE_DIR'"