- Контент-дерево docs/: пользователь, REST API, библиотека, архитектура, разработчику, эксплуатация; навигация обязательна (strict-сборка). - docs/agent/ и docs/standards/ из сайта исключены (exclude_docs), ссылки на них — внешние, на Gitea. - Javadoc публичного API core попадает на сайт как docs/apidocs (gitignored).
3.4 KiB
Деплой (прод)
Наружный вход прода — https://pjandro.ru/pdf-converter/ (пользовательский
nginx режет префикс и проксирует на стек конвертера). Публикация полностью
автоматизрована: push в main → Gitea Actions.
Пайплайн main.yml
java + web (тесты/гейты) ──> images-app + images-web (build+push в реестр)
──> deploy (рендер прод-стека, pull, up, health-гейты, автооткат)
──> autotests (pytest против живого прода; провал → rollback)
java/web— те же гейты, что на PR (mvn clean verifyв контейнере без fontconfig;npm ci/build/lint).images-app/images-web— сборка Containerfile в Nexus-реестр, тегиprod+ неизменяемыйsha-<7 символов>; web печётся сVITE_BASE=/pdf-converter/(путь публикации запекается в образ).deploy— job рендеритdocker-compose.ymlиnginx.confв директорию деплоя из Gitea Variables (прод-хост не хранит ни конфигураций, ни секретов; API-ключ — из Secret через окружение деплоя, на диск не пишется), затем login/pull/up -d --force-recreate app web, гейты healthy + recreate gateway. Единственное состояние на проде —.rollback.env(image id предыдущего рана).autotests— 31 pytest-проверка против живого стенда; провал → откат на образ из.rollback.env.
Где креды и координаты
Всё вне репозитория — Gitea Actions Variables/Secrets (полный список и настройка
branch protection: GITEA-vars.md).
Прод-ключ WORDPDF_API_KEY — только Secret. В репо и на диске прод-хоста ключа нет.
Ручные операции
!!! warning "Перед ручным перезапуском прода"
Прочитать /home/pjandro/prod/java-word-pdf/DEPLOY.md (живёт на прод-хосте,
вне репозитория) — там актуальные координаты и процедура. Ручных скриптов
деплоя в репозитории нет и не заводить.
Прод-образ/compose правятся только через CI-рендер; копий прод-стека на хосте
или в репо быть не должно.
Проверка после деплоя
CI сам докладывает по job'ам (/actions/runs/<id>/jobs); руками:
curl -sf https://pjandro.ru/pdf-converter/actuator/health # 200 {"status":"UP"}
curl -s -o /dev/null -w '%{http_code}\n' https://pjandro.ru/pdf-converter/ # 200 SPA
Глубина (нюансы runner'ов, DOCKER_BUILDKIT=0, реестр, rollback-механика) —
ci-cd.md (репозиторий).