135 lines
3.3 KiB
Markdown
135 lines
3.3 KiB
Markdown
# Развёртывание Flamy Trade
|
||
|
||
Документ описывает production-развёртывание сайта `trade.flamy.studio` без ML-runtime и без будущего API. Эти части подключаются отдельно.
|
||
|
||
## Схема
|
||
|
||
```text
|
||
Internet
|
||
-> Router :80/:443
|
||
-> edge-proxy VM / Caddy
|
||
-> 10.20.0.20:18082
|
||
-> flamy_trade_nginx
|
||
-> flamy_trade_app:3000
|
||
```
|
||
|
||
На VM публикуется только nginx. Node-приложение доступно только во внутренней Docker-сети.
|
||
|
||
## Переменные
|
||
|
||
Скопируйте `.env.example` в `.env` на сервере и проверьте значения:
|
||
|
||
```bash
|
||
PUBLIC_SITE_URL=https://trade.flamy.studio
|
||
PUBLIC_SITE_NAME=Flamy Trade
|
||
PUBLIC_SITE_DESCRIPTION=Публичная витрина ML-прогнозов для крипторынка.
|
||
|
||
HOST=0.0.0.0
|
||
PORT=3000
|
||
ORIGIN=https://trade.flamy.studio
|
||
BODY_SIZE_LIMIT=1M
|
||
SHUTDOWN_TIMEOUT=15
|
||
|
||
APP_HOST_IP=10.20.0.20
|
||
APP_PUBLISHED_PORT=18082
|
||
APP_IMAGE_TAG=<git-sha>
|
||
```
|
||
|
||
Перед фиксацией порта проверьте, что `18082` свободен:
|
||
|
||
```bash
|
||
sudo ss -lntup | grep ':18082'
|
||
docker ps --format 'table {{.Names}}\t{{.Ports}}'
|
||
```
|
||
|
||
## Сборка
|
||
|
||
```bash
|
||
pnpm install --frozen-lockfile
|
||
pnpm format:check
|
||
pnpm lint
|
||
pnpm check
|
||
pnpm build
|
||
pnpm audit
|
||
```
|
||
|
||
`pnpm outdated` должен проверяться вручную. На текущем стеке допустимы только осознанные удержания: `@types/node` на ветке 24 под Node 24 LTS и TypeScript 6.x до обновления peer constraints в SvelteKit/typescript-eslint.
|
||
|
||
Docker:
|
||
|
||
```bash
|
||
docker compose config
|
||
docker compose build --pull
|
||
docker compose up -d --wait
|
||
docker compose ps
|
||
docker compose logs --tail=200
|
||
```
|
||
|
||
## Caddy
|
||
|
||
Блок для edge-proxy:
|
||
|
||
```caddyfile
|
||
trade.flamy.studio {
|
||
encode zstd gzip
|
||
|
||
reverse_proxy 10.20.0.20:18082 {
|
||
header_up Host {host}
|
||
header_up X-Real-IP {remote_host}
|
||
}
|
||
}
|
||
```
|
||
|
||
Перед reload:
|
||
|
||
```bash
|
||
sudo cp -a /etc/caddy/Caddyfile /etc/caddy/Caddyfile.bak.$(date +%F_%H%M%S)
|
||
sudo caddy validate --config /etc/caddy/Caddyfile
|
||
sudo systemctl reload caddy
|
||
```
|
||
|
||
## Smoke-check
|
||
|
||
С docker-runtime:
|
||
|
||
```bash
|
||
curl -fsS http://10.20.0.20:18082/healthz
|
||
curl -I http://10.20.0.20:18082/
|
||
```
|
||
|
||
Снаружи:
|
||
|
||
```bash
|
||
curl -I http://trade.flamy.studio
|
||
curl -I https://trade.flamy.studio
|
||
curl -fsS https://trade.flamy.studio/healthz
|
||
```
|
||
|
||
Маршруты:
|
||
|
||
```text
|
||
/ 200
|
||
/about 200
|
||
/blog 200
|
||
/blog/osnovy-upravleniya-riskami 200
|
||
/dashboard 200
|
||
/healthz 200
|
||
/favicon.svg 200
|
||
/robots.txt 200
|
||
/sitemap.xml 200
|
||
/nesuschestvuyuschiy-url 404
|
||
```
|
||
|
||
## Rollback
|
||
|
||
1. Каждый image получает тег git SHA через `APP_IMAGE_TAG`.
|
||
2. Предыдущий image не удаляется до успешного smoke-check.
|
||
3. Для отката поменяйте `APP_IMAGE_TAG` на предыдущий SHA.
|
||
4. Выполните:
|
||
|
||
```bash
|
||
docker compose up -d --no-build
|
||
```
|
||
|
||
Если проблема в маршрутизации, восстановите backup Caddyfile и выполните `sudo systemctl reload caddy`.
|