在Bitbucket流水线中使用skaffold build时如何将Git标签纳入前端构建

1. 调整Skaffold配置，将Git标签纳入镜像标签 #

当前你的Skaffold tagPolicy仅生成包含时间戳和短提交哈希的标签，未纳入Git标签，且需确保{{.IMAGE_TAG}}能正确传递给构建参数。修改skaffold.yaml的tagPolicy部分：

tagPolicy:
  customTemplate:
    template: "{{.TAG}}-{{.TIMESTAMP}}-{{.COMMIT}}" # 可按需调整标签顺序
    components:
      - name: TAG
        gitTag:
          fallback: "latest" # 若当前提交无Git标签，用该值兜底
      - name: TIMESTAMP
        dateTime:
          format: "200601021504"
          timezone: America/New_York
      - name: COMMIT
        gitCommit:
          variant: AbbrevCommitSha

此配置会让镜像标签包含Git标签（若存在），无标签时使用兜底值，避免{{.IMAGE_TAG}}为空。

2. 修正Skaffold构建参数的语法 #

简化buildArgs的引号写法（YAML中无需转义双引号）：

build:
  artifacts:
    - image: my.docker.repo/my-org/my-frontend-test
      context: ./
      docker:
        dockerfile: Dockerfile
        buildArgs:
          VITE_APP_VERSION: "{{.IMAGE_TAG}}"

3. 优化Dockerfile的环境变量作用域 #

将ARG VITE_APP_VERSION移至FROM指令后，明确其作用域，确保变量能被正确读取：

ARG BASE=my.docker.repo/my-org/my-frontend-test-base:latest
FROM $BASE as base-image

ARG VITE_APP_VERSION # 移至FROM后，作用域更清晰
ENV VITE_APP_VERSION=$VITE_APP_VERSION

WORKDIR /build/frontend

COPY . /build/frontend/
RUN pnpm config set strict-peer-dependencies=false && pnpm install

RUN echo "IMAGE TAG IS: ${VITE_APP_VERSION}"
RUN echo "VITE_APP_VERSION=${VITE_APP_VERSION}" >> .env
RUN pnpm build

4. 确保Git标签存在（可选） #

若需使用实际Git标签，构建前给当前提交打标签并推送：

git tag v1.0.0
git push origin v1.0.0

无标签时，Skaffold会使用配置的兜底值，避免VITE_APP_VERSION显示。

5. 验证构建参数传递 #

在Bitbucket流水线中添加预验证步骤，提前确认变量是否正确：

skaffold build --dry-run # 查看Skaffold生成的标签和构建参数

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