Files
java-word-pdf/docs/agent/ci-cd.md
T
Pjandro 8529b6877b
PR checks / web (pull_request) Successful in 38s
PR checks / java (pull_request) Successful in 18m31s
Слияние docx4j 17.3.5 в wordpdf-core и форк FO-рендерера 2.11-docx4j.8 в реактор
- wordpdf-core/src/main/java впитаны исходники docx4j-core, -export-fo,
  -chart-render, -JAXB-ReferenceImpl, -copy, -generated-objects (17.3.5) +
  сгенерированная XJC JAXB-модель; ресурсы — тем же путём; артефакты группы
  org.docx4j из внешних репозиториев больше не подключаются
- vendor/fop: форк docx4j-fo-renderer 2.11-docx4j.8 (util/events/core/fop)
  собирается в реакторе вместо jar из Nexus
- docx2fo.xslt перевендорен со стилем 17.3.5, оба AUDIT-FIX-патча перенесены;
  дрейф-гейт vendoredXsltTracksJarCopy зелёный
- upstream-тесты docx4j перенесены в src/test/java/org (658 классов, вне гейта);
  execution upstream-docx4j-tests в профиле upstream-tests (./mise.sh run
  upstream-tests, в pr.yml non-blocking шаг): 3470 тестов, 3457 зелёных,
  13 красных — категории окружения/калибровки хоста и следствий слияния
  classpath задокументированы в docs/agent/testing.md
- surefire: провайдер SLF4J фиксируется коротким slf4j.provider по execution;
  перенесён upstream logback.xml (root=DEBUG без конфига ломает visitor-экспорт
  VML); upstream-форки пинят JDK JAXP-фабрики; PMD/JaCoCo исключают org/**
- wordpdf-app: без изменений кода (зависит от слитого ядра); тесты 44/44
- документация синхронизирована (AGENTS.md, README, docs/agent/*), mise task
  upstream-tests
2026-11-08 02:54:49 +00:00

4.2 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 по хешу pom'ов включая vendor/fop/pom.xml, Maven 3.9.16 с dlcdn, mvn -B -s .ci/maven-settings.xml clean verify через зеркало Nexus maven-central (fail-closed проверка Variable MAVEN_MIRROR_URL первым шагом)) → Upstream docx4j tests (-pl wordpdf-core -am test -Pupstream-tests, if: always() + continue-on-error — отчёт о состоянии перенесённого набора, не гейт: часть тестов красна из-за окружения/наследия) → 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).