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 14 additions and 24 deletions
Showing only changes of commit e85505529c - Show all commits
+12 -18
View File
@@ -120,16 +120,13 @@ jobs:
REGISTRY: ${{ vars.REGISTRY }}
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
PROD_SUBNET: ${{ vars.PROD_SUBNET }}
PROD_GW: ${{ vars.PROD_GW }}
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: |
missing=0
for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES WORDPDF_PORT PROD_SUBNET PROD_GW; do
for v in DEPLOY_HOST DEPLOY_USER DEPLOY_DIR REGISTRY WORDPDF_MAX_MB WORDPDF_MAX_PAGES; do
[ -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
@@ -148,9 +145,6 @@ jobs:
REGISTRY: ${{ vars.REGISTRY }}
WORDPDF_MAX_MB: ${{ vars.WORDPDF_MAX_MB }}
WORDPDF_MAX_PAGES: ${{ vars.WORDPDF_MAX_PAGES }}
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
PROD_SUBNET: ${{ vars.PROD_SUBNET }}
PROD_GW: ${{ vars.PROD_GW }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
@@ -160,7 +154,7 @@ jobs:
username: ${{ vars.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_KEY }}
script_stop: true
envs: DEPLOY_DIR,DEPLOY_HOST,REGISTRY,WORDPDF_MAX_MB,WORDPDF_MAX_PAGES,WORDPDF_PORT,PROD_SUBNET,PROD_GW,WORDPDF_API_KEY,REGISTRY_USER,REGISTRY_PASSWORD
envs: DEPLOY_DIR,DEPLOY_HOST,REGISTRY,WORDPDF_MAX_MB,WORDPDF_MAX_PAGES,WORDPDF_API_KEY,REGISTRY_USER,REGISTRY_PASSWORD
script: |
set -euo pipefail
umask 077
@@ -207,7 +201,7 @@ jobs:
- ./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:$WORDPDF_PORT:80", "$DEPLOY_HOST:$WORDPDF_PORT:80"]
ports: ["127.0.0.1:9010:80", "$DEPLOY_HOST:9010:80"]
depends_on:
app:
condition: service_healthy
@@ -216,12 +210,13 @@ jobs:
restart: unless-stopped
networks:
# Подсеть зафиксирована намеренно: nginx резолвит app/web через aardvark-dns
# на шлюзе сети ($PROD_GW), адрес обязан быть предсказуемым.
# на шлюзе сети (10.112.0.1), адрес обязан быть предсказуемым. Внутренняя
# геометрия стека, не координата стенда — литералом здесь.
default:
ipam:
config:
- subnet: $PROD_SUBNET
gateway: $PROD_GW
- subnet: 10.112.0.0/24
gateway: 10.112.0.1
COMPOSE
cat > nginx.conf <<NGINX
# Врата прод-стека: единственный вход. API/документация/actuator → app,
@@ -236,7 +231,7 @@ jobs:
# при старте nginx: gateway, поднявшийся раньше app, получал навсегда
# мёртвый апстрим (502 до перезапуска). resolver + переменная резолвят
# на каждый запрос.
resolver $PROD_GW valid=10s ipv6=off;
resolver 10.112.0.1 valid=10s ipv6=off;
set \$upstream_app http://app:8080;
set \$upstream_web http://web:80;
location /api/ {
@@ -283,9 +278,9 @@ jobs:
# на каждый деплой рендерится заново, пересоздание применяет его.
podman-compose up -d --force-recreate gateway
for _ in $(seq 1 10); do
curl -fsS -o /dev/null "http://127.0.0.1:$WORDPDF_PORT/actuator/health" 2>/dev/null && break || sleep 1
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:$WORDPDF_PORT/actuator/health"
curl -fsS "http://127.0.0.1:9010/actuator/health"
podman-compose ps
autotests:
@@ -328,7 +323,6 @@ jobs:
env:
DEPLOY_DIR: ${{ vars.DEPLOY_DIR }}
REGISTRY: ${{ vars.REGISTRY }}
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
uses: appleboy/ssh-action@v1.0.3
with:
@@ -336,7 +330,7 @@ jobs:
username: ${{ vars.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_KEY }}
script_stop: true
envs: DEPLOY_DIR,REGISTRY,WORDPDF_PORT,WORDPDF_API_KEY
envs: DEPLOY_DIR,REGISTRY,WORDPDF_API_KEY
script: |
set -euo pipefail
cd "$DEPLOY_DIR"
@@ -355,4 +349,4 @@ jobs:
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|| { echo "app НЕ healthy после отката" >&2; exit 1; }
podman-compose up -d --force-recreate gateway
curl -fsS "http://127.0.0.1:$WORDPDF_PORT/actuator/health"
curl -fsS "http://127.0.0.1:9010/actuator/health"
+2 -3
View File
@@ -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
```
Деплой. **Прод** — на пользовательском 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_PORT`/`PROD_SUBNET`/`PROD_GW`/`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`), фиксированная подсеть (`PROD_SUBNET`/`PROD_GW`). Наружный вход `https://pjandro.ru/pdf-converter/` (префикс срезает наружный nginx прод-хоста, не репозиторный gateway-конф; прод-копия gateway-конфа рендерится workflow и отличается от репо только резолвером (Variable `PROD_GW` — под свою подсеть) и `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)
@@ -111,8 +111,7 @@ app/web; login/pull/`up -d --force-recreate app web`; гейты healthy и imag
**Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни
SSH-пользователи/логины, ни хосты, ни директория деплоя, ни ключи/токены/пароли. Координаты
стенда — Gitea Actions **Variables** (`DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_DIR`,
`WORDPDF_BASE_URL`, `WORDPDF_MAX_PAGES`, `WORDPDF_MAX_MB`, `REGISTRY`, `WORDPDF_PORT`,
`PROD_SUBNET`, `PROD_GW`), креды — **Secrets** (`DEPLOY_SSH_KEY`,
`WORDPDF_BASE_URL`, `WORDPDF_MAX_PAGES`, `WORDPDF_MAX_MB`, `REGISTRY`), креды — **Secrets** (`DEPLOY_SSH_KEY`,
`WORDPDF_API_KEY`, `REGISTRY_USER`, `REGISTRY_PASSWORD`); workflow-файлы ссылаются на них только `${{ vars.* }}`/`${{ secrets.* }}`.
Инструкция владельца — корневой `GITEA-vars.md` (только имена, без значений). Защита ветки
`main`: required-контексты **`PR checks / java (pull_request)`, `PR checks / web (pull_request)`**
-3
View File
@@ -29,9 +29,6 @@ job'ах `deploy`/`autotests` с внятным сообщением, чего
|`WORDPDF_MAX_PAGES`|Лимит страниц на проде (сейчас `100`)|
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|
|`REGISTRY`|Адрес docker-реестра `host:port` без схемы (Nexus docker-registry на прод-сервере, коннектор `:5000`)|
|`WORDPDF_PORT`|Наружный порт gateway (bind на `127.0.0.1` и на `DEPLOY_HOST`)|
|`PROD_SUBNET`|Зафиксированная подсеть сети стека (CIDR) — за ней обращается резолвер nginx|
|`PROD_GW`|Шлюз `PROD_SUBNET` — адрес aardvark-dns, в него смотрит `resolver` nginx-конфа|
При смене лимитов прода — править `WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB` в Variables, PR не нужен: job `deploy` прокидывает их в прод-stack (app пересоздаётся с новыми лимитами), job `autotests` сверяет проверки с ними же. Без обеих Variables job'ы `deploy`/`autotests` падают на проверке — fail-closed.