Docker 构建配置

.gvt/docker.toml 由 gvt docker add 生成，定义镜像仓库、构建平台与镜像列表。

配置示例

[docker]
registry = ""
default_tag = "latest"
builder_name = "gvt-builder"
platforms = ["linux/amd64", "linux/arm64"]

[[docker.images]]
name = "backend"
remote = "my-project-backend"
dockerfile = "docker/backend/Dockerfile"
context = "."
description = "后端服务"
port = 8080

[[docker.images]]
name = "portal"
remote = "my-project-portal"
dockerfile = "docker/frontend/Dockerfile"
context = "."
description = "门户前端"
port = 80
hook = "frontend/portal"

字段说明

[docker] 全局

字段	说明
registry	镜像仓库地址，留空则仅本地构建
secondary_registry	私有仓库地址，--secondary 时同时推送
push_secondary	是否默认推送额外私有镜像
default_tag	默认镜像标签
builder_name	buildx 构建器名称
platforms	目标平台列表

[[docker.images]] 镜像

字段	说明
name	镜像名称（用于查找）
remote	远程镜像名
dockerfile	Dockerfile 路径（唯一键）
context	构建上下文（工作目录）
description	镜像描述
port	服务端口
hook	绑定钩子模块目录；非空时构建前先执行其完整流程

镜像名推导

• 镜像名称从 Dockerfile 上级目录自动推导
• 远程镜像名从仓库地址 + 名称自动生成
• 配置唯一值基于 Dockerfile 路径：路径已存在则更新，否则新增

镜像加速

根目录 buildkitd.toml 加速 docker.io 拉取。修改镜像源后需重建构建器：

docker buildx rm gvt-builder && docker buildx create --name gvt-builder --use

详见 Docker 构建流程。