CI: единственный прогон тестов в контейнере без fontconfig
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Successful in 1m16s
Main: tests, deploy, autotests / java (push) Successful in 38s
Main: tests, deploy, autotests / web (push) Successful in 41s
Main: tests, deploy, autotests / images-web (push) Successful in 35s
Main: tests, deploy, autotests / images-app (push) Successful in 47s
Main: tests, deploy, autotests / deploy (push) Successful in 1m59s
Main: tests, deploy, autotests / autotests (push) Successful in 44s
Main: tests, deploy, autotests / rollback (push) Has been skipped
PR checks / web (pull_request) Successful in 40s
PR checks / java (pull_request) Successful in 1m16s
Main: tests, deploy, autotests / java (push) Successful in 38s
Main: tests, deploy, autotests / web (push) Successful in 41s
Main: tests, deploy, autotests / images-web (push) Successful in 35s
Main: tests, deploy, autotests / images-app (push) Successful in 47s
Main: tests, deploy, autotests / deploy (push) Successful in 1m59s
Main: tests, deploy, autotests / autotests (push) Successful in 44s
Main: tests, deploy, autotests / rollback (push) Has been skipped
Хостовые Setup JDK/Maven/кеш~/.m2 и mvn на раннере убраны: полный mvn clean verify (тесты + PMD + JaCoCo) исполняется только в образе Containerfile.test (без libfontconfig и /etc/fonts). Отчёты JaCoCo извлекаются из образа docker create/cp (отсутствие отчёта — пустая сводка, не падение). mise verify остаётся сырым mvn без docker/podman.
This commit was merged in pull request #103.
This commit is contained in:
+16
-24
@@ -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: |
|
||||
|
||||
+16
-24
@@ -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: |
|
||||
|
||||
@@ -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://<LAN-IP хоста>: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 не нужен.
|
||||
|
||||
|
||||
+5
-3
@@ -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
|
||||
|
||||
@@ -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`
|
||||
|
||||
+1
-1
@@ -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 обновляют по маркеру `<!-- jacoco-coverage -->`; `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 обновляют по маркеру `<!-- 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).
|
||||
|
||||
|
||||
@@ -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]
|
||||
|
||||
Reference in New Issue
Block a user