GCP Cloud Build中$REPO_NAME变量替换失效问题求助

核心问题诊断 #

你的脚本里$REPO_NAME没有被解析为实际仓库名称，而是被当作字符串直接使用，大概率是以下两个原因之一：

1. 该变量未被正确注入到当前CI步骤的环境中
2. 你使用的CI系统要求特定的变量引用语法（而非直接的$REPO_NAME）

分步解决方案 #

1. 先确认变量是否存在 #

在脚本开头添加变量打印命令，验证变量能否被正确读取：

steps:
- name: 'ubuntu'
  id: 'prerequisite'
  script: |
    #!/usr/bin/env bash
    # 打印变量值，确认是否存在
    echo "REPO_NAME 变量值: $REPO_NAME"
    echo "系统环境变量列表: "
    env | grep REPO
    # 后续原有命令
    mkdir /tmp/$REPO_NAME
    mv -v * /tmp/$REPO_NAME/
    cp -r /tmp/$REPO_NAME /workspace/
    ls -ltr

运行后如果输出为空或显示$REPO_NAME，说明变量未被正确注入。

2. 确保变量被正确注入 #

情况A：使用CI系统自带的仓库名称变量

不同CI系统的仓库名称变量名不同，常见的有：

• GitHub Actions: GITHUB_REPOSITORY_NAME（仅仓库名，不含所有者）
• GitLab CI: CI_PROJECT_NAME
• Jenkins: JOB_NAME（需根据实际配置调整）

把脚本里的$REPO_NAME替换为对应系统的变量名即可，比如GitHub Actions下修改为：

steps:
- name: 'ubuntu'
  id: 'prerequisite'
  script: |
    #!/usr/bin/env bash
    REPO_NAME=$GITHUB_REPOSITORY_NAME
    mkdir /tmp/$REPO_NAME
    mv -v * /tmp/$REPO_NAME/
    cp -r /tmp/$REPO_NAME /workspace/
    ls -ltr

情况B：使用自定义变量

如果REPO_NAME是你自定义的变量，需要在CI配置中明确传递给该步骤：

steps:
- name: 'ubuntu'
  id: 'prerequisite'
  # 注入自定义变量
  env:
    REPO_NAME: "DEMO" # 或从其他步骤传递的动态值，比如${{ steps.xxx.outputs.repo_name }}
  script: |
    #!/usr/bin/env bash
    mkdir /tmp/$REPO_NAME
    mv -v * /tmp/$REPO_NAME/
    cp -r /tmp/$REPO_NAME /workspace/
    ls -ltr

3. 检查CI系统的变量引用语法 #

部分CI系统要求在YAML中使用模板语法引用变量，而非直接的shell变量格式，比如GitHub Actions中如果是环境变量，需要用${{ env.REPO_NAME }}：

steps:
- name: 'ubuntu'
  id: 'prerequisite'
  env:
    REPO_NAME: ${{ github.event.repository.name }}
  script: |
    #!/usr/bin/env bash
    mkdir /tmp/${{ env.REPO_NAME }}
    mv -v * /tmp/${{ env.REPO_NAME }}/
    cp -r /tmp/${{ env.REPO_NAME }} /workspace/
    ls -ltr

这种写法会让CI系统在执行脚本前先完成变量替换，再传递给shell执行。

验证结果 #

修改后重新运行流程，查看ls -ltr的输出，确认/workspace/下生成的是DEMO文件夹而非$REPO_NAME。

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