Jenkins集成Docker Swarm自动化部署需打通权限、适配环境、管理凭证与编排Pipeline四大环节：配置远程Docker CLI指向Swarm Manager，启用TLS认证，通过withCredentials注入registry凭证，Pipeline中执行docker stack deploy并使用--with-registry-auth拉取私有镜像。
Jenkins 集成 Docker Swarm 实现自动化部署，核心在于让 Jenkins 能够调用 Swarm 集群执行 docker stack deploy 或 docker service update。整个过程不是简单装个插件就完事，而是涉及权限打通、环境适配、凭证管理与 Pipeline 编排四个关键环节。
确保 Jenkins 可访问 Swarm Manager 节点
Jenkins 本身不直接运行在 Swarm 集群内时，需通过远程 Docker API 控制集群。 - Swarm Manager 必须开启 TCP 监听（如 `dockerd -H tcp://0.0.0.0:2375 -H unix:///var/run/docker.sock`），生产环境建议启用 TLS 认证； - Jenkins 所在服务器需能网络连通 Manager 的 2375（或加密端口如 2376）； - 若 Jenkins 运行在容器中，**不要依赖挂载 `/var/run/docker.sock`** —— 因为该 socket 指向的是宿主机 Docker Daemon，而非 Swarm 集群的控制面，容易误操作单机容器。推荐做法：在 Jenkins 服务器上配置一个专用的 Docker client，指向 Swarm Manager 的远程 endpoint，并在 Pipeline 中显式使用它。
配置 Jenkins 使用远程 Docker CLI
- 在 Jenkins 服务器（或 Jenkins Agent）上安装匹配版本的 `docker-cli`（无需完整 Docker Engine）； - 设置环境变量或在 Pipeline 中指定： DOCKER_HOST=tcp://swarm-manager-ip:2375（若未启用 TLS）； - 若启用了 TLS，则需同步挂载 ca.pem、cert.pem、key.pem 到 Jenkins 工作目录，并设置： DOCKER_HOST=tcp://swarm-manager-ip:2376DOCKER_TLS_VERIFY=1DOCKER_CERT_PATH=/path/to/certs验证方式：在 Jenkins 执行 shell 步骤中运行 docker info，输出应显示 Swarm Mode: active 和 Nodes 数量。
在 Pipeline 中调用 docker stack 部署
使用声明式 Pipeline 直接执行部署命令，避免依赖第三方插件（如旧版 Docker Plugin 对 Swarm 支持弱且已停止维护）： - 将 `docker-compose.yml`（或 `stack.yml`）提交至代码仓库根目录或指定路径； - 在 Jenkinsfile 中编写部署阶段：- 检出代码后，进入含 compose 文件的目录；
- 替换镜像标签（如将
IMAGE_LATEST替换为实际构建的镜像名+tag）； - 执行
docker stack deploy -c docker-compose.yml --with-registry-auth myapp； - 添加
--prune参数可自动删除不再使用的服务； - 配合
docker stack ps myapp --no-trunc做状态轮询，确认服务就绪。
注意：--with-registry-auth 是关键——它让 Swarm 节点拉取私有镜像时复用 Jenkins 凭证中配置的 registry 登录信息（需提前在 Jenkins 中添加 Docker Registry Credential）。
安全与凭证统一管理
- 在 Jenkins → Credentials → System → Global credentials 中添加两类凭证： Docker Registry Username/Password：用于推送镜像到私仓，也供--with-registry-auth 使用；
SSH Username with private key（可选）：若需在 Manager 节点上执行额外脚本（如清理旧卷、重载配置）；
- Pipeline 中引用方式统一使用 withCredentials 绑定环境变量或文件路径，避免硬编码；
- 不建议把证书文件直接写死在 Jenkinsfile 或挂载到容器，应通过 Jenkins 内置凭证系统注入。
部署失败常见原因：镜像未提前推送到所有 Worker 节点可访问的 registry、compose 文件中 service 名称冲突、资源限制超出节点容量、TLS 证书链不完整。每次 deploy 后建议用 docker stack services myapp 和 docker service logs myapp_web 快速定位。
