Files
java-word-pdf/GITEA-vars.md
T
Pjandro 33a014c307
PR checks / java (pull_request) Successful in 1m12s
PR checks / web (pull_request) Successful in 43s
ci: единый источник лимитов прода — Gitea Variables WORDPDF_MAX_PAGES/WORDPDF_MAX_BYTES
deploy/rollback экспортируют обе Variables в окружение прод-compose (app
пересоздаётся с лимитами), autotests сверяют проверки с ними же (fail-closed
без обеих). Новый автотест test_oversized_vs_limit ловит расхождение
байтового лимита сервера и ожидания; fixture max_bytes (дефолт 5242880).
GITEA-vars.md/AGENTS.md приведены к фактическим лимитам 100 стр./5 MiB.
2026-10-20 20:21:56 +00:00

53 lines
4.5 KiB
Markdown

# Настройка 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_BYTES`|Лимит размера входного .docx, байт (сейчас `5242880` = 5 MiB)|
|`REGISTRY`|Адрес docker-реестра `host:port` без схемы (Nexus docker-registry на прод-сервере, коннектор `:5000`)|
При смене лимитов прода — править `WORDPDF_MAX_PAGES`/`WORDPDF_MAX_BYTES` в 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-ветки).