Dawarich项目Docker Compose部署问题分析与解决方案

问题背景

在使用Dawarich项目进行Docker Compose部署时，用户遇到了容器启动失败的问题。错误信息显示系统无法找到"web-entrypoint.sh"可执行文件，导致容器初始化失败。这个问题主要出现在使用最新版本镜像时，涉及Docker Compose配置与镜像版本不匹配的情况。

错误分析

典型的错误表现为：

Error response from daemon: failed to create task for container: failed to create shim task: OCI runtime create failed: runc create failed: unable to start container process: error during container init: exec: "web-entrypoint.sh": executable file not found in $PATH: unknown

这个错误表明Docker容器在启动时无法找到指定的入口点脚本。根本原因是Docker镜像版本更新后，入口点脚本的名称和位置发生了变化，而旧版的Docker Compose配置没有相应更新。

解决方案

1. 明确使用正确的镜像版本

确保在docker-compose.yml文件中指定正确的镜像版本。例如：

image: freikin/dawarich:0.22.0

而不是使用可能不稳定的latest标签：

image: freikin/dawarich:latest

2. 更新入口点配置

新版Dawarich镜像对入口点脚本做了以下变更：

• 将dev-entrypoint.sh改为web-entrypoint.sh
• 将bin/dev命令改为['bin/rails', 'server', '-p', '3000', '-b', '::']
• Sidekiq服务的入口点从dev-entrypoint.sh改为sidekiq-entrypoint.sh
• Sidekiq命令从['bin/dev']改为['bundle', 'exec', 'sidekiq']

3. 完整的配置示例

以下是修正后的关键配置部分：

dawarich_app:
  image: freikin/dawarich:0.22.1
  entrypoint: web-entrypoint.sh
  command: ['bin/rails', 'server', '-p', '3000', '-b', '::']

dawarich_sidekiq:
  image: freikin/dawarich:0.22.1
  entrypoint: sidekiq-entrypoint.sh
  command: ['bundle', 'exec', 'sidekiq']

最佳实践建议

1. 版本固定：在生产环境中，始终使用具体的镜像版本号而非latest标签，以避免因镜像更新导致的意外问题。

2. 配置检查：在升级项目版本时，仔细检查变更日志，特别是关于Docker配置的变更说明。

3. 缓存问题：如果遇到镜像版本不符预期的情况，可以尝试清除Docker缓存后重新拉取镜像：

   docker system prune -a
   

4. 健康检查：确保所有依赖服务(如PostgreSQL和Redis)的健康检查配置正确，避免因依赖服务未就绪导致的应用启动失败。

总结

Dawarich项目在版本更新过程中对Docker镜像的入口点配置进行了调整，导致旧版docker-compose.yml文件无法正常工作。通过明确指定镜像版本并更新入口点配置，可以解决容器启动失败的问题。这一案例也提醒我们在使用Docker部署应用时，需要注意版本管理和配置同步的重要性。