upload-artifact@v4 не поддерживается, @v3 на этом стенде висит на загрузке
(run 508 — 153 файла, run 509 — один zip; оба отменены в полёте). Вместо
артефактов: Coverage summary пишет coverage-summary.md (он же в step
summary), Comment coverage on PR постит/обновляет комментарий в PR по
маркеру <!-- jacoco-coverage --> (continue-on-error). Шаг продублирован в
main.yml байт-в-байт, там if не срабатывает. HTML — локально
target/site/jacoco.
docx4j падает на внедрённых OLE-объектах двумя путями: JAXB-парсинг
бинарника под ложным XML-типом в [Content_Types] («Content is not
allowed in prolog» → NPE) и NPE chunkType is null в VML-сериализации
w:object. Новый OleObjectNormalizer (шестой в цепочке, после
GlyphCoverageNormalizer) удаляет OLE-bin-части, rels-ссылки, элементы
w:object и Override удалённых частей; при errorOnOle=true вместо
удаления — DrawingFoundException(OLE) → 422 «Конвертация отменена: в
документе найдены OLE-объекты».
- ядро: Kind.OLE, ConvertOptions.errorOnOle, WordPdfSettings.ERROR_ON_OLE,
фикстура samples/ole-embedded.docx (ручная, оба механизма)
- app: параметр errorOnOle, 422-контракт, тесты errorFlagOle_rejected /
oleObjects_removedByDefault
- SPA: третий переключатель «OLE-объекты»
- прод-автотесты: +2 проверки (21)
- регрессии: OleObjectNormalizerTest ↔ oleObjects_removedAndConverted /
drawingErrors_errorFlagRejectsOle; E2E: notConverted.docx 500 → 200
- pmd-ruleset.xml: ReturnEmptyCollectionRatherThanNull (p1),
AvoidLiteralsInIfCondition (p3), EmptyCatchBlock (p2),
ForLoopCanBeForeach (p2)
- main: split/contentOf/invokeList возвращают List.of() вместо null;
литералы в условиях if вынесены в именованные константы
(9 файлов chart/валидатора); индексный цикл легенды → foreach
- src/test: 8 литералов в условиях if — те же именованные константы
- AGENTS.md: описание ruleset'а и гейта обновлено
mvn clean verify зелёный, 0 нарушений PMD.
Учения раунда 2 (run 492) отработали: deploy failure (fail-fast) -> rollback
success -> прод на прежнем образе. Путь отката проверен end-to-end. Возврат
/app/app.jar.
Тайминги: замер на проде "Started WordPdfApplication in 2.577 seconds" —
start_period 45s -> 10s (podman не считает health до его истечения, он и был
главной задержкой), гейты healthy 120s -> 60s, timeout up 180/120 -> 90/60
(deploy и rollback), синхронно в Containerfile, compose.yml, compose.dev.yml.
podman-compose up -d бесконечно ждёт контейнер в crash-loop (run 488: deploy
висел 10+ мин, гейт healthy и rollback не запускались; пережил это только
ручной остановкой контейнера). 180s на app/web, 120s на gateway.
unless-stopped крутил битый образ бесконечным crash-loop (наблюдено на учениях
run 488). on-failure:5 (5 = retries healthcheck'а) ограничен; синтаксис
on-failure:N проверен локально на podman-compose: RestartPolicy.MaximumRetryCount=2
в пробе, после исчерпания контейнер остаётся exited.
Run 484: deploy и rollback умерли на yaml.safe_load (ModuleNotFoundError),
прод не тронут. Проверено в docker.gitea.com/runner-images:ubuntu-latest:
python3 без yaml, pip3 и apt-get есть; ssh/scp есть. Цепочка import → pip →
pip --break-system-packages → apt-get python3-yaml, финальная валидация —
до переноса файлов на прод.
appleboy/drone-ssh исполняет script построчно: вставляет guard
DRONE_SSH_PREV_COMMAND_EXIT_CODE после каждой строки и срезает отступы —
heredoc на проде превращался в невалидный YAML («mapping values are not
allowed here», run 482), deploy падал на pull, rollback на битом compose
тоже падал. Теперь файлы рендерятся обычным bash-шагом в workspace runner'а
(с YAML-валидацией до отправки), переносятся ssh-ом (cat > файл) и удалённая
цепочка идёт bash -s с export-строкой (секреты — только окружением). Rollback
рендерит compose заново (YAML-якорь — тот же шаг) и не зависит от остатков
на хосте.
Прод-хост не хранит ни конфигов, ни секретов: docker-compose.yml и nginx.conf
генерируются job deploy на каждый деплой (новые Variables WORDPDF_PORT/
PROD_SUBNET/PROD_GW вместо литералов в yml), API-ключ подаётся окружением и на
диск не пишется; restart.sh и .env удаляются как наследие ручного setup.
Healthcheck app — wget (alpine-jre образ curl не содержит: curl-хелсчек давал
вечный unhealthy и висящий up, run 479). Gateway пересоздаётся, а не рестартует.
Rollback — retag из .rollback.env + пересоздание app/web/gateway.
После ухода с java.awt.Font рантайму не нужны ни fontconfig, ни системные
шрифты, ни утилиты из apt: chart-движку достаточно модуля java.desktop
(Graphics2D), который есть и в musl-сборке temurin 21-jre-alpine (проверено
на стенде без libfontconfig.so и /etc/fonts: конвертация charts-smartart.docx
-> PDF 466357 байт, байт-в-байт с Debian-стендом).
- Containerfile: FROM eclipse-temurin:21-jre-alpine, HEALTHCHECK на busybox
wget (есть в alpine из коробки) — apt-get install curl удалён вместе
с уровнем apt-кэша; adduser -S -D -H -u 10001 (non-root как раньше)
- compose.yml / compose.dev.yml: явные healthcheck app дублируют
Containerfile — переведены с curl на wget (curl в образе больше нет)
- AGENTS.md: строка Containerfile/compose обновлена
Проверено: podman build -> образ 280 МБ (база 209 МБ против 333 МБ полного
jre); smoke образа — health UP, uid 10001, wget есть/curl нет, конвертация
через :18080 -> %PDF-1.4 466357 байт; полный dev-стенд compose.dev.yml —
app/web healthy (wget-хелсчек), gateway поднялся по depends_on,
конвертация через :9011 -> тот же PDF.
На OpenJDK/Linux любое обращение к java.awt.Font требует fontconfig-нативки
(Fontconfig head is null на хосте без libfontconfig). java.awt.Font убран из
всего рантайм-пути: текст chart-движка (DrawMlText) и проверка покрытия глифов
(GlyphCoverageNormalizer) переведены на GlyphFont — чистый Java-парсер TTF
org.apache.pdfbox:fontbox 3.0.8 (compile; commons-logging исключён,
единственный провайдер jcl-over-slf4j). Метрики совпадают с AWT до 4-го знака,
кернинг-дрейф 0.0000 (DejaVu Sans, Carlito). AWT остаётся только как геометрия
(Graphics2D/Path2D), которая fontconfig не требует.
- GlyphFont: of/canDisplay/advance/ascent/descent/leading/draw; TTF читается
напрямую из classpath, не зависит от BundledFonts.init(); битый бандл падает
IllegalStateException, отсутствующее семейство/начертание -> null
- DrawMlText.fontFor: цепочка фолбэка family/variant -> family/regular ->
fallback/variant -> fallback/regular (bold у Noto остаётся своим regular)
- BundledFonts: awtFont/AWT_FONTS удалены (чистый cutover), CLASSPATH_DIR ->
package-private
- ChartRenderer.measureLegend: убран неиспользуемый после cutover параметр g (PMD)
- GlyphFontTest (6 юнитов) без единого java.awt.Font — обязан проходить на хосте
без fontconfig; Containerfile/AGENTS.md: fontconfig рантайму не нужен
Проверено: mvn clean verify локально (153 теста, PMD); приёмочный стенд —
контейнер без libfontconfig.so и /etc/fonts: mvn verify BUILD SUCCESS и
java -jar + конвертация charts-smartart.docx -> PDF 466 КБ с 4 растрами
(деградации нет).
- checkDocxContainer: потоковый проход по zip — декларация wordprocessingml.document
в [Content_Types].xml (голый zip / переименованный .xlsx → 400, а не 500 на docx4j)
+ лимиты MAX_DECOMPRESSED_MB (200) / MAX_ZIP_ENTRIES (8192) — бомба отсекается
до readAllBytes в checkPageCount; пороги константные, не ConvertOptions
- регрессии: validate_plainZipRejected/xlsxRenamedRejected/zipBombRejected/
tooManyEntriesRejected, inputNotDocx_rejectedBeforeRender, plainZipNotDocx_rejected;
junkInsideValidZip_conversionError — на валидном контейнере с мусором (500)
- прод-автест test_plain_zip_not_docx_rejected; AGENTS.md синхронизирован
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).