为何GitLab流水线中无法使用apk包管理器？

为什么指定Alpine镜像仍报错？ #

你使用的是Shell执行器的GitLab Runner，这类执行器不会按照job里的image配置拉取容器镜像运行命令——它直接在Runner所在的物理/虚拟主机上执行所有脚本。你的主机系统大概率不是Alpine（比如是Ubuntu、CentOS这类），自然没有apk包管理命令，所以会触发command not found错误。

解决方案 #

方案1：改用Docker执行器（推荐） #

将GitLab Runner的执行器改为Docker类型，这样每个job会独立拉取配置的镜像，在容器内执行命令：

• 修改Runner配置文件（通常路径为/etc/gitlab-runner/config.toml），把executor = "shell"替换为executor = "docker"，并确保配置了正确的镜像拉取相关参数。
• 修改完成后重启GitLab Runner服务。
• 你的现有流水线配置无需改动，deploy阶段会自动拉取alpine:3.14镜像，在容器内正常执行apk add openssh-client。

方案2：保留Shell执行器，适配主机环境 #

如果必须继续使用Shell执行器，直接在Runner主机上安装openssh-client，再修改deploy阶段脚本：

1. 根据主机系统安装ssh客户端：
   • Debian/Ubuntu系统：sudo apt update && sudo apt install -y openssh-client
   • CentOS/RHEL系统：sudo yum install -y openssh-clients
2. 修改流水线的deploy部分，删除apk add openssh-client行（主机已具备ssh工具）：

deploy:
    only:
        - main
    before_script:
        - eval $(ssh-agent -s)
        - echo "$SSH_PRIVATE_KEY" | tr -d '\r' | ssh-add -
        - mkdir -p ~/.ssh
        - chmod 700 ~/.ssh
    script:
        - ssh myusername@$IP_ADDRESS -p 3000 "/home/myusername/deploy.sh && exit"

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