# Настройка 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`)| ## Переменные (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`|Лимит страниц на проде (сейчас `1000`)| При смене лимита страниц прода — править `WORDPDF_MAX_PAGES` в Variables, PR не нужен. ## Защита ветки 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 (формат ` / ()`, проверено на первом 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-ветки).