Cloud Build步骤中环境变量引用Secret值的替换问题

问题原因 #

你当前的问题核心有两点：

• 使用单个$_URL时，Cloud Build会将其识别为内置替换项，但_URL并非Cloud Build的默认替换变量，因此触发报错。
• 使用$$_URL时，Cloud Build会把$$转义为单个$，最终生成的环境变量值是$_URL/movies，但如果脚本写法不对（比如直接echo URL而非echo $URL），shell不会展开变量，只会输出原字符串$_URL/movies。

解决方案 #

提供两种可行方案，按需选择：

方案一：调整环境变量定义与脚本写法 #

保留env字段的拼接逻辑，通过转义避免Cloud Build解析冲突，同时让shell正确展开变量：

- name: 'ubuntu'
  env:
   - 'URL="$$_URL/movies"'
  secretEnv: ['_URL']
  script: 'echo "$URL"'
availableSecrets:
 secretManager:
  - versionName: projects/$PROJECT_ID/secrets/url/versions/latest
    env: '_URL'

• $$_URL会被Cloud Build转义为$_URL，容器内URL环境变量的值为"$_URL/movies"。
• echo "$URL"会触发shell将$_URL替换为Secret注入的实际值，最终输出拼接后的完整地址。

方案二：在脚本内直接拼接（更简洁） #

跳过env字段的拼接，直接在shell脚本中完成变量组合，彻底规避Cloud Build的替换冲突：

- name: 'ubuntu'
  secretEnv: ['_URL']
  script: |
    FULL_URL="$_URL/movies"
    echo "$FULL_URL"
availableSecrets:
 secretManager:
  - versionName: projects/$PROJECT_ID/secrets/url/versions/latest
    env: '_URL'

• 以|开头的多行脚本中，Cloud Build不会将$_URL识别为内置替换项，会直接传递给shell处理。
• 脚本内通过$_URL引用Secret注入的环境变量，完成拼接后输出结果。

关键注意事项 #

• Secret注入的环境变量名是_URL，shell中引用必须写$_URL（不能遗漏下划线）。
• 引用变量时建议用双引号包裹（如"$FULL_URL"），避免路径含特殊字符时出现解析异常。

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