diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 8873fdf..9c25ceb 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -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 </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" diff --git a/AGENTS.md b/AGENTS.md index 432c058..cdee305 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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)`** diff --git a/GITEA-vars.md b/GITEA-vars.md index 503111b..09a060f 100644 --- a/GITEA-vars.md +++ b/GITEA-vars.md @@ -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.