GCP CloudBuild流水线Shell参数展开替换失败问题及解决方案咨询

问题背景 #

根据GCP CloudBuild官方文档，流水线替换支持Shell参数展开功能，我想基于Git分支名生成符合要求的Docker镜像标签（仅小写字符、无斜杠），编写了以下替换规则：

substitutions:
    _BRANCH_NAME_LOWERCASED: ${BRANCH_NAME,,} # 转为小写
    _BRANCH_NAME_FLATTENED: ${_BRANCH_NAME_LOWERCASED////-} # 将"/"替换为"-"
    _DOCKER_IMAGE_TAG: ${SHORT_SHA:-$_BRANCH_NAME_FLATTENED}

报错情况 #

第二步替换执行失败，报错：

[_BRANCH_NAME_FLATTENED -> ${_BRANCH_NAME_LOWERCASED////-}]: bad substitution

第一步转小写的展开逻辑正常运行，说明CloudBuild的替换功能仅部分支持Shell参数展开，但同样的逻辑在Bash CLI中可以正常执行：

$ SHORT_SHA=
$ BRANCH_NAME=BRANCH-80/some-fancy-feature
$
$ _BRANCH_NAME_LOWERCASED=${BRANCH_NAME,,}
$ _BRANCH_NAME_FLATTENED=${_BRANCH_NAME_LOWERCASED////-}
$ _DOCKER_IMAGE_TAG=${SHORT_SHA:-$_BRANCH_NAME_FLATTENED}
$
$ echo $_DOCKER_IMAGE_TAG
branch-80-some-fancy-feature

问题 #

1. 是我有配置遗漏，还是CloudBuild的替换功能确实仅部分实现了Shell参数展开？
2. 有没有其他方法可以生成符合要求的镜像标签？

更新尝试 #

同事建议转义第二个展开规则中的斜杠，测试了以下写法不会抛出错误，但实际未起到替换作用（推测是在匹配字面量\/，而目标字符串中不存在该内容）：

_BRANCH_NAME_FLATTENED: ${_BRANCH_NAME_LOWERCASED//\\//-}

解决方案 #

问题1解答 #

CloudBuild的替换功能对Shell参数展开的支持确实是部分实现，官方文档中明确的可用语法仅包含大小写转换（${var,,}）、默认值填充（${var:-default}）等基础操作，像全局字符串替换（${var//pattern/replacement}）这类复杂语法不在支持范围内，这就是你遇到报错的原因。

问题2替代方案 #

有两种可靠的方式实现需求：

方案1：在构建步骤中用Bash处理标签

放弃在substitutions中完成所有逻辑，改为在构建步骤内直接生成并传递标签：

steps:
  - name: 'bash'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        # 分支名转小写并替换斜杠为短横线
        BRANCH_TAG=$(echo "${BRANCH_NAME,,}" | tr '/' '-')
        # 优先用SHORT_SHA，否则用处理后的分支名
        DOCKER_TAG=${SHORT_SHA:-$BRANCH_TAG}
        # 将标签写入文件供后续步骤读取
        echo "DOCKER_IMAGE_TAG=$DOCKER_TAG" >> /workspace/env_vars
  # 后续构建步骤读取环境变量并使用标签
  - name: 'gcr.io/cloud-builders/docker'
    entrypoint: 'bash'
    args:
      - '-c'
      - |
        source /workspace/env_vars
        docker build -t gcr.io/[你的项目ID]/[镜像名称]:$DOCKER_IMAGE_TAG .

方案2：结合内置变量与sed/tr命令一步生成标签

直接在Docker构建步骤中通过命令行工具处理标签：

steps:
  - name: 'gcr.io/cloud-builders/docker'
    args:
      - 'build'
      - '-t'
      - 'gcr.io/[你的项目ID]/[镜像名称]:$(echo ${SHORT_SHA:-$BRANCH_NAME} | tr '[:upper:]' '[:lower:]' | tr '/' '-')'
      - '.'

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