如何在Jenkins任务配置中重启Docker容器？

当然可以实现！不用手动在本地敲命令，我们完全可以通过Jenkins的任务配置直接完成远程Docker容器重启，再衔接Maven测试任务。下面是具体的操作步骤：

第一步：让Jenkins能访问到远程Docker主机 #

首先得确保Jenkins所在服务器（或代理节点）能连接到企业内部的Docker服务器，这样才能执行Docker命令。有两种常用配置方式：

方式1：全局节点配置环境变量 #

进入Jenkins的Manage Jenkins -> Manage Nodes and Clouds，点击你要用的节点（比如主节点）进入配置页，找到Node Properties，勾选Environment variables，添加：

• 名称：DOCKER_HOST
• 值：tcp://[serverName]:2375（默认Docker远程端口是2375，若你们服务器改了端口就替换；生产环境建议用2376端口加TLS认证，后续会提）

方式2：单个任务临时配置 #

如果不想全局生效，可在目标Jenkins任务的Build Environment部分，勾选Inject environment variables to the build process，在Properties Content里添一行：

DOCKER_HOST=tcp://[serverName]:2375

第二步：在Jenkins任务中执行容器重启命令 #

在任务的Build步骤里添加一个Execute shell（Linux节点）或Execute Windows batch command（Windows节点），输入重启命令：

docker restart [containerId]

小提示：如果Docker服务器需要认证，可提前用Jenkins的Credentials插件存储账号密码，在任务里调用docker login命令完成认证。

第三步：衔接Maven测试任务 #

有两种方式实现后续的Maven测试触发：

方式1：同一任务内连续执行 #

如果Maven测试和容器重启是同一流程，可在刚才的Shell步骤后，再添加一个Invoke top-level Maven targets步骤，配置你的Maven命令（比如clean test），确保Maven能访问到重启后的容器（比如服务地址配置正确）。

方式2：触发独立的Maven任务 #

如果Maven测试是单独的Jenkins任务，可在当前任务的Post-build Actions里添加Build other projects，勾选目标Maven任务名称，设置触发条件（比如Trigger only if build is stable）。

额外注意事项 #

• 权限问题：确保Jenkins运行用户（比如jenkins用户）有执行Docker命令的权限，可在Docker服务器上将Jenkins节点用户加入docker组。
• 等待容器就绪：docker restart命令返回后，容器内服务可能还没完全启动，容易导致测试失败。可以在重启命令后加一段等待脚本：

# 等待容器处于running状态
until docker inspect -f '{{.State.Running}}' [containerId] | grep -q "true"; do
  sleep 5
done
# 等待服务端口可用（比如8080端口）
until nc -z [serverName] 8080; do
  sleep 5
done

• TLS安全连接：生产环境建议开启Docker TLS认证，需在Jenkins节点上配置TLS证书，或添加环境变量DOCKER_TLS_VERIFY=1和DOCKER_CERT_PATH=/path/to/certs。

这样整个流程就完全自动化了，不需要手动在本地执行任何命令，Jenkins会帮你完成容器重启+Maven测试的全流程。

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