ci: прод-конфигурация целиком в Gitea workflow (прод без состояния) #23

Merged
pjandro merged 2 commits from deploy-config-in-workflow into main 2026-10-22 00:13:24 +03:00
3 changed files with 178 additions and 34 deletions
+163 -20
View File
@@ -112,7 +112,7 @@ jobs:
runs-on: ubuntu-latest runs-on: ubuntu-latest
needs: images needs: images
steps: steps:
- name: Check deploy vars and secret - name: Check deploy vars and secrets
env: env:
DEPLOY_HOST: ${{ vars.DEPLOY_HOST }} DEPLOY_HOST: ${{ vars.DEPLOY_HOST }}
DEPLOY_USER: ${{ vars.DEPLOY_USER }} DEPLOY_USER: ${{ vars.DEPLOY_USER }}
@@ -121,29 +121,167 @@ jobs:
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }} WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }} WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }} DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
run: | run: |
[ -n "$DEPLOY_HOST" ] && [ -n "$DEPLOY_USER" ] && [ -n "$DEPLOY_DIR" ] && [ -n "$REGISTRY" ] && [ -n "$WORDPDF_MAX_MB" ] && [ -n "$WORDPDF_MAX_PAGES" ] && [ -n "$DEPLOY_SSH_KEY" ] || { missing=0
echo "Задайте Actions Variables DEPLOY_HOST/DEPLOY_USER/DEPLOY_DIR/REGISTRY/WORDPDF_MAX_MB/WORDPDF_MAX_PAGES и Secret DEPLOY_SSH_KEY — см. GITEA-vars.md" >&2 for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do
exit 1 [ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; }
} done
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do
[ -n "${!s}" ] || { echo "Задайте Actions Secret $s — см. GITEA-vars.md" >&2; missing=1; }
done
exit "$missing"
- name: Save rollback state and deploy # Единственный источник правды конфигурации прода — этот workflow: docker-compose.yml
# и nginx.conf рендерятся на прод-хост на каждый деплой из Variables/Secrets;
# ключ API в файлы не пишется (берётся из окружения job'а). На прод-хосте
# конфигурации нет: restart.sh и .env удаляются как наследие ручного setup.
- name: Render prod stack and deploy
env:
DEPLOY_DIR: ${{ vars.DEPLOY_DIR }}
DEPLOY_HOST: ${{ vars.DEPLOY_HOST }}
REGISTRY: ${{ vars.REGISTRY }}
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
uses: appleboy/ssh-action@v1.0.3 uses: appleboy/ssh-action@v1.0.3
with: with:
host: ${{ vars.DEPLOY_HOST }} host: ${{ vars.DEPLOY_HOST }}
username: ${{ vars.DEPLOY_USER }} username: ${{ vars.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_KEY }} key: ${{ secrets.DEPLOY_SSH_KEY }}
script_stop: true script_stop: true
envs: DEPLOY_DIR,DEPLOY_HOST,REGISTRY,WORDPDF_MAX_MB,WORDPDF_MAX_PAGES,WORDPDF_API_KEY,REGISTRY_USER,REGISTRY_PASSWORD
script: | script: |
set -euo pipefail set -euo pipefail
cd "${{ vars.DEPLOY_DIR }}"
export WORDPDF_MAX_MB="${{ vars.WORDPDF_MAX_MB }}" WORDPDF_MAX_PAGES="${{ vars.WORDPDF_MAX_PAGES }}"
umask 077 umask 077
{ mkdir -p "$DEPLOY_DIR"
echo "PREV_APP=$(podman inspect -f '{{.Image}}' wordpdf-prod-app-1)" cd "$DEPLOY_DIR"
echo "PREV_WEB=$(podman inspect -f '{{.Image}}' wordpdf-prod-web-1)" rm -f restart.sh .env
} > .rollback.env cat > docker-compose.yml <<COMPOSE
./restart.sh --deploy name: wordpdf-prod
# Рендерится CI на каждый деплой (Gitea Actions, job deploy в main.yml) —
# конфигурации стека на хосте нет. x-podman даёт docker-style имена контейнеров
# (wordpdf-prod-app-1), от них зависят гейты деплоя; docker игнорирует x-.
x-podman:
name_separator_compat: true
services:
app:
image: $REGISTRY/wordpdf-app:prod
restart: unless-stopped
# healthcheck дублируется в compose, а не только в Containerfile: podman
# выгружает образы в OCI, где HEALTHCHECK теряется, а gateway в depends_on
# ждал бы healthy вечно. wget, не curl: alpine-jre образ curl не содержит.
healthcheck:
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
interval: 10s
timeout: 3s
start_period: 45s
retries: 5
environment:
# ключ берётся из окружения деплоя (Gitea Secret WORDPDF_API_KEY),
# в файл на диске не пишется; в конфиг контейнера его зафиксирует podman
WORDPDF_API_KEY: "\${WORDPDF_API_KEY:?WORDPDF_API_KEY not set}"
WORDPDF_MAX_MB: "$WORDPDF_MAX_MB"
WORDPDF_MAX_PAGES: "$WORDPDF_MAX_PAGES"
web:
image: $REGISTRY/wordpdf-web:prod
restart: unless-stopped
healthcheck:
test: ["CMD-SHELL", "http_proxy= https_proxy= wget -qO /dev/null http://127.0.0.1/ || exit 1"]
interval: 10s
timeout: 3s
start_period: 10s
gateway:
image: docker.io/library/nginx:alpine
volumes:
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
# 127.0.0.1 — наружный nginx этого же хоста (pjandro.ru/pdf-converter/),
# $DEPLOY_HOST — прямой LAN-вход
ports: ["127.0.0.1:9010:80", "$DEPLOY_HOST:9010:80"]
depends_on:
app:
condition: service_healthy
web:
condition: service_healthy
restart: unless-stopped
networks:
# Подсеть зафиксирована намеренно: nginx резолвит app/web через aardvark-dns
# на шлюзе сети (10.112.0.1), адрес обязан быть предсказуемым. Внутренняя
# геометрия стека, не координата стенда — литералом здесь.
default:
ipam:
config:
- subnet: 10.112.0.0/24
gateway: 10.112.0.1
COMPOSE
cat > nginx.conf <<NGINX
# Врата прод-стека: единственный вход. API/документация/actuator → app,
# остальное → SPA. Рендерится CI на каждый деплой (job deploy в main.yml).
server {
listen 80;
# потолок загрузки стека: без директивы upload режется HTML-413 от шлюза
# до бэкенда (авторитетный лимит — WORDPDF_MAX_MB в приложении)
client_max_body_size 100m;
# app/web резолвятся aardvark-dns на шлюзе сети стека (подсеть
# зафиксирована в compose). Статический proxy_pass резолвит имя один раз
# при старте nginx: gateway, поднявшийся раньше app, получал навсегда
# мёртвый апстрим (502 до перезапуска). resolver + переменная резолвят
# на каждый запрос.
resolver 10.112.0.1 valid=10s ipv6=off;
set \$upstream_app http://app:8080;
set \$upstream_web http://web:80;
location /api/ {
# в proxy_pass нет path-части, поэтому URI передаётся как есть
proxy_pass \$upstream_app;
# wordpdf.convert-timeout=2m; дефолтный proxy_read_timeout 60s рвёт
# длинные конвертации
proxy_read_timeout 300s;
proxy_send_timeout 300s;
}
location /swagger-ui { proxy_pass \$upstream_app; }
location /v3/api-docs { proxy_pass \$upstream_app; }
# открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг
location /actuator { proxy_pass \$upstream_app; }
location / { proxy_pass \$upstream_web; }
}
NGINX
# Состояние отката — image ID, на которых стек стоит сейчас (если поднят).
if podman ps -a --format '{{.Names}}' | grep -qx wordpdf-prod-app-1 \
&& podman ps -a --format '{{.Names}}' | grep -qx wordpdf-prod-web-1; then
{
echo "PREV_APP=$(podman inspect -f '{{.Image}}' wordpdf-prod-app-1)"
echo "PREV_WEB=$(podman inspect -f '{{.Image}}' wordpdf-prod-web-1)"
} > .rollback.env
fi
printf '%s' "$REGISTRY_PASSWORD" | podman login "$REGISTRY" --username "$REGISTRY_USER" --password-stdin
podman-compose pull app web
podman-compose up -d --force-recreate app web
for _ in $(seq 1 60); do
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
sleep 2
done
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|| { echo "app не стал healthy за 120с" >&2; exit 1; }
# Гейт: app/web обязаны идти на только что стянутый из реестра образ
# (защита от молчаливого деплоя старого кода).
for svc in app web; do
ctr="wordpdf-prod-${svc}-1"
[ "$(podman inspect -f '{{.Image}}' "$ctr")" = \
"$(podman image inspect "$REGISTRY/wordpdf-${svc}:prod" -f '{{.Id}}')" ] \
|| { echo "$ctr запущен не на новом образе $REGISTRY/wordpdf-${svc}:prod" >&2; exit 1; }
done
# gateway пересоздаётся последним (после healthy app/web): nginx.conf
# на каждый деплой рендерится заново, пересоздание применяет его.
podman-compose up -d --force-recreate gateway
for _ in $(seq 1 10); do
curl -fsS -o /dev/null "http://127.0.0.1:9010/actuator/health" 2>/dev/null && break || sleep 1
done
curl -fsS "http://127.0.0.1:9010/actuator/health"
podman-compose ps
autotests: autotests:
runs-on: ubuntu-latest runs-on: ubuntu-latest
@@ -182,28 +320,33 @@ jobs:
if: failure() if: failure()
steps: steps:
- name: Roll back prod to previous images - name: Roll back prod to previous images
env:
DEPLOY_DIR: ${{ vars.DEPLOY_DIR }}
REGISTRY: ${{ vars.REGISTRY }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
uses: appleboy/ssh-action@v1.0.3 uses: appleboy/ssh-action@v1.0.3
with: with:
host: ${{ vars.DEPLOY_HOST }} host: ${{ vars.DEPLOY_HOST }}
username: ${{ vars.DEPLOY_USER }} username: ${{ vars.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_KEY }} key: ${{ secrets.DEPLOY_SSH_KEY }}
script_stop: true script_stop: true
envs: DEPLOY_DIR,REGISTRY,WORDPDF_API_KEY
script: | script: |
set -euo pipefail set -euo pipefail
cd "${{ vars.DEPLOY_DIR }}" cd "$DEPLOY_DIR"
export WORDPDF_MAX_MB="${{ vars.WORDPDF_MAX_MB }}" WORDPDF_MAX_PAGES="${{ vars.WORDPDF_MAX_PAGES }}"
if [ ! -f .rollback.env ]; then if [ ! -f .rollback.env ]; then
echo "НЕТ .rollback.env — АВТОМАТИЧЕСКИЙ ОТКАТ НЕВОЗМОЖЕН" >&2 echo "НЕТ .rollback.env — АВТОМАТИЧЕСКИЙ ОТКАТ НЕВОЗМОЖЕН" >&2
exit 1 exit 1
fi fi
. ./.rollback.env . ./.rollback.env
podman tag "$PREV_APP" "${{ vars.REGISTRY }}/wordpdf-app:prod" podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod"
podman tag "$PREV_WEB" "${{ vars.REGISTRY }}/wordpdf-web:prod" podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod"
podman-compose up -d --force-recreate app web podman-compose up -d --force-recreate app web
for _ in $(seq 1 60); do for _ in $(seq 1 60); do
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break [ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] && break
sleep 2 sleep 2
done done
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] || { echo "app НЕ healthy после отката" >&2; exit 1; } [ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
podman-compose restart gateway || { echo "app НЕ healthy после отката" >&2; exit 1; }
curl -fsS http://127.0.0.1:9010/actuator/health podman-compose up -d --force-recreate gateway
curl -fsS "http://127.0.0.1:9010/actuator/health"
+11 -10
View File
@@ -55,9 +55,9 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)| |`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений| |`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений|
|`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)|
|корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose интерполирует `WORDPDF_MAX_MB:-5`/`WORDPDF_MAX_PAGES:-100`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)| |корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|корневой `.env.example`|шаблон env: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)| |корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем|
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images` (build+push в Nexus) → deploy (pull) → autotests → rollback)| |`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
|корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 20 проверок): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`| |корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 20 проверок): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`|
|`develop/` (вне git)|рабочие материалы и эталоны Word (`testDoc.doc/.pdf`, `testDoc.convert.pdf`, `openxml.docx/.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать| |`develop/` (вне git)|рабочие материалы и эталоны Word (`testDoc.doc/.pdf`, `testDoc.convert.pdf`, `openxml.docx/.pdf`) — **ручное сравнение, не фикстуры**, в тесты/jar не подключать|
@@ -84,7 +84,7 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \
ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples ru.pjandro.wordpdf.SampleDocxGenerator wordpdf-core/src/test/resources/samples
``` ```
Деплой. **Прод** — на пользовательском LAN-сервере (podman + podman-compose, docker-бинарников нет); координаты сервера, каталог, restart-секвенция, ключ и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском). Единая точка входа с dev-машины — `/home/pjandro/prod/java-word-pdf/restart.sh` (пробрасывает флаги удалённому скрипту: `--deploy` — pull образов `wordpdf-{app,web}:prod` из Nexus-реестра (их собирает CI, job `images`) и пересоздание app/web; без флага — restart контейнеров; предупреждает о не запушенном в `main`). В прод попадает только собранное CI из `main`; прод не собирает код и git-клона на проде нет (insecure-запись реестра в `/etc/containers/registries.conf.d/`, креды `REGISTRY_USER`/`REGISTRY_PASSWORD` в прод `.env`). Прод-compose `/opt/wordpdf/docker-compose.yml` (вне git) содержит podman-специфику: `x-podman.name_separator_compat` (имена `wordpdf-prod-app-1`, от них зависит `restart.sh`), явные healthcheck app/web и фиксированную подсеть `10.112.0.0/24` gw `10.112.0.1`. Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа отличается от репо только резолвером `10.112.0.1` — под свою подсеть — и `proxy_read_timeout 300s` — в репо его нет, дефолтные 60s рвут 2-минутные конвертации; resolver + `proxy_pass` через переменную есть и там и там). Тот же наружный nginx в `location /pdf-converter/` добавляет `X-Forwarded-Host`/`X-Forwarded-Prefix` — из них springdoc собирает server-URL спека под префиксом. **Dev-стенд** — из репо `compose.dev.yml` (проект `wordpdf-dev`, `9011:80` на все интерфейсы, без env → ключ пуст, springdoc вкл). Репозиторный `compose.yml` — третий вариант (проект `wordpdf`, `9010:80`, `WORDPDF_API_KEY` fail-closed без `.env` — `up` упадёт; `VITE_BASE` — build-arg `wordpdf-web/Containerfile`, репо-compose НЕ передаёт: `compose build` без arg даёт base `/` и битые ассеты под префиксом; на прод-путь не влияет — там `VITE_BASE=/pdf-converter/` запекает CI в job `images`). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка. Деплой. **Прод** — на пользовательском LAN-сервере (podman + podman-compose, docker-бинарников нет); координаты сервера и гейты успешности — вне репо: `/home/pjandro/prod/java-word-pdf/DEPLOY.md` (обязательно прочитать перед любым деплоем/перезапуском). Прод-хост **не хранит ни деплой-конфигурации, ни секретов**: job `deploy` в `main.yml` на каждый деплой рендерит `docker-compose.yml` и `nginx.conf` в директорию деплоя (значения — из Variables `REGISTRY`/`DEPLOY_HOST`/`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`, API-ключ — из Secret `WORDPDF_API_KEY` через окружение деплоя, на диск не пишется), затем login/pull/`up -d --force-recreate app web`/гейты healthy+image/recreate gateway. Наследие ручного setup `restart.sh` и `.env` деплой удаляет; единственное состояние на проде — `.rollback.env` (image ID для отката). Перезадеплой — push в `main` или Run workflow (`workflow_dispatch`), ручных скриптов нет. В прод попадает только собранное CI из `main`; прод не собирает код и git-клона на проде нет (insecure-запись реестра в `/etc/containers/registries.conf.d/`). Рендеренный compose содержит podman-специфику: `x-podman.name_separator_compat` (имена `wordpdf-prod-app-1`, от них зависят гейты), явные healthcheck app/web — `wget` (alpine-jre образ curl не содержит; curl-хелсчек на новом образе давал вечный unhealthy и висящий `up`), наружный порт gateway `9010` и фиксированная подсеть `10.112.0.0/24` gw `10.112.0.1` — внутренняя геометрия стека, литералом в workflow (не координата стенда, Variables для неё не заведены). Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа рендерится workflow и отличается от репо только резолвером `10.112.0.1` — под свою подсеть — и `proxy_read_timeout 300s` — в репо его нет, дефолтные 60s рвут 2-минутные конвертации; resolver + `proxy_pass` через переменную есть и там и там). Тот же наружный nginx в `location /pdf-converter/` добавляет `X-Forwarded-Host`/`X-Forwarded-Prefix` — из них springdoc собирает server-URL спека под префиксом. **Dev-стенд** — из репо `compose.dev.yml` (проект `wordpdf-dev`, `9011:80` на все интерфейсы, без env → ключ пуст, springdoc вкл). Репозиторный `compose.yml` — третий вариант (проект `wordpdf`, `9010:80`, `WORDPDF_API_KEY` fail-closed без `.env` — `up` упадёт; `VITE_BASE` — build-arg `wordpdf-web/Containerfile`, репо-compose НЕ передаёт: `compose build` без arg даёт base `/` и битые ассеты под префиксом; на прод-путь не влияет — там `VITE_BASE=/pdf-converter/` запекает CI в job `images`). Запуск по просьбе пользователя = прод-стек; dev/`java -jar`/`npm run dev` — внутренняя отладка.
## CI/CD (Gitea Actions) ## CI/CD (Gitea Actions)
@@ -97,14 +97,15 @@ deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`w
immovable `sha-<7 символов GITHUB_SHA>`; web пекётся с `--build-arg VITE_BASE=/pdf-converter/`; immovable `sha-<7 символов GITHUB_SHA>`; web пекётся с `--build-arg VITE_BASE=/pdf-converter/`;
`DOCKER_BUILDKIT=0` обязателен — daemon за раннером podman, BuildKit-сессий нет; креды — `DOCKER_BUILDKIT=0` обязателен — daemon за раннером podman, BuildKit-сессий нет; креды —
вручную пишется `~/.docker/config.json`, job-контейнеры видят podman-сокет хоста — настройка вручную пишется `~/.docker/config.json`, job-контейнеры видят podman-сокет хоста — настройка
раннера вне репо, см. DEPLOY.md), `deploy` (SSH на прод: раннера вне репо, см. DEPLOY.md), `deploy` (SSH на прод: рендер `docker-compose.yml`
сохранить `.rollback.env` — image ID контейнеров app/web — затем и `nginx.conf` в директорию деплоя (Variable `DEPLOY_DIR`) из Variables/Secrets —
`restart.sh --deploy` в директории деплоя (Variable `DEPLOY_DIR`); export Variables на проде конфигурации не хранится; сохранение `.rollback.env` — image ID контейнеров
`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` в окружение compose — лимиты прода задаются app/web; login/pull/`up -d --force-recreate app web`; гейты healthy и image;
ими, `autotests`/`rollback` используют те же), `autotests` (venv + `up -d --force-recreate gateway`; health-check. Лимиты задают Variables
`WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES`, `autotests`/`rollback` используют те же), `autotests` (venv +
`prod-autotests/` против прода), `prod-autotests/` против прода),
`rollback` (`if: failure()` — retag прежних image ID на `${{ vars.REGISTRY }}/wordpdf-app:prod` `rollback` (`if: failure()` — retag прежних image ID на `${{ vars.REGISTRY }}/wordpdf-app:prod`
и `…/wordpdf-web:prod`, `--force-recreate app web`, рестарт gateway). Кеш раннеров — и `…/wordpdf-web:prod`, `--force-recreate app web`, пересоздание gateway). Кеш раннеров —
сервер act_runner (серверная часть, вне репо). сервер act_runner (серверная часть, вне репо).
**Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни **Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни
+4 -4
View File
@@ -14,17 +14,17 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего
|Имя|Значение|Где взять| |Имя|Значение|Где взять|
|---|---|---| |---|---|---|
|`DEPLOY_SSH_KEY`|Приватный SSH-ключ деплоя на прод (целиком, PEM)|CI-ключ `wordpdf-ci-deploy` на dev-машине; публичная половина уже добавлена в `authorized_keys` деплой-пользователя прод-сервера| |`DEPLOY_SSH_KEY`|Приватный SSH-ключ деплоя на прод (целиком, PEM)|CI-ключ `wordpdf-ci-deploy` на dev-машине; публичная половина уже добавлена в `authorized_keys` деплой-пользователя прод-сервера|
|`WORDPDF_API_KEY`|Прод-ключ API wordpdf|`.env` в директории деплоя на прод-сервере (значение `WORDPDF_API_KEY`)| |`WORDPDF_API_KEY`|Прод-ключ API wordpdf|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea|
|`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)| |`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)|
|`REGISTRY_PASSWORD`|Пароль этого пользователя|Тот же, что в `.env` директории деплоя на прод-сервере (значение `REGISTRY_PASSWORD`)| |`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)|
## Переменные (Settings → Actions → Variables) ## Переменные (Settings → Actions → Variables)
|Имя|Значение| |Имя|Значение|
|---|---| |---|---|
|`DEPLOY_HOST`|Адрес прод-сервера (туда Actions ходит по SSH)| |`DEPLOY_HOST`|IP прод-сервера (туда Actions ходит по SSH; им же связывается LAN-порт gateway — нужен именно IP, не hostname)|
|`DEPLOY_USER`|SSH-пользователь прод-сервера с правами на podman| |`DEPLOY_USER`|SSH-пользователь прод-сервера с правами на podman|
|`DEPLOY_DIR`|Абсолютный путь директории деплоя на прод-сервере (compose, `restart.sh`, `.rollback.env`, `.env`)| |`DEPLOY_DIR`|Абсолютный путь рабочей директории деплоя: job `deploy` создаёт её и рендерит в неё `docker-compose.yml` и `nginx.conf` на каждый деплой; `.rollback.env` — состояние отката (его пишет job `deploy`)|
|`WORDPDF_BASE_URL`|Базовый URL прод-API для автотестов (вида `https://<домен-прода>/pdf-converter`)| |`WORDPDF_BASE_URL`|Базовый URL прод-API для автотестов (вида `https://<домен-прода>/pdf-converter`)|
|`WORDPDF_MAX_PAGES`|Лимит страниц на проде (сейчас `100`)| |`WORDPDF_MAX_PAGES`|Лимит страниц на проде (сейчас `100`)|
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)| |`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|