Docker buildx bake: собрать несколько образов

Категория: docker · Язык: YAML · Обновлено:

docker buildx bake собирает несколько целей из docker-bake.hcl или Compose-файла одной командой. Вместо длинного docker buildx build с флагами вы описываете targets, группы и общие настройки в файле, а bake строит их параллельно с общим кешем. Это удобно для CI и монорепозиториев с несколькими образами.

Описать два образа в HCL

Текст
group "default" {
  targets = ["api", "worker"]
}

target "api" {
  context = "."
  dockerfile = "Dockerfile"
  tags = ["registry.example.com/app-api:1.2.3"]
  platforms = ["linux/amd64", "linux/arm64"]
}

target "worker" {
  context = "."
  dockerfile = "Dockerfile.worker"
  tags = ["registry.example.com/app-worker:1.2.3"]
}

group объединяет цели, target описывает контекст, Dockerfile, теги и платформы. Общие поля можно вынести в отдельный target и наследовать через inherits. docker buildx bake --print покажет итоговую конфигурацию без сборки — удобно для отладки CI.

Собрать и переопределить тег

Bash
docker buildx bake --push
docker buildx bake api --set api.tags=registry.example.com/app-api:dev

--push отправляет multi-platform результат в registry; --load работает только для одной платформы. --set переопределяет поле без правки файла, что удобно для ночных сборок и pull request. --pull обновляет базовые образы, --no-cache отключает кеш.

Bake использует BuildKit и тот же builder, что buildx build. Проверьте docker buildx version и создайте builder заранее. Для Compose-файла можно вызвать docker buildx bake -f docker-compose.yml, но не все поля Compose поддерживаются; для сложных случаев лучше HCL.

Не храните секреты в HCL: используйте secrets BuildKit или переменные окружения CI. Теги latest обновляйте отдельно после проверки неизменяемого тега. Кеш можно ускорить через cache-from/cache-to, но не публикуйте слои с токенами.

Документация: docker buildx bake, bake reference.