Docker Swarm自定义镜像服务无法复制部署问题求助

问题场景 #

6节点Docker Swarm集群中，通过docker stack deploy --compose-file docker-compose.yml mydep部署服务后，仅公共镜像jaegertracing/all-in-one:latest正常运行（副本数1/1），5个自定义构建的服务全部显示0/1副本，无法启动。

排查与解决步骤 #

1. 检查镜像在Swarm节点的可用性 #

Docker Swarm部署服务时，所有Worker节点必须能获取到对应镜像。如果自定义镜像仅在Manager节点构建，Worker节点本地无镜像且未配置镜像仓库拉取权限，会导致服务启动失败。

• 查看服务任务失败详情：

  docker service ps mydep_frontend
  

  重点关注ERROR列，通常会显示image not found类错误。
• 解决方式：
  • 方式一：在所有Swarm节点上同步构建镜像（确保每个节点的Dockerfile和构建上下文完全一致）
  • 方式二：搭建私有镜像仓库（如Docker Registry），将自定义镜像推送到仓库后，修改docker-compose.yml中的镜像地址为私有仓库地址，示例：

    image: registry.yourdomain.com/hotel_app_frontend_single_node_memdb:latest
    

    所有节点配置信任该私有仓库后，Swarm会自动拉取镜像。

2. 移除container_name配置 #

Docker Swarm模式不支持手动指定container_name——Swarm会自动分配容器名称，手动指定会引发部署冲突，这是服务无法启动的常见原因。
修改docker-compose.yml，删除所有服务的container_name字段，示例修改后的frontend服务：

services:
  frontend:
    build: .
    image: hotel_app_frontend_single_node_memdb
    entrypoint: frontend
    ports:
      - "8080:8080"
    restart: always

3. 验证自定义镜像的可运行性 #

排除镜像本身的问题，先在单节点测试镜像能否正常启动：

docker run --rm hotel_app_frontend_single_node_memdb:latest frontend

如果启动失败，检查：

• entrypoint指定的命令在容器内是否存在且可执行
• 镜像构建是否完整，是否缺少依赖文件

4. 查看Swarm服务的精准日志 #

使用Swarm专属日志命令查看服务启动错误，比journalctl更针对性：

# 实时查看服务日志
docker service logs -f mydep_frontend

# 查看具体任务的详细日志
docker service ps mydep_frontend --no-trunc
docker logs <任务ID>

5. 检查节点资源状态 #

确认Worker节点有足够的CPU、内存资源启动容器：

# 查看节点状态
docker node ls

# 查看节点资源详情
docker node inspect <节点ID> --format '{{.Status}}'

重新部署流程 #

1. 完成上述配置修正（移除container_name、确保镜像全节点可用）
2. 清理旧部署：

   docker stack rm mydep
   

3. 重新部署：

   docker stack deploy --compose-file docker-compose.yml mydep
   

内容的提问来源于stack exchange，提问作者Βασίλης Χατζηπαντελή