Files
EvoBGP/deploy/docker
Denozordec 0148d4ca37
quality / commitlint (push) Skipped
quality / changes (push) Successful in 8s
quality / docker-check (push) Skipped
quality / openapi (push) Successful in 40s
quality / web (push) Successful in 1m27s
quality / go (push) Successful in 1m4s
quality / bird2 (push) Successful in 18s
CD / quality (push) Successful in 3m45s
CD / publish (push) Canceled after 10m39s
feat(docker): enhance base image mirroring process and update documentation
- Updated `mirror-base-images.sh` to skip existing tags in Gitea and retry on 429 errors, improving efficiency and reducing unnecessary requests.
- Modified CI workflow to utilize a temporary environment file for mirrored base images, ensuring better handling of existing images.
- Enhanced README documentation to reflect changes in the mirroring process and clarify the behavior when tags already exist.
2026-08-18 18:22:26 +07:00
..

Docker-образы EvoBGP

CI (Gitea Actions)

Сборка образов — docker buildx bake (docker-bake.hcl), не отдельные docker build.

Publish: push в main после quality gates — workflow CD job publish: semantic-release + зеркало base-образов + bake с VERSION из релиза.

Bake читает переменные из окружения (REGISTRY, IMAGE_TAG, CACHE_REF_*, BASE_*). Скрипт write-bake-override.sh — опциональный helper для локальной отладки.

BuildKit кэширует /go/pkg/mod, ~/.cache/go-build и pnpm store через RUN --mount=type=cache. На CI mounts живут, пока named builder evobgp не удаляют (cleanup: false).

Слои и runtime

Образ Runtime base Заметка
scheduler, ingest, render, deploy, node gcr.io/distroless/static-debian12:nonroot static Go (CGO_ENABLED=0), без shell
api, all debian:bookworm-slim + birdc только клиент birdc, без демона bird
agent тот же Ubuntu+bird2, что bird2 общие слои с evobgp-bird2
bird2 Ubuntu Noble + пакет bird2
web, web-all nginx:1.27-alpine worker_processes 1

Сборка Go: golang:1.24-alpine. Context режется корневым .dockerignore.

Кэш registry

  • git.shx.one/<owner>/evobgp-buildcache:go-buildcacheзапись только из go-build-all
  • git.shx.one/<owner>/evobgp-buildcache:web-buildcacheзапись только из web-build
  • git.shx.one/<owner>/evobgp-buildcache:birdc-buildcacheзапись только из go-birdc
  • git.shx.one/<owner>/evobgp-buildcache:base-* — зеркало FROM (mirror-base-images.sh): только linux/amd64, skip если тег уже в Gitea (без повторного pull с ECR / 429). Неуспешный copy не валит CD — bake берёт public FROM для этой базы.

pull = false в bake: не перекачивать FROM, если слой уже в builder. Не запускайте docker system prune -a на runner.

Параллельный cache-to в один ref ломает manifest (content descriptor … not found).

Если CI падает на «not found» после смены схемы кэша — один раз удалите теги evobgp-buildcache:* в registry и пересоберите.

Локальная сборка

Из корня репозитория:

cd deploy/docker
export REGISTRY=git.shx.one/<owner>
export IMAGE_TAG=latest
export SHORT_SHA=$(git rev-parse --short HEAD)
export VERSION=dev
export BUILD_TIME=
docker buildx bake --allow=fs.read=../.. -f docker-bake.hcl go-images
docker buildx bake --allow=fs.read=../.. -f docker-bake.hcl web-images

Проверка манифеста без сборки:

docker buildx bake --allow=fs.read=../.. -f docker-bake.hcl --print default

В docker-bake.hcl: context = "../.." (корень репо), dockerfile = "deploy/docker/…" (путь от корня репо).

Один образ (legacy, target build-all):

docker build -f deploy/docker/gobinary/Dockerfile \
  --target build-all \
  -t evobgp-build-all:local .

Runtime-образы в bake ожидают stage build-all (через bake contexts).