diff --git a/Deployment.md b/Deployment.md new file mode 100644 index 0000000..d96d1bf --- /dev/null +++ b/Deployment.md @@ -0,0 +1,65 @@ +# Деплой на сервер + +## Сервер + +- **Хостинг:** Timeweb Cloud VPS +- **ОС:** Ubuntu 24.04 +- **Домен:** va.aspekter.ru +- **SSL:** Let's Encrypt (certbot, auto-renew) + +## Различия DEV vs PROD + +### DEV (docker-compose.yml, на маке): +- `./z51-pug-builder/src` → `/app/src` — монтируется, **HMR работает** +- `./z51-pug-builder/vite.config.js` → монтируется, **нужен restart** +- Контейнеры: `vaaspekter-builder-1`, `vaaspekter-email-gen-api-1` + +### PROD (docker-compose.prod.yml, на VPS): +- **НЕТ монтирования src/ и vite.config.js** — всё запечено в Docker-образ +- Только `./data` и `./email-gen` монтируются как volumes +- Контейнеры: `va-builder`, `va-email-gen-api` + +## Процедура деплоя + +⚠️ **ВАЖНО:** Сборка на Mac (ARM) для x86 сервера — обязательно `--platform linux/amd64`! + +```bash +# 1. Собрать образ +docker build --platform linux/amd64 -f z51-pug-builder/Dockerfile -t vaaspekter-builder . + +# 2. Экспортировать +docker save vaaspekter-builder | gzip > /tmp/va-builder.tar.gz + +# 3. Загрузить на сервер +scp /tmp/va-builder.tar.gz root@45.144.221.96:/opt/va/ + +# 4. На сервере +ssh root@45.144.221.96 +cd /opt/va +docker load < va-builder.tar.gz +docker compose -f docker-compose.prod.yml up -d builder +``` + +## Пути на сервере + +| Путь | Описание | +|---|---| +| `/opt/va/docker-compose.prod.yml` | Prod compose | +| `/opt/va/data/` | Данные (letters, settings, sessions) | +| `/opt/va/email-gen/` | Pug-шаблоны | +| `/etc/nginx/sites-enabled/aspekter` | Nginx конфиг | + +## Nginx + +- `va.aspekter.ru` → proxy к `127.0.0.1:6001` (builder) +- `aspekter.ru` → лендинг (для будущего проекта) +- `git.aspekter.ru` → Gitea +- Блокировка сканеров: `.env`, `.git`, `.php`, `passwd` и т.п. → 444 + +## Очистка Docker-образов + +После нескольких деплоев накапливаются старые образы. Очистка: + +```bash +docker image prune -a -f +```