From fca253b9f5df3668cc09ac498e284c99883a09dc Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 21 Nov 2026 03:19:09 +0300 Subject: [PATCH] =?UTF-8?q?ci:=20job=20macos-sim=20=E2=80=94=20=D1=82?= =?UTF-8?q?=D0=B5=D1=81=D1=82=D1=8B=20=D0=BF=D0=BE=D0=B4=20=D1=8D=D0=BC?= =?UTF-8?q?=D1=83=D0=BB=D1=8F=D1=86=D0=B8=D0=B5=D0=B9=20macOS=20(-Dos.name?= =?UTF-8?q?)=20=D0=BD=D0=B0=20PR?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit 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. --- .gitea/workflows/pr.yml | 25 +++++++++++++++++++++++++ AGENTS.md | 4 ++-- Containerfile.test | 17 ++++++++++++++++- docs/agent/ci-cd.md | 2 +- 4 files changed, 44 insertions(+), 4 deletions(-) diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index aa3d135..087cdd5 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -104,6 +104,31 @@ jobs: f"{base}/{existing}" if existing else base, {"body": body}) PY + macos-sim: + runs-on: ubuntu-latest + steps: + - uses: actions/checkout@v5 + + - name: Check maven mirror var + env: + MAVEN_MIRROR_URL: ${{ vars.MAVEN_MIRROR_URL }} + run: | + [ -n "$MAVEN_MIRROR_URL" ] || { + echo "Задайте Actions Variable MAVEN_MIRROR_URL — см. GITEA-vars.md" >&2 + exit 1 + } + + - name: Tests under macOS emulation (-Dos.name) + 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" \ + --build-arg "SUREFIRE_OS_NAME=Mac OS X" \ + -t wordpdf-verify:macos-sim \ + . + web: runs-on: ubuntu-latest steps: diff --git a/AGENTS.md b/AGENTS.md index cc704ce..bfe417e 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -101,7 +101,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources |`wordpdf-app/src/main/resources/application.properties`|multipart 100MB/100MB (зеркалит nginx `client_max_body_size`) + `file-size-threshold=2MB` (сброс больших частей на диск — защита от OOM), `convert-timeout=2m`, `api-key=` (пусто = auth off), `forward-headers-strategy=framework`; `wordpdf.max-mb`/`max-pages` здесь **не объявлять намеренно** — пустое значение затенит `@Value`-дефолты 5/100 (≤ 0 на старте → `IllegalStateException`)| |`wordpdf-core/pom.xml` / `wordpdf-app/pom.xml`|execution `test-jar`; BRANCH-гейт 0.85 (только core); exclusion `slf4j-simple`; Boot-4 имена: `spring-boot-starter-webmvc` (не `-web`), отдельный `spring-boot-webmvc-test`; `repackage` привязан явно| |`Containerfile` / `Containerfile.test` / `compose*.yml` / `gateway/nginx.conf`|прод-образ (heap 2G, mem_limit 3G, wget-healthcheck, FQDN FROM, non-root 10001, обнуление прокси на команде) / CI-гейт без fontconfig / стенды :9010–:9011 / шлюз. Нюанс: repo `compose.yml` (prod-like) гасит springdoc env-ами, а реальный прод из CI-рендера держит swagger открытым (`test_swagger_ui_open_without_key`) — не путать| -|`.gitea/workflows/pr.yml`, `main.yml`, `.ci/maven-settings.xml`|CI: jobs `java`/`web` в обоих — идентичные шаги; `main.yml`: `images-* → deploy → autotests (+ rollback при failure)`; Maven в CI живёт в контейнере `maven:3.9-eclipse-temurin-17`; зеркало `${env.MAVEN_MIRROR_URL}`, `mirrorOf="*"`| +|`.gitea/workflows/pr.yml`, `main.yml`, `.ci/maven-settings.xml`|CI: jobs `java`/`web` в обоих — идентичные шаги, в `pr.yml` дополнительно `macos-sim` (те же тесты с `--build-arg SUREFIRE_OS_NAME="Mac OS X"`, только на PR); `main.yml`: `images-* → deploy → autotests (+ rollback при failure)`; Maven в CI живёт в контейнере `maven:3.9-eclipse-temurin-17`; зеркало `${env.MAVEN_MIRROR_URL}`, `mirrorOf="*"`| |`wordpdf-web/src/api.ts`, `vite.config.ts`|вся сеть SPA; `base` — только через env `VITE_BASE` (в прод-образ запекается `--build-arg VITE_BASE=/pdf-converter/`)| ## Runtime/Tooling Preferences @@ -111,7 +111,7 @@ python3 docs/standards/docx/validate-fixtures.py wordpdf-core/src/test/resources - Веб: только npm (`package-lock.json` закоммичен; никаких pnpm/yarn); линтер — oxlint (не eslint). - Контейнеры: podman/buildah; `FROM` только FQDN; хостовые прокси-переменные обнулять на самой команде в `RUN`/`HEALTHCHECK`; `DOCKER_BUILDKIT=0` (CI); healthcheck через wget, не curl; fontconfig рантайму не нужен (глифы — fontbox); alpine-теги maven/temurin amd64-only — тестовый образ на Debian-базе. - Сеть: наружу публикуется только gateway (9010/9011); 8080/80 наружу не выставлять; подсети compose зафиксированы (nginx `resolver` привязан literal-ом к шлюзу сети — 10.113.0.1 стенды / 10.112.0.1 прод). -- Прод-стек (`docker-compose.yml`, `nginx.conf`) рендерится job'ом `deploy` из Variables — копий на хосте/в репо не заводить; required-контексты защиты `main` — буквально `PR checks / java (pull_request)`, `PR checks / web (pull_request)` (deploy/autotests не включать). +- Прод-стек (`docker-compose.yml`, `nginx.conf`) рендерится job'ом `deploy` из Variables — копий на хосте/в репо не заводить; required-контексты защиты `main` — буквально `PR checks / java (pull_request)`, `PR checks / web (pull_request)`, `PR checks / macos-sim (pull_request)` (deploy/autotests не включать). ## Testing & QA diff --git a/Containerfile.test b/Containerfile.test index a5eb538..9bc6402 100644 --- a/Containerfile.test +++ b/Containerfile.test @@ -42,4 +42,19 @@ COPY wordpdf-core/pom.xml wordpdf-core/ COPY wordpdf-app/pom.xml wordpdf-app/ RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= mvn -B -q dependency:go-offline COPY . . -RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= mvn -B clean verify +# Эмуляция чужой ОС в fork-нутом surefire-JVM: пусто (дефолт) — прежнее +# поведение (одна команда mvn, байт-в-байт как раньше); job `macos-sim` передаёт +# "Mac OS X" (docx4j PhysicalFonts читает os.name и уходит в +# MicrosoftFontsRegistry.getMsFonts()). +# Флаг на команде mvn попадает и в саму Maven-JVM: в Linux-JDK нет +# jdk/net/MacOSXSocketOptions, и первая же сетевая загрузка (surefire-провайдер, +# optional-зависимости, PMD-скин — всё, что НЕ закрыто dependency:go-offline) +# упала бы AssertionError на создании сокета. Поэтому при непустом флаге первым +# проходит полный verify БЕЗ флага — он догревает локальный репозиторий до нуля +# загрузок, и второй verify с флагом уже не открывает сокетов вовсе. Пустой флаг +# = один verify, прежний путь. +ARG SUREFIRE_OS_NAME= +RUN echo "SUREFIRE_OS_NAME=[${SUREFIRE_OS_NAME}]" && \ + HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= \ + sh -c '[ -z "$SUREFIRE_OS_NAME" ] || mvn -B -q clean verify || exit 1; \ + exec mvn -B clean verify ${SUREFIRE_OS_NAME:+-Dos.name="$SUREFIRE_OS_NAME"}' diff --git a/docs/agent/ci-cd.md b/docs/agent/ci-cd.md index e6325b3..94a85db 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` (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` **нет** — нода берётся с раннера). +Два 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 `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). -- 2.56.1