Go部署脚本需显式设置os/exec.Command的Dir和Env，用Run()替代Output()并配合健康检查；CI构建须指定GOOS/GOARCH交叉编译；失败时用defer清理、log.Fatal终止。
用 Go 写部署脚本时，os/exec 调用 docker-compose 最常用也最易出错
Go 本身不提供“一键部署微服务”的标准库，实际落地基本靠组合 os/exec + 外部工具（如 docker-compose、kubectl）。直接调用 docker-compose up -d 看似简单，但容易卡在环境变量未加载、工作目录错误、或命令阻塞等待日志输出。
- 必须显式设置
cmd.Dir指向docker-compose.yml所在目录，否则报ERROR: .Env file not found或找不到服务定义 - 避免用
cmd.Output()，它会等命令完全退出并读取全部 stdout/stderr——而docker-compose up -d启动后立即返回，但后台容器可能还没 ready；应改用cmd.Run()配合后续健康检查 - 敏感配置（如 registry auth）别硬编码进 Go 脚本，通过
os.Getenv("DOCKER_REGISTRY_USER")注入，并在 CI 环境中由 runner 提前设置
package main
import (
"log"
"os/exec"
"time"
)
func deployWithDockerCompose() error {
cmd := exec.Command("docker-compose", "up", "-d")
cmd.Dir = "/path/to/your/compose-dir" // 必须设对
cmd.Env = append(cmd.Env, "DOCKER_REGISTRY_USER="+os.Getenv("DOCKER_REGISTRY_USER"))
if err := cmd.Run(); err != nil {
return err
}
// 等待服务端口可连（示例：检查 gateway 是否响应）
return waitForPort("localhost:8080", 60*time.Second)
}
CI 流水线里用 Go 构建二进制时，GOOS 和 GOARCH 必须显式指定
本地开发机是 macOS x86_64，但目标服务器大概率是 Linux amd64 或 arm64。不设交叉编译参数，go build 默认产出当前平台二进制，放到服务器上直接报 cannot execute binary file: Exec format error。
- CI 脚本中执行构建，必须写全：
GOOS=linux GOARCH=amd64 go build -o service-linux-amd64 ./cmd/service - 若要支持多架构（比如树莓派集群），可并行构建：
GOOS=linux GOARCH=arm64 go build -o service-arm64 ./cmd/service - 加
-ldflags="-s -w"去掉调试信息，二进制体积能小 30% 以上，对容器镜像层大小有直接影响
用 github.com/docker/docker SDK 直接操作 Docker API，比 shell 调用更可控但更重
当需要动态拉取镜像、检查容器状态、甚至注入临时配置卷时，shell 脚本难维护，这时该上官方 SDK。但它不是“开箱即用”——必须确保 Go 进程能访问 /var/run/docker.sock（CI 中常需挂载）且用户有权限。
- 初始化 client 时别忽略超时：
client, err := docker.NewClientWithOpts(docker.FromEnv, docker.WithAPIVersionNegotiation(), docker.WithTimeout(30*time.Second)) - 拉镜像用
ImagePull并读取响应流解析进度，避免“卡住无反馈”；不要用ImageCreate，它已弃用 - 启动容器后，立刻用
ContainerInspect查NetworkSettings.IPAddress或Ports，而不是靠约定端口——尤其在 host 网络模式下端口可能冲突
部署失败时，defer 清理 + os.Exit(1) 是底线保障
自动化部署最怕“半截状态”：镜像拉了一半、旧容器删了新容器没起来、配置文件覆盖错了。Go 脚本里没有 finally，得靠 defer 显式收尾。
立即学习“go语言免费学习笔记（深入）”；
- 每次
docker-compose down或docker rm -f前，先defer一个回滚函数，比如恢复备份的配置文件 - 所有关键步骤后加
if err != nil { log.Fatal(err) }，别让错误静默吞掉；log.Fatal底层调os.Exit(1)，CI 工具能据此标记任务失败 - 别依赖
panic——它不触发defer在 goroutine 中的行为不可控，且无法被 CI 解析为明确错误码
cmd.Dir 的 exec.Command，或一次忘了 GOOS=linux 的构建，就足以让整条流水线在生产环境前卡住。 
