Docker构建传递可选参数化Git分支遇git clone报错128如何解决？

问题根因 #

你原始写法报错的核心原因是shell 条件判断语法错误：[ "$GIT_TAG"!="" ] 中操作符两侧缺少空格，导致无论GIT_TAG是否为空，判断都会返回真，执行带--branch参数的git命令。当GIT_TAG为空时，--branch后没有有效值，git就会返回128错误码。

实现方案 #

方案1：使用shell参数展开（最简洁，无需if判断） #

Bash、ash（Alpine默认shell）都支持${变量:+替换值}的参数展开语法：变量不为空时返回替换值，为空时返回空值，直接一行就能实现条件加参数：

ARG GIT_TAG
ARG PROJECT
# 一行完成条件克隆，无需分支判断
RUN git clone ${GIT_TAG:+--branch "$GIT_TAG"} https://github/repo/${PROJECT}.git .

方案2：同一RUN语句内定义变量传递参数 #

你之前定义的变量无法传递是因为每个独立的RUN指令都会启动新的shell进程，变量不会跨RUN保留。把变量定义和git命令放在同一个RUN语句里即可：

ARG GIT_TAG
ARG PROJECT
RUN \
  # 先判断并定义分支参数
  if [ -n "$GIT_TAG" ]; then \
    BRANCH_ARG="--branch $GIT_TAG"; \
  else \
    BRANCH_ARG=""; \
  fi && \
  # 同一个shell进程内直接使用变量
  git clone $BRANCH_ARG https://github/repo/${PROJECT}.git .

方案3：传入完整参数 #

如果要通过build arg直接传完整参数，不需要额外加引号，shell会自动处理参数解析：
调用命令：

# GIT_TAG为空时BRANCH_PARAM直接设为空即可
GIT_TAG=1.0.0
BRANCH_PARAM=${GIT_TAG:+--branch "$GIT_TAG"}
docker build ... --build-arg BRANCH_PARAM="$BRANCH_PARAM" ...

Dockerfile写法：

ARG BRANCH_PARAM
ARG PROJECT
RUN git clone $BRANCH_PARAM https://github/repo/${PROJECT}.git .

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