Files
java-word-pdf/GITEA-vars.md
T
Pjandro 4a6cf85f20
PR checks / web (pull_request) Successful in 48s
PR checks / java (pull_request) Failing after 1m0s
refactor(core): рефью PR-2 - жёсткий разбор абзаца, header/footer-штамп, сведение нумерации правил
- DistributeStampNormalizer: pPr ищется как первый ребёнок w:p (S17.3.1.23,
  O(1) вместо неограниченного indexOf по хвосту части); окно jc режется
  началом w:pPrChange - старое значение реvision больше не штампуется и не
  маскируется; вставка - после НАРУЖНОГО </w:pPr> (lastIndexOf от конца
  абзаца), идемпотентность позиционная (чужая закладка Word сразу после pPr
  больше не считается штампом);
- штампуется word/headerN.xml / word/footerN.xml (якорь работает и в
  колонтитулах; .rels отсекаются);
- юниты: реvision-only jc, вложенный pPr в реvision, чужая закладка,
  header/footer, pretty-print; LayoutPostRendererTest: якорь внутри
  fo:static-content;
- проба опровергла двойной разделитель suff=space (TP-поток «1.·ITEM») -
  зафиксировано в javadoc правила 6;
- нумерация правил сведена к docs (Distribute=9, OLE=10): код/тесты 12->9,
  README 8/9->9/10, doc-bridge 9->7, xslt-комментарий внутри AUDIT-FIX-2
  10->8 (гейт побайтной копии не затронут);
- GITEA-vars.md: MAVEN_MIRROR_URL = group maven-public (иначе CI не
  резолвит ru.pjandro-оверлей через mirrorOf=*); render-limitations:
  замер framePr - 180pt от КРАЯ страницы при hAnchor=page; счётчики
  58/906.

mvn clean verify зелёные (core 858 + app 48; артефакт форка докачан
через maven-public при пустом кэше).
2026-11-08 23:50:25 +00:00

8.7 KiB
Raw Blame History

Настройка 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 <IP из DEPLOY_HOST> с любой машины, знающей хост. Завести ДО мержа: без секрета деплой падает 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://<host из REGISTRY>:<http-порт Nexus>/repository/pypi-proxy/simple (репозиторий заводится по разделу «Nexus: анонимный доступ CI» ниже; HTTP-порт Nexus — не docker-коннектор :5000)
MAVEN_MIRROR_URL Полный URL зеркала Nexus maven-public (group) со слэшем на конце: http://<host из REGISTRY>:<http-порт Nexus>/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://<nexus>:<порт>/repository/pypi-proxy/simple/pytest/' — PEP 503-лист без кредов; curl -fsS 'http://<nexus>:<порт>/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 (формат <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-ветки).