如何在GitLab CI中将变量存储的带值参数正确传入Testim执行命令

问题根因 #

你遇到的执行失败是两个错误共同导致的：

1. 你在docker run的参数列表中写了echo $LABELS，这是语法错误：此处需要直接传入标签参数给Testim运行器，不需要执行echo命令打印内容。
2. 带空格、引号的多参数不能存储在普通字符串变量中：shell展开普通字符串变量时只会按空格拆分内容，不会识别你写在变量内部的单引号，从你set -xv的输出就能看到Edit Entity标签被拆成了Edit和Entity两个独立参数，不符合Testim的参数格式要求。

最优解决方案（无分词风险） #

使用Bash数组存储标签参数，完全避免空格拆分问题：

1. 首先替换原来的标签解析逻辑，直接把参数存入数组：

TESTIM_DOCKER=testim/docker-cli
TESTIM_TOKEN=some_token
TESTIM_PROJECT=some_project
GRID_NAME=some_grid

# 该参数来自流水线UI配置：
TESTIM_LABELS="Tryout,Integration,Edit Entity"

# 初始化标签参数数组
LABEL_ARGS=()
# 按逗号分割标签字符串
IFS=',' read -ra LABEL_LIST <<< "$TESTIM_LABELS"
for label in "${LABEL_LIST[@]}"; do
  # 去除标签前后多余空格后，逐个添加--label参数到数组
  trimmed_label=$(echo "$label" | xargs)
  LABEL_ARGS+=(--label "$trimmed_label")
done

如果你要保留原有的parse_testim_labels.sh脚本，可以修改脚本输出为每行一个参数，再读入数组：

# 假设parse_testim_labels.sh调整输出格式后每行输出一个参数，例如第一行--label，第二行tryout，第三行--label，第四行Integration以此类推
mapfile -t LABEL_ARGS < <(./scripts/misc/parse_testim_labels.sh "$TESTIM_LABELS")

2. 修改docker run命令，直接展开数组作为参数即可：

docker run --rm -v "$(pwd)":/opt/testim-runner $TESTIM_DOCKER \
--token $TESTIM_TOKEN \
--project $TESTIM_PROJECT \
"${LABEL_ARGS[@]}" \
--grid $GRID_NAME \
--base-url $TESTIM_BASE_URL \
--report-file /opt/testim-runner/testim-report.xml

临时兼容方案（不推荐，仅做应急） #

如果暂时不想调整原有解析逻辑，可以用eval强制shell重新解析字符串里的引号，注意仅当你确定TESTIM_LABELS的内容完全可控时才可以使用，避免命令注入风险：

eval docker run --rm -v \"$(pwd)\":/opt/testim-runner $TESTIM_DOCKER \
--token $TESTIM_TOKEN \
--project $TESTIM_PROJECT \
$LABELS \
--grid $GRID_NAME \
--base-url $TESTIM_BASE_URL \
--report-file /opt/testim-runner/testim-report.xml

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