ci: прод-конфигурация целиком в Gitea workflow (прод без состояния) #23
+12
-18
@@ -120,16 +120,13 @@ jobs:
|
|||||||
REGISTRY: ${{ vars.REGISTRY }}
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
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 }}
|
||||||
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
|
|
||||||
PROD_SUBNET: ${{ vars.PROD_SUBNET }}
|
|
||||||
PROD_GW: ${{ vars.PROD_GW }}
|
|
||||||
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
|
DEPLOY_SSH_KEY: ${{ secrets.DEPLOY_SSH_KEY }}
|
||||||
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
run: |
|
run: |
|
||||||
missing=0
|
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; }
|
[ -n "${!v}" ] || { echo "Задайте Actions Variable $v — см. GITEA-vars.md" >&2; missing=1; }
|
||||||
done
|
done
|
||||||
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do
|
for s in DEPLOY_SSH_KEY REGISTRY_USER REGISTRY_PASSWORD WORDPDF_API_KEY; do
|
||||||
@@ -148,9 +145,6 @@ jobs:
|
|||||||
REGISTRY: ${{ vars.REGISTRY }}
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
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 }}
|
||||||
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
|
|
||||||
PROD_SUBNET: ${{ vars.PROD_SUBNET }}
|
|
||||||
PROD_GW: ${{ vars.PROD_GW }}
|
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
REGISTRY_USER: ${{ secrets.REGISTRY_USER }}
|
||||||
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
REGISTRY_PASSWORD: ${{ secrets.REGISTRY_PASSWORD }}
|
||||||
@@ -160,7 +154,7 @@ jobs:
|
|||||||
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_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: |
|
script: |
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
umask 077
|
umask 077
|
||||||
@@ -207,7 +201,7 @@ jobs:
|
|||||||
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
- ./nginx.conf:/etc/nginx/conf.d/default.conf:ro
|
||||||
# 127.0.0.1 — наружный nginx этого же хоста (pjandro.ru/pdf-converter/),
|
# 127.0.0.1 — наружный nginx этого же хоста (pjandro.ru/pdf-converter/),
|
||||||
# $DEPLOY_HOST — прямой LAN-вход
|
# $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:
|
depends_on:
|
||||||
app:
|
app:
|
||||||
condition: service_healthy
|
condition: service_healthy
|
||||||
@@ -216,12 +210,13 @@ jobs:
|
|||||||
restart: unless-stopped
|
restart: unless-stopped
|
||||||
networks:
|
networks:
|
||||||
# Подсеть зафиксирована намеренно: nginx резолвит app/web через aardvark-dns
|
# Подсеть зафиксирована намеренно: nginx резолвит app/web через aardvark-dns
|
||||||
# на шлюзе сети ($PROD_GW), адрес обязан быть предсказуемым.
|
# на шлюзе сети (10.112.0.1), адрес обязан быть предсказуемым. Внутренняя
|
||||||
|
# геометрия стека, не координата стенда — литералом здесь.
|
||||||
default:
|
default:
|
||||||
ipam:
|
ipam:
|
||||||
config:
|
config:
|
||||||
- subnet: $PROD_SUBNET
|
- subnet: 10.112.0.0/24
|
||||||
gateway: $PROD_GW
|
gateway: 10.112.0.1
|
||||||
COMPOSE
|
COMPOSE
|
||||||
cat > nginx.conf <<NGINX
|
cat > nginx.conf <<NGINX
|
||||||
# Врата прод-стека: единственный вход. API/документация/actuator → app,
|
# Врата прод-стека: единственный вход. API/документация/actuator → app,
|
||||||
@@ -236,7 +231,7 @@ jobs:
|
|||||||
# при старте nginx: gateway, поднявшийся раньше app, получал навсегда
|
# при старте nginx: gateway, поднявшийся раньше app, получал навсегда
|
||||||
# мёртвый апстрим (502 до перезапуска). resolver + переменная резолвят
|
# мёртвый апстрим (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_app http://app:8080;
|
||||||
set \$upstream_web http://web:80;
|
set \$upstream_web http://web:80;
|
||||||
location /api/ {
|
location /api/ {
|
||||||
@@ -283,9 +278,9 @@ jobs:
|
|||||||
# на каждый деплой рендерится заново, пересоздание применяет его.
|
# на каждый деплой рендерится заново, пересоздание применяет его.
|
||||||
podman-compose up -d --force-recreate gateway
|
podman-compose up -d --force-recreate gateway
|
||||||
for _ in $(seq 1 10); do
|
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
|
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
|
podman-compose ps
|
||||||
|
|
||||||
autotests:
|
autotests:
|
||||||
@@ -328,7 +323,6 @@ jobs:
|
|||||||
env:
|
env:
|
||||||
DEPLOY_DIR: ${{ vars.DEPLOY_DIR }}
|
DEPLOY_DIR: ${{ vars.DEPLOY_DIR }}
|
||||||
REGISTRY: ${{ vars.REGISTRY }}
|
REGISTRY: ${{ vars.REGISTRY }}
|
||||||
WORDPDF_PORT: ${{ vars.WORDPDF_PORT }}
|
|
||||||
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
WORDPDF_API_KEY: ${{ secrets.WORDPDF_API_KEY }}
|
||||||
uses: appleboy/ssh-action@v1.0.3
|
uses: appleboy/ssh-action@v1.0.3
|
||||||
with:
|
with:
|
||||||
@@ -336,7 +330,7 @@ jobs:
|
|||||||
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_PORT,WORDPDF_API_KEY
|
envs: DEPLOY_DIR,REGISTRY,WORDPDF_API_KEY
|
||||||
script: |
|
script: |
|
||||||
set -euo pipefail
|
set -euo pipefail
|
||||||
cd "$DEPLOY_DIR"
|
cd "$DEPLOY_DIR"
|
||||||
@@ -355,4 +349,4 @@ jobs:
|
|||||||
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
[ "$(podman inspect -f '{{.State.Health.Status}}' wordpdf-prod-app-1)" = healthy ] \
|
||||||
|| { echo "app НЕ healthy после отката" >&2; exit 1; }
|
|| { echo "app НЕ healthy после отката" >&2; exit 1; }
|
||||||
podman-compose up -d --force-recreate gateway
|
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
|
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)
|
## CI/CD (Gitea Actions)
|
||||||
|
|
||||||
@@ -111,8 +111,7 @@ app/web; login/pull/`up -d --force-recreate app web`; гейты healthy и imag
|
|||||||
**Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни
|
**Правило: координаты прода и креды в коммитимые файлы не попадают** — ни внутренние IP, ни
|
||||||
SSH-пользователи/логины, ни хосты, ни директория деплоя, ни ключи/токены/пароли. Координаты
|
SSH-пользователи/логины, ни хосты, ни директория деплоя, ни ключи/токены/пароли. Координаты
|
||||||
стенда — Gitea Actions **Variables** (`DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_DIR`,
|
стенда — Gitea Actions **Variables** (`DEPLOY_HOST`, `DEPLOY_USER`, `DEPLOY_DIR`,
|
||||||
`WORDPDF_BASE_URL`, `WORDPDF_MAX_PAGES`, `WORDPDF_MAX_MB`, `REGISTRY`, `WORDPDF_PORT`,
|
`WORDPDF_BASE_URL`, `WORDPDF_MAX_PAGES`, `WORDPDF_MAX_MB`, `REGISTRY`), креды — **Secrets** (`DEPLOY_SSH_KEY`,
|
||||||
`PROD_SUBNET`, `PROD_GW`), креды — **Secrets** (`DEPLOY_SSH_KEY`,
|
|
||||||
`WORDPDF_API_KEY`, `REGISTRY_USER`, `REGISTRY_PASSWORD`); workflow-файлы ссылаются на них только `${{ vars.* }}`/`${{ secrets.* }}`.
|
`WORDPDF_API_KEY`, `REGISTRY_USER`, `REGISTRY_PASSWORD`); workflow-файлы ссылаются на них только `${{ vars.* }}`/`${{ secrets.* }}`.
|
||||||
Инструкция владельца — корневой `GITEA-vars.md` (только имена, без значений). Защита ветки
|
Инструкция владельца — корневой `GITEA-vars.md` (только имена, без значений). Защита ветки
|
||||||
`main`: required-контексты **`PR checks / java (pull_request)`, `PR checks / web (pull_request)`**
|
`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_PAGES`|Лимит страниц на проде (сейчас `100`)|
|
||||||
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|
|
|`WORDPDF_MAX_MB`|Лимит размера входного .docx, МБ (сейчас `5`)|
|
||||||
|`REGISTRY`|Адрес docker-реестра `host:port` без схемы (Nexus docker-registry на прод-сервере, коннектор `:5000`)|
|
|`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.
|
При смене лимитов прода — править `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