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).
deploy/rollback экспортируют обе Variables в окружение прод-compose (app
пересоздаётся с лимитами), autotests сверяют проверки с ними же (fail-closed
без обеих). Новый автотест test_oversized_vs_limit ловит расхождение
байтового лимита сервера и ожидания; fixture max_bytes (дефолт 5242880).
GITEA-vars.md/AGENTS.md приведены к фактическим лимитам 100 стр./5 MiB.
- main.yml: новый job images (docker build + push, теги prod + sha-<7>,
DOCKER_BUILDKIT=0 — daemon за раннером podman); deploy: needs images,
restart.sh --deploy, .rollback.env без PREV_COMMIT (git-клон src на проде
больше не нужен); rollback: retag image ID на реестровые :prod
- GITEA-vars.md: Secrets REGISTRY_USER/REGISTRY_PASSWORD, Variable REGISTRY
- AGENTS.md: CI/CD и Деплой переписаны под pull-поток
maven-pmd-plugin 3.28.0 (PMD 7.17) на фазе verify для обоих модулей,
includeTests=true, ruleset pmd-ruleset.xml: codestyle без opinionated-правил,
MethodNamingConventions с junit5TestPattern под underscore-имена регрессий,
TooManyStaticImports до 12, XPath LiteralFirstInEquals (PMD 7 удалил
EqualsAvoidsNull), unused-правила bestpractices.
Литерал слева в equals/equalsIgnoreCase (NPE-safe), удаление неиспользуемых
параметров/локальных/импортов/полей, логгеры log→LOG (конвенция UPPER_SNAKE),
UselessParentheses/UnnecessaryCast/UseShortArrayInitializer, record без явного
static, пустой конструктор ChartSpec удалён. Семантика не меняется.
- docker-compose.dev.yml: ports 127.0.0.1:9011:80 → 9011:80 (вход по LAN-IP хоста)
- vite.config.ts: server.host=true — dev-сервер тоже на все интерфейсы
- api.ts: probeApiKey() — GET /api/v1/convert (POST-only эндпоинт): 401 от
ApiKeyFilter ⟺ сервер требует ключ; при выключенной аутентификации не 401
- App.tsx: экран ApiKeyGate показывается только когда зонд вернул 'required';
401 на конвертации возвращает к гейту (setGate('required'))
- AGENTS.md: обновлены поведенческие строки (dev-вход, контракт гейта)