ci: порт gateway, подсеть и резолвер — литералы workflow, новых Variables нет
WORDPDF_PORT/PROD_SUBNET/PROD_GW — внутренняя геометрия стека, не координаты стенда: зашиты в рендер напрямую, job deploy проверяет только прежние Variables (DEPLOY_*/REGISTRY/WORDPDF_MAX_*).
This commit is contained in:
+12
-18
@@ -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"
|
||||
|
||||
@@ -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)`**
|
||||
|
||||
@@ -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.
|
||||
|
||||
|
||||
Reference in New Issue
Block a user