Containerfile.test получает ARG SUREFIRE_OS_NAME (пусто — прежнее поведение), pr.yml — job macos-sim: тот же mvn clean verify с -Dos.name='Mac OS X' (docx4j PhysicalFonts читает os.name и уходит в MicrosoftFontsRegistry). Регрессия strictOoxml ловится до мержа. Документация: AGENTS.md, docs/agent/ci-cd.md.
5.2 KiB
читать при правке 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 (fail-closed проверка Variable MAVEN_MIRROR_URL первым шагом → единственный прогон mvn -B clean verify внутри образа Containerfile.test — без fontconfig, набор тестов никогда не исполняется на хосте с fontconfig; DOCKER_BUILDKIT=0 обязателен — daemon за раннером podman, BuildKit-сессий нет; зеркало Nexus приходит --build-arg → извлечение двух jacoco.xml из образа wordpdf-verify:ci шагами docker create/docker cp || true — при непрошедшей сборке пустая сводка, тесты не затронуты) → Coverage summary (разбор извлечённого target/site/jacoco/jacoco.xml python-сниппетом в step summary) → Comment coverage on PR (тот же текст комментарием; создаётся один раз, повторные push обновляют по маркеру <!-- jacoco-coverage -->; continue-on-error). job macos-sim — тот же образ Containerfile.test, собранный с --build-arg SUREFIRE_OS_NAME="Mac OS X" (эмуляция macOS: единственный хост-зависимый код — docx4j PhysicalFonts, читающий os.name; внутри образа набор исполняется дважды — сначала verify без флага догревает локальный репозиторий до нуля загрузок, затем verify с флагом, т.к. Linux-JVM с os.name=Mac OS X падает AssertionError на первом же сетевом сокете; шагов JaCoCo/комментария нет — дублировали бы java), в main.yml отсутствует намеренно. 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).