Деплой: прод fail-closed с ключом, dev-стенд, шлюз с префиксом

docker-compose.yml: WORDPDF_API_KEY обязателен (:? — без ключа стек не
поднимется), springdoc выключен env'ами, nginx client_max_body_size 100m;
docker-compose.dev.yml — стенд без ключа на 127.0.0.1:9011 со springdoc;
gateway/nginx.conf — единственный вход; SPA base через ARG VITE_BASE;
.env.example — шаблон ключа и лимитов. .gitignore: +.codegraph/,
+references/convert.pdf.
This commit is contained in:
Pjandro
2026-10-14 01:50:47 +00:00
parent 4634c0c5aa
commit e3363319d3
9 changed files with 83 additions and 7 deletions
+1
View File
@@ -8,3 +8,4 @@ diff/
dependency-reduced-pom.xml
wordpdf-web/node_modules
wordpdf-web/dist
.env
+11
View File
@@ -0,0 +1,11 @@
# Ключ доступа wordpdf API (заголовок X-API-Key). Сгенерировать:
# openssl rand -hex 32
WORDPDF_API_KEY=
# Лимиты входа (задаёт только сервер; параметрами запроса не переопределяются).
# Либо закомментировано (тогда дефолт), либо конкретное число — пустое
# значение ломает старт приложения.
# Максимальный размер .docx в байтах (дефолт 20971520 = 20 МБ)
#WORDPDF_MAX_BYTES=20971520
# Максимальное число страниц (дефолт 1000)
#WORDPDF_MAX_PAGES=1000
+8
View File
@@ -22,3 +22,11 @@ Thumbs.db
# Артефакты ручной калибровки диаграмм
/diff/
# Секреты деплоя
.env
# Индекс CodeGraph
.codegraph/
# Выход конвертера из references/ (артефакт ручной проверки, не эталон)
+1 -1
View File
@@ -22,5 +22,5 @@ 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/v3/api-docs >/dev/null || exit 1
CMD HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= curl -fsS http://127.0.0.1:8080/actuator/health >/dev/null || exit 1
ENTRYPOINT ["java", "-Djava.awt.headless=true", "-jar", "/app/app.jar"]
+24
View File
@@ -0,0 +1,24 @@
# Dev-стенд без ключа доступа: WORDPDF_API_KEY не задан → wordpdf.api-key пуст
# → ApiKeyFilter прозрачен, springdoc включён. Проект wordpdf-dev — собственные
# образы/контейнеры, с прод-запуском (wordpdf-prod, :9010) не конфликтует.
# Запуск: docker compose -f docker-compose.dev.yml up --build
# Вход: http://127.0.0.1:9011
name: wordpdf-dev
services:
app:
build: .
restart: unless-stopped
web:
build: ./wordpdf-web
restart: unless-stopped
gateway:
image: nginx:alpine
volumes:
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
ports: ["127.0.0.1:9011:80"]
depends_on:
app:
condition: service_healthy
web:
condition: service_healthy
restart: unless-stopped
+19 -1
View File
@@ -3,10 +3,28 @@ services:
app:
build: .
restart: unless-stopped
environment:
# без ключа стек не поднимется (:? на пустое/unset) — прод fail-closed
WORDPDF_API_KEY: "${WORDPDF_API_KEY:?WORDPDF_API_KEY not set: put it in .env (openssl rand -hex 32)}"
# документация в прод-интернете не нужна (в dev/java -jar остаётся включена)
SPRINGDOC_API_DOCS_ENABLED: "false"
SPRINGDOC_SWAGGER_UI_ENABLED: "false"
# лимиты входа (байты/страницы); значение из .env, иначе дефолты ядра;
# интерполяция :- подставляет и на unset, и на пустое — пустая строка
# сломала бы binding long/int
WORDPDF_MAX_BYTES: "${WORDPDF_MAX_BYTES:-20971520}"
WORDPDF_MAX_PAGES: "${WORDPDF_MAX_PAGES:-1000}"
web:
build: ./wordpdf-web
ports: ["8080:80"]
restart: unless-stopped
gateway:
image: nginx:alpine
volumes:
- ./gateway/nginx.conf:/etc/nginx/conf.d/default.conf:ro
ports: ["9010:80"]
depends_on:
app:
condition: service_healthy
web:
condition: service_healthy
restart: unless-stopped
+15
View File
@@ -0,0 +1,15 @@
# Шлюз: единственный вход стека (хост-порт 9010). API и документация — на app,
# остальное — на SPA. app и web наружу не публикуются.
server {
listen 80;
# потолок загрузки стека: больше не пропустит ни шлюз, ни Spring multipart;
# авторитетный лимит — свойство wordpdf.max-bytes (env WORDPDF_MAX_BYTES,
# дефолт 20 MiB). Без директивы upload режется HTML-413 от шлюза до бэкенда.
client_max_body_size 100m;
location /api/ { proxy_pass http://app:8080; }
location /swagger-ui { proxy_pass http://app:8080; }
location /v3/api-docs { proxy_pass http://app:8080; }
# открыт фильтром приложения (wordpdf.api-key его не проверяет) — мониторинг/HEALTHCHECK снаружи
location /actuator { proxy_pass http://app:8080; }
location / { proxy_pass http://web:80; }
}
+4
View File
@@ -7,6 +7,10 @@ WORKDIR /build
COPY package.json package-lock.json ./
RUN HTTP_PROXY= http_proxy= HTTPS_PROXY= https_proxy= ALL_PROXY= all_proxy= npm ci
COPY . .
# base для сборки SPA под префиксом: прод pjandro.ru — /pdf-converter/
# (compose прод-запуска передаёт arg); дефолт '/' — standalone
ARG VITE_BASE=/
ENV VITE_BASE=${VITE_BASE}
RUN npm run build
FROM nginx:alpine
-5
View File
@@ -2,10 +2,5 @@ server {
listen 80;
root /usr/share/nginx/html;
index index.html;
# без него upload >1MB режется HTML-413 от nginx до бэкенда
client_max_body_size 6m;
location /api/ { proxy_pass http://app:8080; }
location /swagger-ui { proxy_pass http://app:8080; }
location /v3/api-docs { proxy_pass http://app:8080; }
location / { try_files $uri $uri/ /index.html; }
}