# Настройка Gitea для CI/CD этого репо Секреты, переменные и защиту ветки заводит **владелец репо** в Web UI — у CI-токена прав admin нет. Workflow-файлы уже в репо; прогоны main-пайплайна без Variables/Secrets падают на job'ах `images-app`/`images-web` (проверка `REGISTRY`/`REGISTRY_USER`/`REGISTRY_PASSWORD`), `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|Единственный источник — этот Secret (прод `.env` выведен из эксплуатации, job `deploy` удаляет его как наследие); значение уже в Gitea| |`REGISTRY_USER`|Логин docker-реестра для CI-пуша (`ci-deploy`)|Nexus: Security → Users (роль `ci-deploy-role`, права на docker-hosted репозиторий)| |`REGISTRY_PASSWORD`|Пароль этого пользователя|Nexus: Security → Users → `ci-deploy` (Reset password)| |`DEPLOY_KNOWN_HOSTS`|Строка known_hosts прод-хоста (host-key pinning: job `deploy` пишет её в `~/.ssh/known_hosts` и ставит `StrictHostKeyChecking=yes`)|`ssh-keyscan -t ed25519 ` с любой машины, знающей хост. Завести ДО мержа: без секрета деплой падает fail-closed (ssh отваливается до передачи ключей) и штатно отрабатывает `rollback`| ## Переменные (Settings → Actions → Variables) |Имя|Значение| |---|---| |`DEPLOY_HOST`|IP прод-сервера (туда Actions ходит по SSH; им же связывается LAN-порт gateway — нужен именно IP, не hostname)| |`DEPLOY_USER`|SSH-пользователь прод-сервера с правами на podman| |`DEPLOY_DIR`|Абсолютный путь рабочей директории деплоя: job `deploy` создаёт её и рендерит в неё `docker-compose.yml` и `nginx.conf` на каждый деплой; `.rollback.env` — состояние отката (его пишет job `deploy`)| |`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`)| |`PIP_INDEX_URL`|Полный URL pypi-proxy индекса Nexus без кредов, вида `http://:/repository/pypi-proxy/simple` (репозиторий заводится по разделу «Nexus: анонимный доступ CI» ниже; HTTP-порт Nexus — не docker-коннектор `:5000`)| |`MAVEN_MIRROR_URL`|Полный URL зеркала Nexus **maven-public** (group) со слэшем на конце: `http://:/repository/maven-public/`. Group содержит `maven-central` (proxy на Central) **и** `maven-hosted` (наш `ru.pjandro:docx4j-fo-renderer-core`, PR-2) — mirror в `.ci/maven-settings.xml` имеет `mirrorOf=*`, поэтому при значении `…/maven-central/` форк-артефакт CI не резолвится (404, fail-closed). Group и доступ — раздел «Nexus: анонимный доступ CI» ниже| При смене лимитов прода — править `WORDPDF_MAX_PAGES`/`WORDPDF_MAX_MB` в Variables, PR не нужен: job `deploy` прокидывает их в прод-stack (app пересоздаётся с новыми лимитами), job `autotests` сверяет проверки с ними же. Без обеих Variables job'ы `deploy`/`autotests` падают на проверке — fail-closed. ## Nexus: анонимный доступ CI (pypi-proxy + maven-central) Заводится **до мержа** PR'ов, использующих `PIP_INDEX_URL`/`MAVEN_MIRROR_URL`: иначе соответствующие job'ы упадут на fail-closed проверке (а `autotests` ещё и спровоцирует `rollback`). Nexus 3 поддерживает PEP 503 (Simple Repository API) для pypi-proxy — https://help.sonatype.com/en/pypi-repositories.html; `maven-central` (proxy на Central) и `maven-public` (group) есть из коробки Nexus — создавать нечего. 1. Settings → Repositories → Create repository: format **PyPI**, type **Proxy**, name **`pypi-proxy`**, Remote storage URL **`https://pypi.org/`**, blob store — тот же, что у docker-репозиториев. 2. Read-доступ CI без новых секретов — анонимный доступ, ограниченный двумя репозиториями (контент pypi/maven central публичный): - Roles → Create role: name `ci-anonymous`, Role type **Simple**, memberships — `nx-anonymous`, privileges — `nx-repository-view-pypi-pypi-proxy-read`, `nx-repository-view-pypi-pypi-proxy-browse`, `nx-repository-view-maven2-maven-central-read`, `nx-repository-view-maven2-maven-central-browse`. Если роль `pypi-anonymous` уже заведена по прежней инструкции — переименовать её в `ci-anonymous` и добавить два maven-привилегия. - Security → Anonymous Access: включить, **Anonymous User Role IDs = `ci-anonymous`** (единственная роль; не `nx-anonymous` — иначе анонимы получат вид на все репозитории). 3. Проверка с любой машины LAN (порт — HTTP-коннектор Nexus, дефолт `8081`, не `:5000`): `curl -fsS 'http://:<порт>/repository/pypi-proxy/simple/pytest/'` — PEP 503-лист без кредов; `curl -fsS 'http://:<порт>/repository/maven-central/org/apache/maven/maven-core/3.9.16/maven-core-3.9.16.pom'` — XML; docker-репозиторий анониму по-прежнему 401/403. Затем — Variables `PIP_INDEX_URL` и `MAVEN_MIRROR_URL` (см. таблицу выше). ## Защита ветки 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-ветки).