Files
java-word-pdf/docs/agent/ci-cd.md
T
Pjandro f41ac54072
PR checks / web (pull_request) Successful in 35s
PR checks / java (pull_request) Successful in 1m15s
Main: tests, deploy, autotests / web (push) Successful in 31s
Main: tests, deploy, autotests / java (push) Successful in 1m15s
Main: tests, deploy, autotests / images-web (push) Successful in 34s
Main: tests, deploy, autotests / images-app (push) Successful in 43s
Main: tests, deploy, autotests / deploy (push) Successful in 1m41s
Main: tests, deploy, autotests / autotests (push) Successful in 35s
Main: tests, deploy, autotests / rollback (push) Has been skipped
docs(AGENTS): сжать до роутера без дублей, счётчики — в testing.md
2026-11-08 00:57:53 +00:00

3.9 KiB
Raw Blame History

читать при правке workflow'ов, Containerfile'ов или деплоя. Авторитетно наравне с AGENTS.md.

Деплой (прод)

Прод — на пользовательском LAN-сервере (podman + podman-compose, docker-бинарников нет); прод-хост не хранит ни конфигураций, ни секретов: job deploy в main.yml рендерит docker-compose.yml и nginx.conf в директорию деплоя (значения — из Variables, API-ключ — из Secret WORDPDF_API_KEY через окружение деплоя, на диск не пишется), затем login/pull/up -d --force-recreate app web/гейты healthy+image/recreate gateway. Наследие restart.sh и .env деплой удаляет; единственное состояние на проде — .rollback.env (image ID для отката). Перезадеплой — push в main или Run workflow (workflow_dispatch), ручных скриптов нет. Наружный вход — https://pjandro.ru/pdf-converter/.

Job'ы workflow'ов

Два workflow. .gitea/workflows/pr.yml — PR checks (pull_request + workflow_dispatch): job java (temurin 17, кеш ~/.m2, Maven 3.9.16 с dlcdn, mvn -B -s .ci/maven-settings.xml clean verify через зеркало Nexus maven-central (fail-closed проверка Variable MAVEN_MIRROR_URL первым шагом)) → Coverage summary (разбор target/site/jacoco/jacoco.xml python-сниппетом в step summary) → Comment coverage on PR (тот же текст комментарием; создаётся один раз, повторные push обновляют по маркеру <!-- jacoco-coverage -->; continue-on-error). job web (кеш ~/.npm, npm ci → build → lint; setup-node нет — нода берётся с раннера).

.gitea/workflows/main.yml — Main: tests, deploy, autotests (push в main + workflow_dispatch): те же java/web (байт-байт дубль — workflow-файлы самодостаточны, reusable-workflow не вводить) → images-app/images-web (build+push каждого Containerfile в Nexus-реестр ${{ vars.REGISTRY }}, теги prod + immovable sha-<7 символов GITHUB_SHA>; app печётся с --build-arg MAVEN_MIRROR_URL=… (зеркало Nexus в Containerfile); web печётся с --build-arg VITE_BASE=/pdf-converter/; DOCKER_BUILDKIT=0 обязателен — daemon за раннером podman, BuildKit-сессий нет; креды — вручную пишется ~/.docker/config.json) → deploy (SSH на прод: рендер конфигов heredoc'ами в workspace раннера — appleboy/ssh-action непригоден, ломает heredoc; валидация PyYAML; прод-стек — подсеть 10.112.0.0/24 gw 10.112.0.1 (в репо-compose.yml — 10.113.0.0/24, стенды разные), gateway биндится на 127.0.0.1:9010 + $DEPLOY_HOST:9010, nginx.conf — с resolver 10.112.0.1; сохранение .rollback.env; login/pull/timeout 90 podman-compose up -d --force-recreate app web; гейты healthy и image; gateway пересоздаётся последним; health-check) → autotests (venv + prod-autotests/ против прода) → rollback (if: failure() — перерендер/перезалив прод-файлов тем же шагом, retag прежних image ID на :prod, --force-recreate app web, пересоздание gateway).

Артефактов покрытия нет намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на этом стенде зависает. HTML-отчёт — локально target/site/jacoco/, web (кеш ~/.npm).