ci: прод-конфигурация целиком в workflow — job deploy рендерит compose/nginx из Variables/Secrets
PR checks / web (pull_request) Successful in 1m14s
PR checks / java (pull_request) Successful in 1m57s

Прод-хост не хранит ни конфигов, ни секретов: docker-compose.yml и nginx.conf
генерируются job deploy на каждый деплой (новые Variables WORDPDF_PORT/
PROD_SUBNET/PROD_GW вместо литералов в yml), API-ключ подаётся окружением и на
диск не пишется; restart.sh и .env удаляются как наследие ручного setup.
Healthcheck app — wget (alpine-jre образ curl не содержит: curl-хелсчек давал
вечный unhealthy и висящий up, run 479). Gateway пересоздаётся, а не рестартует.
Rollback — retag из .rollback.env + пересоздание app/web/gateway.
This commit is contained in:
Pjandro
2026-10-21 21:07:23 +00:00
parent 17a073f0de
commit 55326bcb12
3 changed files with 189 additions and 35 deletions
+169 -20
View File
@@ -112,7 +112,7 @@ jobs:
runs-on: ubuntu-latest
needs: images
steps:
- name: Check deploy vars and secret
- name: Check deploy vars and secrets
env:
DEPLOY_HOST: ${{ vars.DEPLOY_HOST }}
DEPLOY_USER: ${{ vars.DEPLOY_USER }}
@@ -120,30 +120,173 @@ 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: |
[ -n "$DEPLOY_HOST" ] && [ -n "$DEPLOY_USER" ] && [ -n "$DEPLOY_DIR" ] && [ -n "$REGISTRY" ] && [ -n "$WORDPDF_MAX_MB" ] && [ -n "$WORDPDF_MAX_PAGES" ] && [ -n "$DEPLOY_SSH_KEY" ] || {
echo "Задайте Actions Variables DEPLOY_HOST/DEPLOY_USER/DEPLOY_DIR/REGISTRY/WORDPDF_MAX_MB/WORDPDF_MAX_PAGES и Secret DEPLOY_SSH_KEY — см. GITEA-vars.md" >&2
exit 1
}
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
[ -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_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 }}
uses: appleboy/ssh-action@v1.0.3
with:
host: ${{ vars.DEPLOY_HOST }}
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
script: |
set -euo pipefail
cd "${{ vars.DEPLOY_DIR }}"
export WORDPDF_MAX_MB="${{ vars.WORDPDF_MAX_MB }}" WORDPDF_MAX_PAGES="${{ vars.WORDPDF_MAX_PAGES }}"
umask 077
{
echo "PREV_APP=$(podman inspect -f '{{.Image}}' wordpdf-prod-app-1)"
echo "PREV_WEB=$(podman inspect -f '{{.Image}}' wordpdf-prod-web-1)"
} > .rollback.env
./restart.sh --deploy
mkdir -p "$DEPLOY_DIR"
cd "$DEPLOY_DIR"
rm -f restart.sh .env
cat > docker-compose.yml <<COMPOSE
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:$WORDPDF_PORT:80", "$DEPLOY_HOST:$WORDPDF_PORT:80"]
depends_on:
app:
condition: service_healthy
web:
condition: service_healthy
restart: unless-stopped
networks:
# Подсеть зафиксирована намеренно: nginx резолвит app/web через aardvark-dns
# на шлюзе сети ($PROD_GW), адрес обязан быть предсказуемым.
default:
ipam:
config:
- subnet: $PROD_SUBNET
gateway: $PROD_GW
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 $PROD_GW 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:$WORDPDF_PORT/actuator/health" 2>/dev/null && break || sleep 1
done
curl -fsS "http://127.0.0.1:$WORDPDF_PORT/actuator/health"
podman-compose ps
autotests:
runs-on: ubuntu-latest
@@ -182,28 +325,34 @@ jobs:
if: failure()
steps:
- name: Roll back prod to previous images
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:
host: ${{ vars.DEPLOY_HOST }}
username: ${{ vars.DEPLOY_USER }}
key: ${{ secrets.DEPLOY_SSH_KEY }}
script_stop: true
envs: DEPLOY_DIR,REGISTRY,WORDPDF_PORT,WORDPDF_API_KEY
script: |
set -euo pipefail
cd "${{ vars.DEPLOY_DIR }}"
export WORDPDF_MAX_MB="${{ vars.WORDPDF_MAX_MB }}" WORDPDF_MAX_PAGES="${{ vars.WORDPDF_MAX_PAGES }}"
cd "$DEPLOY_DIR"
if [ ! -f .rollback.env ]; then
echo "НЕТ .rollback.env — АВТОМАТИЧЕСКИЙ ОТКАТ НЕВОЗМОЖЕН" >&2
exit 1
fi
. ./.rollback.env
podman tag "$PREV_APP" "${{ vars.REGISTRY }}/wordpdf-app:prod"
podman tag "$PREV_WEB" "${{ vars.REGISTRY }}/wordpdf-web:prod"
podman tag "$PREV_APP" "$REGISTRY/wordpdf-app:prod"
podman tag "$PREV_WEB" "$REGISTRY/wordpdf-web:prod"
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 после отката" >&2; exit 1; }
podman-compose restart gateway
curl -fsS http://127.0.0.1:9010/actuator/health
[ "$(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"