遵循标准Go项目布局时Docker构建上下文冲突问题求助

我来帮你搞定这个问题，核心是搞清楚Cloud Build的构建上下文范围，完全可以保留/build目录下的Dockerfile和cloudbuild.yaml，同时遵循《Standard Go Project Layout》的规范：

1. 修正Dockerfile的COPY路径 #

问题出在你之前的COPY ../——Docker不允许访问构建上下文之外的路径，但Cloud Build默认是以项目根目录作为构建上下文的（哪怕cloudbuild.yaml在/build里）。所以把Dockerfile里的COPY命令改成基于根目录的相对路径即可：

# /build/Dockerfile
FROM golang:alpine
RUN apk update && apk add git
# 构建上下文是项目根目录，直接复制根目录所有内容到Go模块路径
COPY . /go/src/github.com/username/repository
# 注意：生产环境请用vendor替代go get！
RUN go get -v github.com/username/repository/foo-module
RUN go install github.com/username/repository/foo-module
ENTRYPOINT ["/go/bin/foo-module"]

2. 调整cloudbuild.yaml的构建参数 #

确保Docker build命令明确指定Dockerfile的位置，并且构建上下文指向项目根目录：

# /build/cloudbuild.yaml
steps:
- id: Build
  name: "gcr.io/cloud-builders/docker"
  args: [ 
    "build", 
    "--file", "build/Dockerfile",  # 相对于根上下文的Dockerfile路径
    "."  # 构建上下文为项目根目录
  ]

原理说明 #

• Cloud Build执行时，默认会将整个项目根目录作为构建上下文上传，所以所有路径都是相对于根目录的，和cloudbuild.yaml的位置无关。
• 当你运行docker build --file build/Dockerfile .时，.代表根目录是上下文，Docker会读取build/Dockerfile，此时Dockerfile里的COPY . /xxx会复制根目录的所有内容，完全符合Docker的上下文规则，不会再出现Forbidden path outside the build context的错误。

生产环境优化建议 #

正如你注释里提醒的，生产环境绝对不要用go get，推荐：

• 使用go mod vendor生成本地依赖目录，在Dockerfile里复制vendor目录，保证依赖版本固定。
• 采用多阶段构建，先用golang镜像编译二进制文件，再把二进制复制到轻量的alpine或scratch镜像中，大幅减小镜像体积。

内容的提问来源于stack exchange，提问作者Jack