diff --git a/.dockerignore b/.dockerignore index 7635e5e..eebbf13 100644 --- a/.dockerignore +++ b/.dockerignore @@ -8,3 +8,4 @@ diff/ dependency-reduced-pom.xml wordpdf-web/node_modules wordpdf-web/dist +.env diff --git a/.env.example b/.env.example new file mode 100644 index 0000000..452227f --- /dev/null +++ b/.env.example @@ -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 diff --git a/.gitignore b/.gitignore index 56ac072..3f695f0 100644 --- a/.gitignore +++ b/.gitignore @@ -22,3 +22,11 @@ Thumbs.db # Артефакты ручной калибровки диаграмм /diff/ + +# Секреты деплоя +.env + +# Индекс CodeGraph +.codegraph/ + +# Выход конвертера из references/ (артефакт ручной проверки, не эталон) diff --git a/Dockerfile b/Dockerfile index 2f24f3a..ce84ace 100644 --- a/Dockerfile +++ b/Dockerfile @@ -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"] diff --git a/docker-compose.dev.yml b/docker-compose.dev.yml new file mode 100644 index 0000000..674078e --- /dev/null +++ b/docker-compose.dev.yml @@ -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 diff --git a/docker-compose.yml b/docker-compose.yml index 0749efa..fad3675 100644 --- a/docker-compose.yml +++ b/docker-compose.yml @@ -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 diff --git a/gateway/nginx.conf b/gateway/nginx.conf new file mode 100644 index 0000000..5827683 --- /dev/null +++ b/gateway/nginx.conf @@ -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; } +} diff --git a/wordpdf-web/Dockerfile b/wordpdf-web/Dockerfile index e2b7527..fd15144 100644 --- a/wordpdf-web/Dockerfile +++ b/wordpdf-web/Dockerfile @@ -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 diff --git a/wordpdf-web/nginx.conf b/wordpdf-web/nginx.conf index c68507f..03bcc2b 100644 --- a/wordpdf-web/nginx.conf +++ b/wordpdf-web/nginx.conf @@ -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; } }