diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index 2cd46f2..e217dbd 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -20,38 +20,30 @@ jobs: exit 1 } - - name: Setup JDK 17 - uses: actions/setup-java@v5 - with: - java-version: '17' - distribution: 'temurin' - - - name: Cache Maven repository - uses: actions/cache@v4 - with: - path: ~/.m2/repository - key: maven-${{ hashFiles('pom.xml', 'wordpdf-core/pom.xml', 'wordpdf-app/pom.xml') }} - restore-keys: maven- - - - name: Setup Maven 3.9.16 - run: | - curl -fsSL https://dlcdn.apache.org/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz | tar xz -C /opt - echo "/opt/apache-maven-3.9.16/bin" >> "$GITHUB_PATH" - - - name: Build and test (PMD gate included) - env: - MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }} - run: mvn -B -s .ci/maven-settings.xml clean verify - - - name: Build and test without fontconfig + - name: Build and test without fontconfig (PMD+JaCoCo included) env: MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }} run: | DOCKER_BUILDKIT=0 docker build \ -f Containerfile.test \ --build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \ + -t wordpdf-verify:ci \ . + - name: Extract JaCoCo reports + if: always() + run: | + id=$(docker create wordpdf-verify:ci 2>/dev/null) || { + echo "образ не собран — сводка покрытия будет пустой" + exit 0 + } + mkdir -p wordpdf-core/target/site/jacoco wordpdf-app/target/site/jacoco + docker cp "$id:/build/wordpdf-core/target/site/jacoco/jacoco.xml" \ + wordpdf-core/target/site/jacoco/jacoco.xml || true + docker cp "$id:/build/wordpdf-app/target/site/jacoco/jacoco.xml" \ + wordpdf-app/target/site/jacoco/jacoco.xml || true + docker rm "$id" >/dev/null + - name: Coverage summary if: always() run: | diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index 53cab2c..aa3d135 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -19,38 +19,30 @@ jobs: exit 1 } - - name: Setup JDK 17 - uses: actions/setup-java@v5 - with: - java-version: '17' - distribution: 'temurin' - - - name: Cache Maven repository - uses: actions/cache@v4 - with: - path: ~/.m2/repository - key: maven-${{ hashFiles('pom.xml', 'wordpdf-core/pom.xml', 'wordpdf-app/pom.xml') }} - restore-keys: maven- - - - name: Setup Maven 3.9.16 - run: | - curl -fsSL https://dlcdn.apache.org/maven/maven-3/3.9.16/binaries/apache-maven-3.9.16-bin.tar.gz | tar xz -C /opt - echo "/opt/apache-maven-3.9.16/bin" >> "$GITHUB_PATH" - - - name: Build and test (PMD gate included) - env: - MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }} - run: mvn -B -s .ci/maven-settings.xml clean verify - - - name: Build and test without fontconfig + - name: Build and test without fontconfig (PMD+JaCoCo included) env: MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }} run: | DOCKER_BUILDKIT=0 docker build \ -f Containerfile.test \ --build-arg MAVEN_MIRROR_URL="$MAVEN_MIRROR_URL" \ + -t wordpdf-verify:ci \ . + - name: Extract JaCoCo reports + if: always() + run: | + id=$(docker create wordpdf-verify:ci 2>/dev/null) || { + echo "образ не собран — сводка покрытия будет пустой" + exit 0 + } + mkdir -p wordpdf-core/target/site/jacoco wordpdf-app/target/site/jacoco + docker cp "$id:/build/wordpdf-core/target/site/jacoco/jacoco.xml" \ + wordpdf-core/target/site/jacoco/jacoco.xml || true + docker cp "$id:/build/wordpdf-app/target/site/jacoco/jacoco.xml" \ + wordpdf-app/target/site/jacoco/jacoco.xml || true + docker rm "$id" >/dev/null + - name: Coverage summary if: always() run: | diff --git a/AGENTS.md b/AGENTS.md index 01b922c..62bc51c 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -68,6 +68,7 @@ Java2D → PNG: `ChartRenderer.DPI = 300`, потолок `MAX_PIXELS = 16_777_2 ```bash ./mise.sh run verify # = mvn clean verify: тесты + PMD + JaCoCo (гейт перед push) mvn clean verify # то же; mvnw НЕТ — только системный Maven +./mise.sh run verify-nofontconfig # тот же полный verify в контейнере без fontconfig (именно так живёт CI) mvn -pl wordpdf-core test -Dtest=WordPdfConverterTest#pageNumbers_recomputedNotCached # один тест mvn -pl wordpdf-app -am test -Dtest=ConvertControllerTest#convertSample_returnsPdf # -am: core test-jar mvn -pl wordpdf-app -am package # исполняемый jar бэкенда @@ -79,7 +80,7 @@ podman-compose -f compose.dev.yml up -d --build --force-recreate # dev-стен python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources/samples/*.docx # XSD (lxml) ``` -Задачи mise (8): `verify`, `app-package`, `app-run`, `web-install`, `web-build`, `web-lint`, `web-dev`, `prod-tests`. +Задачи mise (9): `verify`, `verify-nofontconfig`, `app-package`, `app-run`, `web-install`, `web-build`, `web-lint`, `web-dev`, `prod-tests`. **«Запусти тестовый сервер» (термин пользователя)** = полный dev-стенд, НЕ `java -jar`: `podman-compose -f compose.dev.yml up -d --build --force-recreate`, вход `http://:9011` без API-ключа; гейт — контейнеры healthy + корень SPA отвечает 200. `--force-recreate` обязателен: без него контейнеры остаются на старом образе. @@ -109,7 +110,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources ## CI/CD (Gitea Actions) -`pr.yml` (`PR checks`): job `java` (`mvn -B -s .ci/maven-settings.xml clean verify` через Nexus) + coverage-сводка и комментарий в PR, job `web` (`npm ci` → build → lint). `main.yml`: `java`/`web` → `images-app`/`images-web` (build+push в Nexus, теги `prod` + `sha-<7>`) → `deploy` (SSH, рендер прод-конфигов, гейты healthy) → `autotests` → `rollback` при провале. Нарратив — `docs/agent/ci-cd.md`. +`pr.yml` (`PR checks`): job `java` (единственный полный `mvn clean verify` внутри образа `Containerfile.test` — без fontconfig, зеркало Nexus через build-arg) + извлечение `jacoco.xml` из образа (`docker create`/`docker cp`) + coverage-сводка и комментарий в PR, job `web` (`npm ci` → build → lint). `main.yml`: `java`/`web` → `images-app`/`images-web` (build+push в Nexus, теги `prod` + `sha-<7>`) → `deploy` (SSH, рендер прод-конфигов, гейты healthy) → `autotests` → `rollback` при провале. Нарратив — `docs/agent/ci-cd.md`. Защита ветки `main`: required-контексты — **`PR checks / java (pull_request)`**, **`PR checks / web (pull_request)`** (deploy/autotests в список не включать — на PR не бегут). Смена лимитов стенда = правка Variables, PR не нужен. diff --git a/Containerfile.test b/Containerfile.test index 869b323..a5eb538 100644 --- a/Containerfile.test +++ b/Containerfile.test @@ -1,6 +1,8 @@ -# Тестовый образ «без fontconfig»: mvn clean verify там, где AWT-менеджер -# шрифтов недоступен (нет libfontconfig и /etc/fonts). На хостах с fontconfig -# ветка деградации OMML не исполняется — этот образ её прогоняет всегда. +# Тестовый образ «без fontconfig»: единственный полный прогон mvn clean verify +# (тесты + PMD + JaCoCo) там, где AWT-менеджер шрифтов недоступен (нет +# libfontconfig и /etc/fonts). В CI хостовый mvn не запускается вовсе — набор +# тестов никогда не исполняется на хосте с fontconfig. Локально сырой +# `mvn clean verify` (mise-задача verify) — хост-гейт без docker/podman. # База — maven:3.9-eclipse-temurin-17, а не alpine: alpine-теги maven/temurin # публикуются только под amd64, на arm64-хосте образ не собрать. FROM docker.io/library/maven:3.9-eclipse-temurin-17 diff --git a/README.md b/README.md index 00eebc4..4eb633f 100644 --- a/README.md +++ b/README.md @@ -76,6 +76,7 @@ powershell -ExecutionPolicy Bypass -File .\bootstrap.ps1 # Windows |Задача|Содержание| |---|---| |`verify`|`mvn clean verify` — тесты + PMD + JaCoCo| +|`verify-nofontconfig`|`mvn clean verify` в контейнере без fontconfig (гейт CI; требует podman/docker)| |`app-package`|исполняемый jar бэкенда| |`app-run`|бэкенд на :8080, ключ выключен (после `app-package`)| |`web-install`|`npm ci` в `wordpdf-web`| @@ -346,7 +347,7 @@ API (`wordpdf-app`) проверяется `MockMvc`-сквозняками (`Co ## CI/CD и деплой -- Pull request → Gitea Actions (`pr.yml`): Java — `mvn clean verify` + сводка покрытия комментарием в PR; Web — `npm ci`, build, lint. +- Pull request → Gitea Actions (`pr.yml`): Java — единственный `mvn clean verify` в контейнере без fontconfig + сводка покрытия комментарием в PR; Web — `npm ci`, build, lint. - Push в `main` → `main.yml`: тесты → сборка и push образов `wordpdf-app`/`wordpdf-web` в реестр → deploy (job рендерит прод-конфиги, `podman-compose pull && up -d --force-recreate`, health-гейты, автооткат при провале) → prod-автотесты против живого стенда. - Координаты прод-сервера и креды вне репозитория — Gitea Actions Variables/Secrets (настройка: `GITEA-vars.md`). Наружный вход стенда — путь `/pdf-converter/` за пользовательским nginx. - Локальный прогон prod-автотестов (задача `prod-tests`: `pip install` diff --git a/docs/agent/ci-cd.md b/docs/agent/ci-cd.md index 0977365..e6325b3 100644 --- a/docs/agent/ci-cd.md +++ b/docs/agent/ci-cd.md @@ -6,7 +6,7 @@ ### 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 обновляют по маркеру ``; `continue-on-error`). job `web` (кеш `~/.npm`, `npm ci` → `build` → `lint`; `setup-node` **нет** — нода берётся с раннера). +Два 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 обновляют по маркеру ``; `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). diff --git a/mise.toml b/mise.toml index 3fe799e..e714a24 100644 --- a/mise.toml +++ b/mise.toml @@ -15,7 +15,7 @@ description = "mvn clean verify — полный гейт перед push (те run = "mvn clean verify" [tasks.verify-nofontconfig] -description = "mvn clean verify в контейнере без fontconfig (нет libfontconfig и /etc/fonts)" +description = "mvn clean verify в контейнере без fontconfig (гейт, которым живёт CI; verify — хост-гейт без контейнера)" run = "podman build -f Containerfile.test ." [tasks.app-package]