如何将Docker容器内的错误传递至宿主机Jenkins？最优方案探讨

嘿，这个需求其实Docker本身就完美支持，完全不需要依赖docker-compose——核心逻辑就是Docker会把容器内主进程的退出码直接返回给宿主机，而Jenkins会自动捕获这个退出码来判断构建是否失败。下面给你一步步拆解：

一、先搞懂：Docker容器的退出码怎么来的？ #

Docker容器的退出码，就是容器内主进程的退出码。比如你在容器里运行Node.js脚本，只要脚本在失败时返回非0的退出码（比如1），容器终止时就会把这个码传给宿主机。所以关键是让你的Node.js脚本正确返回退出码。

示例：给Node.js脚本加退出码逻辑 #

假设你的业务脚本index.js，只要在成功/失败时明确指定退出码就行：

// index.js
try {
  // 这里放你的业务逻辑，比如接口调用、数据处理
  console.log("脚本执行成功啦！");
  process.exit(0); // 成功时返回0，这是标准约定
} catch (err) {
  console.error("脚本炸了：", err);
  process.exit(1); // 失败时返回1，非0都会被视为错误
}

只要脚本里用process.exit(code)指定了码，容器就会继承这个值。

二、Jenkins里怎么配置？直接用docker run就行 #

在Jenkins的构建步骤里，直接执行docker run命令，Jenkins会自动检查命令的退出码——如果docker run返回非0，就会标记构建失败，完全不用额外配置。

两种常见场景的Jenkins命令： #

场景1：脚本已经打包在Docker镜像里

如果你的Node.js脚本已经和依赖一起打包成镜像了，直接运行：

# 拉取镜像（如果本地没有的话）
docker pull your-node-app:latest

# 运行容器，--rm表示退出后自动删除容器，避免残留
docker run --rm your-node-app:latest node index.js

场景2：脚本在Jenkins工作目录（需要挂载进去）

如果脚本是Jenkins从代码仓库拉下来的，需要挂载到容器里执行：

docker run --rm \
  -v $WORKSPACE:/app \  # 把Jenkins工作目录挂载到容器的/app路径
  -w /app \             # 设置容器的工作目录为/app
  your-node-image:latest \
  node index.js

三、为什么说不需要docker-compose？ #

docker-compose是用来编排多容器环境的（比如同时跑应用、数据库、缓存），而你只是单容器执行脚本并传递退出码，用docker run就足够简洁高效了。当然如果因为其他原因一定要用docker-compose，也能实现，但属于过度设计。

（可选）docker-compose的配置方式（非必需） #

如果非要用，写个docker-compose.yml：

version: '3.8'
services:
  node-task:
    image: your-node-image:latest
    command: node index.js
    volumes:
      - ./:/app  # 挂载当前目录（Jenkins工作目录）到容器/app
    working_dir: /app

然后在Jenkins里执行：

docker-compose up --exit-code-from node-task

--exit-code-from参数会让docker-compose返回指定服务的退出码，这样Jenkins也能捕获到失败信号，但还是那句话，单容器场景下docker run更直接。

四、本地验证一下退出码是否正确传递 #

你可以先在本地测试，确保逻辑没问题：

1. 故意让脚本失败，运行容器：

docker run --rm your-node-image:latest node index.js

2. 查看宿主机的退出码：

echo $?

如果脚本返回1，这里会输出1，说明Docker已经正确传递了退出码，Jenkins执行时也是同样的逻辑。

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