Skip to content

fix(ci): publish versioned image in release run (#9) - #82

Merged
eSlider merged 2 commits into
mainfrom
fix/ci-release-docker-9
Nov 11, 2026
Merged

eSlider merged 2 commits into
mainfrom
fix/ci-release-docker-9

Conversation

@eSlider

@eSlider eSlider commented Nov 11, 2026

Copy link
Copy Markdown
Owner

Closes Gitea issue #9 (part of epic #12).

Причина

release создавал тег через gh release create с GITHUB_TOKEN. События,
вызванные GITHUB_TOKEN, не запускают новые workflow runs — поэтому ветка
on.push.tags: ["v*"] у docker-job не выполнялась ни разу. В GHCR есть
только :api и 46 :sha-*; latest и v* никогда не публиковались.

Что меняется

Триггеры: push: branches: [main], pull_request, workflow_dispatch
(push: tags убран — версионный образ теперь собирается в том же run).
Новые inputs: release (bool), line (0.24), backfill_version,
backfill_source (api).

release (on-demand, inputs.release == true, contents: write):
needs: [test, ocr], версия считается bin/semver/next.go --line <line>
(максимальный v<line>.N в git-тегах + 1), тег + Release через
gh release create --target $GITHUB_SHA, output tag.

docker (needs: [test, ocr, release], always() + guards): без tag-event.
Всегда :api, :sha-<12>; если release дал тег — ещё :<tag> и :latest.
linux/amd64, buildx + gha cache, OCI labels
(source, revision, version, created, title).

smoke (needs: [docker]): запускает запушенный sha-<12> образ,
проверяет /health, /openapi.json и MCP tools/list (без kb.lbug),
контейнер удаляется в trap.

backfill (standalone, без needs): docker buildx imagetools create -t :VERSION -t :latest :SOURCE — перетегирование без пересборки, версия
валидируется ^v[0-9]+\.[0-9]+\.[0-9]+$.

bin/semver/next.go: режим --line 0.24 / --line=0.24 (чистая функция
nextForLine, unit-тесты). Старый режим по conventional commits сохранён.

Как проверить

Backfill (одноразово привести текущий :api к версии):

gh workflow run ci.yml -f backfill_version=v0.24.13 -f backfill_source=api
docker pull ghcr.io/eslider/2dph:v0.24.13 && docker pull ghcr.io/eslider/2dph:latest

Релиз:

gh workflow run ci.yml -f release=true -f line=0.24

→ job release создаёт v0.24.14 (текущие теги до v0.24.13), job docker
пушит :v0.24.14 + :latest, job smoke проверяет образ.

Локально (проверено):

go test ./bin/semver -count=1     # ok
go vet ./bin/semver               # ok
./bin/semver/next.go --line 0.24  # v0.24.14
actionlint .github/workflows/ci.yml  # только pre-existing setup-go@v4 (test, ocr)

Smoke-скрипт прогнан локально на ghcr.io/eslider/2dph:api: /health ok за
2 с, /openapi.json ok, tools/list ok.

Известные риски

  • docker использует always() + явные проверки needs.*.result: падение
    самого release не блокирует публикацию :api/:sha-* (версионные теги
    тогда просто не появятся).
  • smoke требует --tmpfs /data/var и KB_HOST=0.0.0.0: образ работает под
    uid 1001, /data принадлежит root, а brain-serve открывает
    $KB_ROOT/var/kb.lbug на старте (без writable-каталога контейнер падает с
    OpenDatabase: failed to open database with status 1); дефолтный bind —
    127.0.0.1, через опубликованный порт недоступен.
  • backfill не переписывает OCI labels (imagetools create копирует манифест
    как есть) — у перетегированного образа останутся labels исходного build.
  • multi-arch/arm64 по решению не делаем — только linux/amd64.

eSlider and others added 2 commits November 11, 2026 16:00
gh release create runs with GITHUB_TOKEN and GitHub never starts workflow
runs for events caused by GITHUB_TOKEN, so the push.tags docker job never
fired: GHCR had only :api and :sha-* — no latest, no v*. Publish the
versioned image in the same run instead of relying on a tag event.

- triggers: drop push.tags; add workflow_dispatch inputs release/line/
  backfill_version/backfill_source
- release: on-demand tag + GitHub Release, computes the next tag with
  bin/semver/next.go --line <line>, exposes it as the tag output
- docker: needs [test, ocr, release]; always() + input guards; tags
  :api/:sha-<12> always, plus :<tag>/:latest when release produced a tag;
  OCI source/revision/version/created/title labels; linux/amd64 only
- smoke: run the pushed sha image, assert /health, /openapi.json and MCP
  tools/list (no kb.lbug needed)
- backfill: buildx imagetools create retags an existing tag as
  vX.Y.Z + latest without rebuilding
- bin/semver/next.go: --line MAJOR.MINOR mode (max v<line>.N + 1) with
  tests; legacy conventional-commit mode kept
@eSlider
eSlider merged commit 15f6391 into main Nov 11, 2026
8 checks passed
@eSlider
eSlider deleted the fix/ci-release-docker-9 branch November 11, 2026 16:08
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant