gvt docker — Docker 镜像构建工具

从 .gvt/docker.toml 读取配置，执行宿主机预编译和多架构 Docker 镜像构建。

用法

gvt docker                          # 预编译 + 构建并推送镜像（默认）
gvt docker cross                    # 仅宿主机交叉编译，不构建镜像
gvt docker add -f <dockerfile>      # 添加 Dockerfile 到构建配置
gvt docker --tag v1.0               # 指定镜像标签
gvt docker --arch amd64             # 仅构建 amd64 架构
gvt docker --image portal           # 仅构建指定镜像（可重复）
gvt docker -i portal -i admin       # 简写，仅构建 portal 与 admin
gvt docker -p                       # 仅构建，不推送
gvt docker --cache                  # 使用构建缓存（默认不缓存）
gvt docker --no-hook                # 跳过镜像绑定的钩子流程

参数说明

参数	简写	说明
--tag	-t	Docker 镜像标签
--arch		目标架构（amd64 / arm64 / all），默认 all
--image	-i	仅构建指定名称的镜像（可重复；默认全部）
--no-push	-p	仅构建到本地，不推送
--secondary	-s	同时推送到私有仓库（覆盖配置）
--cache		使用 Docker 构建缓存（默认不缓存）
--no-hook		跳过镜像绑定的钩子流程

子命令

子命令	说明
cross	仅执行宿主机交叉编译，不构建镜像
add	添加 Dockerfile 到构建配置

镜像加速

通过项目根目录 buildkitd.toml 配置（init 时自动生成），加速 docker.io 拉取。详见 Docker 构建流程。

注意事项

• 所有命令均不支持位置参数，请使用标志参数。
• 若镜像配置了 hook，宿主机构建前先执行其完整钩子流程（含前端打包），失败则中断构建。