From b9ce970d2603c9d35d85878a29a930d85850f299 Mon Sep 17 00:00:00 2001 From: Pjandro Date: Sat, 24 Oct 2026 18:54:53 +0000 Subject: [PATCH] =?UTF-8?q?CI:=20=D0=BF=D0=BE=D0=BA=D1=80=D1=8B=D1=82?= =?UTF-8?q?=D0=B8=D0=B5=20=E2=80=94=20=D0=BA=D0=BE=D0=BC=D0=BC=D0=B5=D0=BD?= =?UTF-8?q?=D1=82=D0=B0=D1=80=D0=B8=D0=B5=D0=BC=20=D0=B2=20PR=20=D0=B2?= =?UTF-8?q?=D0=BC=D0=B5=D1=81=D1=82=D0=BE=20=D0=B0=D1=80=D1=82=D0=B5=D1=84?= =?UTF-8?q?=D0=B0=D0=BA=D1=82=D0=BE=D0=B2=20(artifact-=D1=81=D0=B5=D1=80?= =?UTF-8?q?=D0=B2=D0=B5=D1=80=20Gitea=20=D0=BD=D0=B5=D0=BF=D1=80=D0=B8?= =?UTF-8?q?=D0=B3=D0=BE=D0=B4=D0=B5=D0=BD)?= MIME-Version: 1.0 Content-Type: text/plain; charset=UTF-8 Content-Transfer-Encoding: 8bit upload-artifact@v4 не поддерживается, @v3 на этом стенде висит на загрузке (run 508 — 153 файла, run 509 — один zip; оба отменены в полёте). Вместо артефактов: Coverage summary пишет coverage-summary.md (он же в step summary), Comment coverage on PR постит/обновляет комментарий в PR по маркеру (continue-on-error). Шаг продублирован в main.yml байт-в-байт, там if не срабатывает. HTML — локально target/site/jacoco. --- .gitea/workflows/main.yml | 55 ++++++++++++++++++++++++--------------- .gitea/workflows/pr.yml | 55 ++++++++++++++++++++++++--------------- AGENTS.md | 16 +++++++----- 3 files changed, 78 insertions(+), 48 deletions(-) diff --git a/.gitea/workflows/main.yml b/.gitea/workflows/main.yml index cc4044e..37508c8 100644 --- a/.gitea/workflows/main.yml +++ b/.gitea/workflows/main.yml @@ -35,7 +35,7 @@ jobs: - name: Coverage summary if: always() run: | - python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + python3 - <<'PY' > coverage-summary.md import os import xml.etree.ElementTree as ET def pct(root, kind): @@ -44,6 +44,7 @@ jobs: missed, covered = int(c.get("missed")), int(c.get("covered")) return f"{100.0 * covered / (missed + covered):.1f}%" return "—" + print("") print("## Покрытие (JaCoCo)\n") print("| Модуль | Строки | Ветви | Порог строк |") print("|---|---|---|---|") @@ -55,30 +56,42 @@ jobs: r = ET.parse(p).getroot() print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY" - # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: - # v1 грузит каждый файл отдельным запросом — поштучно это минуты; - # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary - - name: Pack coverage reports - if: always() + # Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run. + # Повторные push обновляют тот же комментарий (поиск по маркеру), + # github.token — task-токен раннера, падение не валит job. Артефактов с + # отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на + # этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip); + # HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих + # workflow, в main.yml if не срабатывает — нет PR-события + - name: Comment coverage on PR + if: always() && github.event_name == 'pull_request' + continue-on-error: true + env: + GITEA_TOKEN: ${{ github.token }} + API: ${{ github.api_url }} + REPO: ${{ github.repository }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | + [ -s coverage-summary.md ] || exit 0 python3 - <<'PY' - import os, zipfile - with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: - for m in ("wordpdf-core", "wordpdf-app"): - d = f"{m}/target/site/jacoco" - for root, _, files in os.walk(d): - for f in files: - p = os.path.join(root, f) - z.write(p, p) + import json, os, urllib.request + api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"] + token = os.environ["GITEA_TOKEN"] + body = open("coverage-summary.md").read() + def req(method, url, payload=None): + data = json.dumps(payload).encode() if payload is not None else None + r = urllib.request.Request(url, data=data, method=method, + headers={"Authorization": f"token {token}", + "Content-Type": "application/json"}) + return json.loads(urllib.request.urlopen(r).read() or "null") + base = f"{api}/repos/{repo}/issues/{pr}/comments" + existing = next((c["id"] for c in req("GET", base) + if "" in c.get("body", "")), None) + req("PATCH" if existing else "POST", + f"{base}/{existing}" if existing else base, {"body": body}) PY - - name: Upload coverage reports - if: always() - uses: actions/upload-artifact@v3 - with: - name: jacoco-html - path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/.gitea/workflows/pr.yml b/.gitea/workflows/pr.yml index e14b021..6cb3b02 100644 --- a/.gitea/workflows/pr.yml +++ b/.gitea/workflows/pr.yml @@ -34,7 +34,7 @@ jobs: - name: Coverage summary if: always() run: | - python3 - <<'PY' >> "$GITHUB_STEP_SUMMARY" + python3 - <<'PY' > coverage-summary.md import os import xml.etree.ElementTree as ET def pct(root, kind): @@ -43,6 +43,7 @@ jobs: missed, covered = int(c.get("missed")), int(c.get("covered")) return f"{100.0 * covered / (missed + covered):.1f}%" return "—" + print("") print("## Покрытие (JaCoCo)\n") print("| Модуль | Строки | Ветви | Порог строк |") print("|---|---|---|---|") @@ -54,30 +55,42 @@ jobs: r = ET.parse(p).getroot() print(f"| {m} | {pct(r, 'LINE')} | {pct(r, 'BRANCH')} | 90% |") PY + cat coverage-summary.md >> "$GITHUB_STEP_SUMMARY" - # v3, не v4: артефакт-сервер Gitea говорит по протоколу actions/artifact v1, - # v4+ падает «not currently supported on GHES». Один zip вместо ~150 файлов: - # v1 грузит каждый файл отдельным запросом — поштучно это минуты; - # python3 (не zip) — гарантирован на раннере, см. шаг Coverage summary - - name: Pack coverage reports - if: always() + # Таблица покрытия — комментарием в PR: видно в обсуждении, не открывая run. + # Повторные push обновляют тот же комментарий (поиск по маркеру), + # github.token — task-токен раннера, падение не валит job. Артефактов с + # отчётами НЕТ намеренно: upload-artifact@v4 Gitea не поддерживает, @v3 на + # этом стенде висит на загрузке (отменена и с 153 файлами, и с одним zip); + # HTML — локально в target/site/jacoco. Шаг байт-в-байт одинаков в обоих + # workflow, в main.yml if не срабатывает — нет PR-события + - name: Comment coverage on PR + if: always() && github.event_name == 'pull_request' + continue-on-error: true + env: + GITEA_TOKEN: ${{ github.token }} + API: ${{ github.api_url }} + REPO: ${{ github.repository }} + PR_NUMBER: ${{ github.event.pull_request.number }} run: | + [ -s coverage-summary.md ] || exit 0 python3 - <<'PY' - import os, zipfile - with zipfile.ZipFile("jacoco-html.zip", "w", zipfile.ZIP_DEFLATED) as z: - for m in ("wordpdf-core", "wordpdf-app"): - d = f"{m}/target/site/jacoco" - for root, _, files in os.walk(d): - for f in files: - p = os.path.join(root, f) - z.write(p, p) + import json, os, urllib.request + api, repo, pr = os.environ["API"], os.environ["REPO"], os.environ["PR_NUMBER"] + token = os.environ["GITEA_TOKEN"] + body = open("coverage-summary.md").read() + def req(method, url, payload=None): + data = json.dumps(payload).encode() if payload is not None else None + r = urllib.request.Request(url, data=data, method=method, + headers={"Authorization": f"token {token}", + "Content-Type": "application/json"}) + return json.loads(urllib.request.urlopen(r).read() or "null") + base = f"{api}/repos/{repo}/issues/{pr}/comments" + existing = next((c["id"] for c in req("GET", base) + if "" in c.get("body", "")), None) + req("PATCH" if existing else "POST", + f"{base}/{existing}" if existing else base, {"body": body}) PY - - name: Upload coverage reports - if: always() - uses: actions/upload-artifact@v3 - with: - name: jacoco-html - path: jacoco-html.zip web: runs-on: ubuntu-latest diff --git a/AGENTS.md b/AGENTS.md index b10cce7..bba424b 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -58,7 +58,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр |`wordpdf-web/src/`|SPA (React 19 + TS + Vite + Tailwind): `api.ts` (вся сеть), `components/` (App, ApiKeyGate, PdfPreview, StatusMessage, DropZone, Logo)| |корневые `Containerfile`, `compose.yml`, `compose.dev.yml`, `gateway/nginx.conf`|образ бэкенда (multi-stage maven:3.9-temurin-21 → temurin-**21-jre-alpine** (musl) — chart-движку нужен только модуль java.desktop (Graphics2D, он внутри JRE); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont` (проверено на musl-стенде без libfontconfig/`/etc/fonts`); HEALTHCHECK busybox `wget` (curl/apt не ставим), non-root uid 10001); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose не в репо — его рендерит job `deploy` (лимиты запекаются из Variables); podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет; app-хелсчеки — `wget`, как в Containerfile), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)| |корневой `.env.example`|шаблон env для локальных/compose-стендов: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); проду `.env` **не нужен**: ключ и лимиты подаёт job `deploy` из Gitea Secrets/Variables, legacy-`.env` на проде удаляется деплоем| -|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка/артефакты JaCoCo → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| +|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты + coverage-сводка и комментарий в PR → `images-app`/`images-web` (build+push в Nexus) → deploy (рендер прод-конфигов + pull) → autotests → rollback)| |корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений| |корневой `prod-autotests/`|прод-автотесты API (pytest + requests, 21 проверка): конфигурация стенда **только env** (`WORDPDF_BASE_URL` обязателен, `WORDPDF_API_KEY`/`WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB`/`WORDPDF_SAMPLES_DIR` факультативны) — прод-хостов/ключей в коде нет; окружение — mise (`mise.toml`: python 3.15 + автосоздаваемый `.venv`); прод-раннер вне git — `/home/pjandro/prod/java-word-pdf/run-prod-tests.sh`| |`develop/` (вне git, gitignored)|рабочие материалы и эталоны Word для ручного сравнения — **не фикстуры**, в тесты/jar не подключать; на 2026-10 директория пуста (эталоны вынесены, пиксельные замеры зашиты числами в chart-тестах)| @@ -91,11 +91,15 @@ java -cp wordpdf-core/target/test-classes:$(cat /tmp/cp.txt) \ Два workflow. `.gitea/workflows/pr.yml` — `PR checks` (`pull_request` + `workflow_dispatch`): job `java` (temurin 21, кеш `~/.m2` через `actions/cache`, Maven 3.9.16 ставится вручную с dlcdn, `mvn -B clean verify`, -затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в лог job'а и -`Pack coverage reports` (python3 `zipfile` — один `jacoco-html.zip`) и `actions/upload-artifact@v3` -артефактом `jacoco-html`; именно v3 и именно один zip — артефакт-сервер Gitea не понимает протокол -v4 («not currently supported on GHES»), а v1 грузит каждый файл отдельным запросом (~150 HTML-файлов -поштучно = минуты простоя)) +затем `Coverage summary` — разбор `target/site/jacoco/jacoco.xml` python-сниппетом в файл +`coverage-summary.md` + step summary job'а и `Comment coverage on PR` — тот же текст +комментарием в PR (создаётся один раз, повторные push обновляют по маркеру +``; `continue-on-error` — падение комментария не валит job; +в `main.yml` шаг продублирован байт-в-байт, но `if: github.event_name == 'pull_request'` +там не срабатывает). **Артефактов покрытия нет намеренно**: `upload-artifact@v4` Gitea +не поддерживает («not currently supported on GHES»), `@v3` на этом стенде зависает на +загрузке (проверено: отменена и с ~150 файлов, и с одним zip); HTML-отчёт — локально +`target/site/jacoco/`) и `web` (кеш `~/.npm`, `npm ci`/`build`/`lint`). `.gitea/workflows/main.yml` — `Main: tests, deploy, autotests` (`push` в `main` + `workflow_dispatch`): те же `java`/`web` (байт-в-байт дубль — файлы самодостаточны, reusable-workflow не вводить), затем `images-app`/`images-web`