Jenkins(Docker)流水线报错：无法通过Docker Compose部署应用

常见报错原因及对应修复 #

1. Jenkins容器内缺少Docker/Docker Compose环境 #

原因：官方Jenkins镜像默认未安装Docker客户端和Docker Compose，执行docker-compose命令会抛出command not found错误。
修复方案：

• 方法一：挂载宿主机的Docker组件到Jenkins容器，修改启动命令：

sudo docker run -d -v jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker -v $(which docker-compose):/usr/bin/docker-compose -p 8080:8080 -p 50000:50000 --restart=on-failure jenkins/jenkins:lts-jdk11

• 方法二：自定义Jenkins镜像，在Dockerfile中预装依赖：

FROM jenkins/jenkins:lts-jdk11
USER root
RUN apt-get update && apt-get install -y docker.io docker-compose
USER jenkins

2. Docker权限不足 #

原因：Jenkins容器内的jenkins用户无权限访问Docker socket，执行命令会出现permission denied错误。
修复方案：
启动容器时添加用户组映射，让Jenkins用户继承宿主机docker组的权限：

sudo docker run -d -v jenkins_home:/var/jenkins_home -v /var/run/docker.sock:/var/run/docker.sock -v $(which docker):/usr/bin/docker -v $(which docker-compose):/usr/bin/docker-compose --group-add $(getent group docker | cut -d: -f3) -p 8080:8080 -p 50000:50000 --restart=on-failure jenkins/jenkins:lts-jdk11

3. docker-compose up阻塞流水线 #

原因：docker-compose up默认前台运行，会持续占用流水线进程，导致后续阶段无法执行，流水线一直处于挂起状态。
修复方案：
添加-d参数让容器后台启动：

stage('Docker Up') {
    steps {
        sh 'docker-compose up -d'
    }
}

4. SCM检出失败 #

原因：Jenkins项目的SCM配置有误（未添加仓库凭证、仓库地址错误等），导致checkout scm执行失败。
修复方案：
进入Jenkins项目配置页面，在「流水线」模块确认「定义」选择「Pipeline script from SCM」，正确填写仓库URL并添加对应访问凭证（SSH密钥或账号密码）。

5. Python环境缺失 #

原因：Jenkins容器或代理节点未安装Python，执行python main.py会抛出command not found错误。
修复方案：
在Deploy阶段先安装Python（以Debian/Ubuntu环境为例）：

stage('Deploy') {
    when {
        branch 'develop'
    }
    steps {
        sh 'apt-get update && apt-get install -y python3 python3-pip'
        sh 'python3 main.py'
    }
}

也可以直接使用预装Python的Jenkins代理镜像。

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