GitLab-CI中使用digitalocean/doctl镜像执行命令失败求助

错误原因分析 #

1. 第一个错误（unknown command "sh"）
   digitalocean/doctl 镜像的默认 ENTRYPOINT 就是 doctl 命令本身。GitLab CI 执行 Job 时，会默认尝试启动 shell（比如 sh）来运行脚本，这就导致实际执行的命令变成了 doctl sh，而 sh 并不是 doctl 的子命令，因此报错。

2. 第二个错误（doctl: command not found）
   设置 entrypoint: [""] 后，GitLab CI 会使用默认的 shell（比如 /bin/bash），但该镜像基于 Alpine Linux，默认没有 bash；同时空 entrypoint 会导致环境变量 PATH 加载异常，shell 无法找到位于 /usr/local/bin/doctl 的命令文件。

正确的 Job 配置 #

通过指定正确的 entrypoint 为 shell 即可解决问题，配置如下：

deploy-to-kubernetes:
  stage: deploy
  image:
    name: digitalocean/doctl:1.87.0
    entrypoint: ["/bin/sh", "-c"]
  script:
    - doctl --help

原理说明：指定 entrypoint 为带 -c 参数的 shell 命令后，GitLab CI 会将 script 中的命令传递给 shell 执行，而非直接传给 doctl；同时 /usr/local/bin 属于镜像默认的 PATH 路径，因此可以直接调用 doctl。

提问改进建议 #

• 可以补充当前使用的 GitLab CI 版本（若不是最新稳定版），帮助排查版本兼容问题
• 后续涉及 Kubernetes 部署时，可提前说明是否已在 GitLab CI 变量中配置 DigitalOcean API Token、Kubernetes 集群 ID 等必要信息
• 你当前的提问已经清晰列出问题场景、尝试步骤和错误信息，结构规范，这点值得保持

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