feat: runtime-образ на temurin-21-jre-alpine — curl/apt больше не нужны
PR checks / java (pull_request) Successful in 2m0s
PR checks / web (pull_request) Successful in 1m15s

После ухода с 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.
This commit is contained in:
Pjandro
2026-10-21 19:22:47 +00:00
parent c09a3f5adf
commit 742e03f38b
4 changed files with 14 additions and 15 deletions
+1 -1
View File
@@ -55,7 +55,7 @@ Java2D → PNG 300 dpi (`ChartRenderer.DPI = 300`, `PADDING = 4.0`, растр
|`wordpdf-core/src/test/resources/samples/`|11 закоммиченных `.docx`-фикстур (единственные фикстуры)|
|`wordpdf-app/src/main/java/ru/pjandro/wordpdf/app/`|REST API (10 классов): `WordPdfApplication` (единственный public), `ConvertController`, `ConversionService` (очередь), `ApiExceptionHandler`, `ApiKeyFilter`, `OpenApiConfig` (`@SecurityScheme` X-API-Key для springdoc) + 5 класса исключений|
|`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 — chart-движку нужен модуль java.desktop (Graphics2D); fontconfig и системные шрифты рантайму не нужны — текст рисуется глифами fontbox, см. `fonts/GlyphFont`; non-root uid 10001, HEALTHCHECK actuator); compose app+web+gateway: web-образ со своим HEALTHCHECK (`wget /`), в обоих compose `depends_on web: condition: service_healthy`; прод-compose интерполирует `WORDPDF_MAX_MB:-5`/`WORDPDF_MAX_PAGES:-100`; podman-специфика обоих compose: `x-podman.name_separator_compat` (docker-style имена), явные `healthcheck` app/web (дубли Containerfile-HEALTHCHECK — OCI-выгрузка его теряет), зафиксированная подсеть `10.113.0.0/24` gw `10.113.0.1` под резолвер aardvark-dns; два repo-стенда одновременно не поднять (общая подсеть)|
|корневые `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 интерполирует `WORDPDF_MAX_MB:-5`/`WORDPDF_MAX_PAGES:-100`; 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: `WORDPDF_API_KEY` (`openssl rand -hex 32`), закомментированные `WORDPDF_MAX_MB`/`WORDPDF_MAX_PAGES` (пустое значение ломает старт — binding long/int); реальный прод `.env` — на прод-сервере (координаты: `/home/pjandro/prod/java-word-pdf/DEPLOY.md`, вне репо)|
|`.gitea/workflows/`|Gitea Actions: `pr.yml` (PR checks), `main.yml` (тесты → `images` (build+push в Nexus) → deploy (pull) → autotests → rollback)|
|корневой `GITEA-vars.md`|инструкция владельца: Secrets/Variables, защита ветки, перезапуск — только имена переменных, без значений|
+11 -12
View File
@@ -9,22 +9,21 @@ RUN mvn -B -q dependency:go-offline
COPY . .
RUN mvn -B -q -DskipTests package
FROM docker.io/library/eclipse-temurin:21-jre
# curl — только для HEALTHCHECK; runtime полный jre (не alpine-slim): chart-движку
# нужен модуль java.desktop (Graphics2D); fontconfig и системные шрифты рантайму
# не нужны — текст рисуется глифами fontbox, см. fonts/GlyphFont. Тесты в образе
# не гоняем — гейт mvn clean verify.
FROM docker.io/library/eclipse-temurin:21-jre-alpine
# runtime alpine (минимальный): chart-движку нужен только модуль java.desktop
# (Graphics2D), он внутри JRE; fontconfig и системные шрифты не нужны —
# текст рисуется глифами fontbox (см. fonts/GlyphFont; проверено на musl-стенде
# без libfontconfig и /etc/fonts). Тесты в образе не гоняем — гейт mvn clean verify.
# HEALTHCHECK — busybox wget (есть в alpine из коробки, curl/apt не ставим).
# Прокси-переменные хоста (HTTP_PROXY/HTTPS_PROXY/http_proxy/https_proxy)
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает curl
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на команде.
RUN apt-get update \
&& apt-get install -y --no-install-recommends curl \
&& rm -rf /var/lib/apt/lists/* \
&& useradd -r -u 10001 app
# podman/buildah подмешивает в шелл RUN/HEALTHCHECK и ломает сетевые команды
# (127.0.0.1:proxy внутри контейнера недоступен) — обнуляем на самой команде.
RUN adduser -S -D -H -u 10001 app
WORKDIR /app
COPY --from=build /build/wordpdf-app/target/wordpdf-app-1.0.0.jar app.jar
USER app
EXPOSE 8080
HEALTHCHECK --interval=10s --timeout=3s --start-period=45s --retries=5 \
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"]
+1 -1
View File
@@ -16,7 +16,7 @@ services:
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
healthcheck:
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
interval: 10s
timeout: 3s
start_period: 45s
+1 -1
View File
@@ -11,7 +11,7 @@ services:
# где поля healthcheck нет — без явного healthcheck depends_on
# service_healthy ждал бы healthy вечно. Прокси обнуляем на команде.
healthcheck:
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1"]
test: ["CMD-SHELL", "HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= wget -qO /dev/null http://127.0.0.1:8080/actuator/health || exit 1"]
interval: 10s
timeout: 3s
start_period: 45s