GitLab Runner向自定义镜像传参错误问题求助

GitLab Runner执行Job时，默认会把script中的命令包装成sh -c "你的命令"来运行。而你的镜像设置了ENTRYPOINT ["./run.sh"]，Docker会将sh作为第一个参数传递给run.sh，脚本又把这个参数传给了Java CLI工具。但你的CLI要求第一个参数必须是upload/download/apply中的一个，因此Argparse4j抛出了invalid choice: 'sh'的错误。

方法1：将Dockerfile中的ENTRYPOINT改为CMD #

把镜像的启动指令从ENTRYPOINT换成CMD，这样GitLab Runner的sh -c会覆盖CMD，直接执行shell命令。同时可以把run.sh放到系统PATH目录，让命令可以直接调用：

修改Dockerfile：

FROM openjdk:18

ENV JAR_NAME "my-jar-with-dependencies.jar"

ENV PROJECT_HOME /opt/app
RUN mkdir -p $PROJECT_HOME

WORKDIR $PROJECT_HOME
# 把run.sh复制到PATH目录并改名成工具名，比如tool
COPY run.sh /usr/local/bin/tool
RUN chmod +x /usr/local/bin/tool

COPY target/$JAR_NAME $PROJECT_HOME/cli.jar

# 默认启动工具，可被GitLab的script覆盖
CMD ["tool"]

然后更新CI的script：

script:
  - tool download -f zip -u true test-download.zip

这样配置后，GitLab Runner会先启动shell，然后在shell里直接调用tool命令执行下载操作，参数会正确传递给CLI工具。

方法2：修改run.sh脚本，兼容shell调用 #

如果坚持使用ENTRYPOINT，可以在脚本开头判断是否是shell启动请求，优先进入shell，再处理后续命令：

修改run.sh：

#!/bin/bash

# 如果第一个参数是shell命令，直接执行shell
if [ "$1" = "sh" ] || [ "$1" = "bash" ]; then
    exec "$@"
fi

# 否则正常执行CLI工具
java $JAVA_OPTS -Djava.security.egd=file:/dev/./urandom -jar ./cli.jar "$@"

然后CI的script需要调整为调用脚本并传递命令：

script:
  - ./run.sh download -f zip -u true test-download.zip

这个方法让脚本兼容两种场景：本地直接运行镜像时执行CLI，GitLab CI里先启动shell再执行命令。

方法3：直接在CI中调用Java命令（临时方案） #

如果不想修改镜像，也可以在CI脚本里直接指定Java命令和jar包路径：

script:
  - java -jar /opt/app/cli.jar download -f zip -u true test-download.zip

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