如何将Google Cloud Build替换变量传入Angular应用的Dockerfile？

可能的问题点及对应解决方案 #

1. 触发器替换变量配置错误 #

先确认Cloud Build触发器的变量设置：

• 打开对应触发器的编辑页面，在「替换变量」区域，检查变量名是否为**_ANGULAR_ENV**（注意开头的下划线，大小写敏感）。
• 确认变量已经设置了有效值（比如production或development），且触发器启用了变量替换。

2. Cloud Build YAML中的冗余配置 #

你的cloudbuild.yaml第一个步骤里的env配置是多余的，它是给Docker进程本身设置环境变量，而非传递给Docker构建参数。可以直接删除这部分，简化后的步骤如下：

steps:
  - name: "gcr.io/cloud-builders/docker"
    args: ["build", "-t", "gcr.io/$PROJECT_ID/${_SERVICE_NAME}:${SHORT_SHA}", "--build-arg", "ENV=${_ANGULAR_ENV}", "-f", "Dockerfile", "."]

  - name: "gcr.io/cloud-builders/docker"
    args: ["push", "gcr.io/$PROJECT_ID/${_SERVICE_NAME}:${SHORT_SHA}"]

  - name: "gcr.io/cloud-builders/gcloud"
    args:
      [
        "run",
        "deploy", 
        "${_SERVICE_NAME}",
        "--image",
        "gcr.io/$PROJECT_ID/${_SERVICE_NAME}:${SHORT_SHA}",
        "--region",
        "europe-north1",
        "--platform",
        "managed",
        "--allow-unauthenticated"
      ]

3. Dockerfile中ARG的作用域问题 #

如果你的Dockerfile是多阶段构建，需要注意ARG的作用域：

• 在FROM指令之前定义的ARG是全局变量，但每个FROM启动的新构建阶段都需要重新用ARG ENV来引用这个全局变量，否则阶段内无法访问。
• 正确的多阶段写法示例：

# 全局ARG，定义在所有FROM之前
ARG ENV

# 构建阶段
FROM node:18 AS builder
# 引用全局ARG，让当前阶段可以访问
ARG ENV
RUN npm install
RUN echo 'ENVIRONMENT:' $ENV
RUN ng build --configuration=$ENV --output-path=dist

# 部署阶段（如果不需要ENV可省略ARG）
FROM nginx:alpine
COPY --from=builder /dist /usr/share/nginx/html

4. 验证构建日志 #

触发构建后，查看Cloud Build的详细日志：

• 找到第一个docker build步骤的执行命令，检查是否包含--build-arg ENV=你的变量值。
• 如果日志中该参数为空，说明触发器变量未正确注入，需要重新检查触发器的变量配置；如果参数有值但Dockerfile中echo为空，说明ARG作用域或引用问题。

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