用途:在需要构建 Docker 镜像时,用 Depot 远程构建替代本地 docker build 或 docker buildx。
主要能力:覆盖 depot build 与 depot bake 的用法、多平台镜像构建、缓存行为与远程构建器的取舍、镜像的 registry 推送/加载/保存行为,以及常见 Depot 构建失败的排查。
核心规则:优先用 depot build 直接替代 docker buildx build;明确使用 --push、--load 或 --save,不要假设远程构建后本地已存在镜像;在 Depot 支持目标架构时优先原生多平台构建而非模拟;将远程缓存视为默认行为而非附加功能。
典型流程:确认目标 Dockerfile、构建上下文和输出模式;决定镜像应本地加载、推送还是远程保存;先运行最小可用的构建命令;若构建失败,先排查 Dockerfile 问题再怀疑 Depot 特有问题。
限制与注意:远程构建不会自动加载到本地 Docker 守护进程;provenance 设置可能影响 registry 的平台元数据;secrets、SSH 转发和 registry 认证需显式配置。具体命令示例与更多细节暂未提供。