diff --git a/AGENTS.md b/AGENTS.md index 8e7a905..90ec128 100644 --- a/AGENTS.md +++ b/AGENTS.md @@ -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, защита ветки, перезапуск — только имена переменных, без значений| diff --git a/Containerfile b/Containerfile index 2d1dd79..b1976d0 100644 --- a/Containerfile +++ b/Containerfile @@ -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"] + diff --git a/compose.dev.yml b/compose.dev.yml index 8e08548..ede7592 100644 --- a/compose.dev.yml +++ b/compose.dev.yml @@ -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 diff --git a/compose.yml b/compose.yml index 4156da1..02ad257 100644 --- a/compose.yml +++ b/compose.yml @@ -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