Docker Swarm部署中wsgi容器无法启动的排查求助

1. 验证Docker Compose文件的合法性与配置 #

• 执行docker-compose -f docker-compose.yml config检查语法：输出无报错且能正确解析wsgi服务配置，说明语法没问题；如果报错，根据提示修复缩进、字段拼写（比如image误写、services下wsgi服务块缺失等）
• 核对wsgi服务的核心配置：确认image或build字段有效——用build的话，检查context和dockerfile路径是否正确；用image的话，确认镜像名称/tag无误
• 检查依赖与启动条件：如果wsgi服务配置了depends_on，确认依赖的postgres/redis服务是否满足启动条件（比如配置了healthcheck的话，需确保健康检查通过，否则wsgi服务会被阻塞）

2. 检查Swarm服务的状态与日志 #

• 执行docker service ls：查看是否存在myapp_stack_2_wsgi服务。若不存在，说明Stack部署时未识别到该服务，问题出在compose文件；若存在但副本数为0/1，继续排查
• 查看服务任务日志：执行docker service logs myapp_stack_2_wsgi，即使容器未创建，服务任务可能输出镜像拉取失败、权限不足等关键错误
• 查看服务详细配置：执行docker service inspect --pretty myapp_stack_2_wsgi，检查是否存在节点约束（constraints）、资源限制（resources）导致调度失败；同时核对mounts配置——Swarm中使用bind mount时，需确保目标节点上存在./wsgi/myapp路径（本地路径是相对于调度节点而非部署命令执行节点）

3. 排查Swarm节点的调度问题 #

• 查看服务任务分配：执行docker service ps myapp_stack_2_wsgi，查看是否有调度失败提示（如"No suitable node"），或任务是否被分配到异常节点
• 检查节点资源：确认目标节点的CPU、内存未耗尽，否则Swarm调度器会拒绝创建容器
• 核对节点标签约束：若wsgi服务配置了node.labels约束，需确保存在符合标签的节点，否则无法调度

4. 验证WSGI镜像的可用性 #

• 确认镜像存在：若使用本地构建镜像，需确保所有可能被调度的Swarm节点上都有该镜像；若使用远程镜像，检查是否配置了私有仓库认证，避免拉取失败
• 手动测试镜像：在任意节点执行docker run --rm <wsgi镜像名称>，验证镜像本身是否能正常启动，排查entrypoint/cmd错误、启动命令异常等问题

5. 检查Swarm集群状态 #

• 执行docker node ls确认所有节点处于Ready状态，无宕机或异常节点
• 过滤服务事件：执行docker events --filter 'service=myapp_stack_2_wsgi'，监听该服务的调度、创建事件，获取更精准的故障信息

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