Files
java-word-pdf/GITEA-vars.md
T
Pjandro 1e20949a98
PR checks / java (pull_request) Successful in 1m7s
PR checks / web (pull_request) Successful in 43s
refactor: лимит размера входа во всех слоях — MAX_MB (МБ=MiB), байты вычисляются в checkInput
Ядро: WordPdfSettings.MAX_INPUT_MB=5, ConvertOptions.maxMb,
WordPdfValidator.checkInput(byte[], long maxMb) — единственная точка
пересчёта МБ→байты, сообщение «Файл больше N МБ: X байт > Y байт».
Приложение: свойство wordpdf.max-mb (env WORDPDF_MAX_MB, relaxed binding).
CI/конфиг/автотесты/доки: WORDPDF_MAX_BYTES → WORDPDF_MAX_MB (значение 5).
2026-10-20 20:34:01 +00:00

4.5 KiB

Настройка Gitea для CI/CD этого репо

Секреты, переменные и защиту ветки заводит владелец репо в Web UI — у CI-токена прав admin нет. Workflow-файлы уже в репо; прогоны main-пайплайна без Variables/Secrets падают на job'ах deploy/autotests с внятным сообщением, чего не хватает, — это ожидаемо. После заполнения перезапустите упавший run («Re-run jobs» на странице run'а) или запустите Main: tests, deploy, autotests вручную (Actions → Run workflow, branch main).

Правило: координаты прода и креды в файлы репо не попадают — ни в workflow'ы, ни в этот гайд: здесь только имена Variables/Secrets, значения живут только в Gitea.

Секреты (Settings → Actions → Secrets)

Имя Значение Где взять
DEPLOY_SSH_KEY Приватный SSH-ключ деплоя на прод (целиком, PEM) CI-ключ wordpdf-ci-deploy на dev-машине; публичная половина уже добавлена в authorized_keys деплой-пользователя прод-сервера
WORDPDF_API_KEY Прод-ключ API wordpdf .env в директории деплоя на прод-сервере (значение WORDPDF_API_KEY)
REGISTRY_USER Логин docker-реестра для CI-пуша (ci-deploy) Nexus: Security → Users (роль ci-deploy-role, права на docker-hosted репозиторий)
REGISTRY_PASSWORD Пароль этого пользователя Тот же, что в .env директории деплоя на прод-сервере (значение REGISTRY_PASSWORD)

Переменные (Settings → Actions → Variables)

Имя Значение
DEPLOY_HOST Адрес прод-сервера (туда Actions ходит по SSH)
DEPLOY_USER SSH-пользователь прод-сервера с правами на podman
DEPLOY_DIR Абсолютный путь директории деплоя на прод-сервере (compose, restart.sh, .rollback.env, .env)
WORDPDF_BASE_URL Базовый URL прод-API для автотестов (вида https://<домен-прода>/pdf-converter)
WORDPDF_MAX_PAGES Лимит страниц на проде (сейчас 100)
WORDPDF_MAX_MB Лимит размера входного .docx, МБ (сейчас 5)
REGISTRY Адрес docker-реестра host:port без схемы (Nexus docker-registry на прод-сервере, коннектор :5000)

При смене лимитов прода — править WORDPDF_MAX_PAGES/WORDPDF_MAX_MB в Variables, PR не нужен: job deploy прокидывает их в прод-stack (app пересоздаётся с новыми лимитами), job autotests сверяет проверки с ними же. Без обеих Variables job'ы deploy/autotests падают на проверке — fail-closed.

Защита ветки main (блокировка мержа до зелёных проверок)

Settings → Branches → Branch Protection → Add protection:

  • Branch name: main
  • включить Enable Status Check on Merge
  • Status checks on merge: PR checks / java (pull_request), PR checks / web (pull_request)

Контексты — фактические строки статуса, которые Gitea 1.26 публикует для job'ов Actions (формат <workflow> / <job> (<event>), проверено на первом PR-ране), а не голые имена job'ов. deploy/autotests в список НЕ включать: на PR они не запускаются, мерж блокировался бы навсегда.

Ручной перезапуск проверок

  • Упавший run: страница run'а → Re-run jobs (можно только упавшие job'ы).
  • Новый прогон main-пайплайна без нового коммита: Actions → Main: tests, deploy, autotests → Run workflow (branch main) — триггер workflow_dispatch.
  • PR-проверки без нового коммита: Actions → PR checks → Run workflow (branch PR-ветки).