3.6 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) |
Переменные (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
(формат <workflow> / <job> (<event>), проверено на первом PR-ране), а не голые имена
job'ов. deploy/autotests в список НЕ включать: на PR они не запускаются,
мерж блокировался бы навсегда.
Ручной перезапуск проверок
- Упавший run: страница run'а → Re-run jobs (можно только упавшие job'ы).
- Новый прогон main-пайплайна без нового коммита: Actions →
Main: tests, deploy, autotests→ Run workflow (branchmain) — триггерworkflow_dispatch. - PR-проверки без нового коммита: Actions →
PR checks→ Run workflow (branch PR-ветки).