Dawarich项目从0.20.1升级到0.22.3的常见问题解析

在Raspberry Pi 5设备上部署Dawarich项目的用户，在从0.20.1版本升级到0.22.3版本时可能会遇到容器启动失败的问题。本文将详细分析这一问题的成因及解决方案，帮助用户顺利完成升级。

问题现象

当用户执行标准升级流程（docker-compose kill → docker-compose pull → docker compose up -d）后，dawarich_app容器启动失败，系统报错提示：

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

问题根源

这个问题源于0.22.0版本引入的重大变更。在该版本中，项目对Docker容器的入口点(entrypoint)机制进行了重构，移除了旧的dev-entrypoint.sh脚本，取而代之的是更专业化的web-entrypoint.sh和sidekiq-entrypoint.sh两个专用入口点脚本。

解决方案

要解决这个问题，用户需要修改docker-compose.yml配置文件中的相关部分：

1. 对于dawarich_app服务：

entrypoint: web-entrypoint.sh
command: ['bin/rails', 'server', '-p', '3000', '-b', '::']

2. 对于dawarich_sidekiq服务：

entrypoint: sidekiq-entrypoint.sh
command: ['sidekiq']

升级建议

1. 版本兼容性检查：在升级前，务必查阅项目的变更日志，了解各版本间的重大变更。

2. 配置备份：修改docker-compose.yml前，建议先备份现有配置。

3. 分步验证：

   • 先更新配置文件
   • 执行docker-compose pull获取新镜像
   • 使用docker-compose up -d启动服务
   • 通过docker logs命令检查容器日志

4. 资源监控：Raspberry Pi设备资源有限，建议在docker-compose中合理配置资源限制，如CPU和内存配额。

常见问题排查

如果按照上述修改后仍遇到"Gateway Timeout"错误，建议检查以下方面：

1. 确认所有依赖服务（PostgreSQL和Redis）已正常启动且健康检查通过
2. 检查应用容器的日志，查看Rails服务是否正常启动
3. 验证网络配置是否正确，特别是容器间的通信
4. 确认环境变量配置无误，特别是数据库连接相关参数

通过以上步骤，大多数升级问题都能得到解决。对于更复杂的情况，建议在社区寻求帮助或考虑使用项目提供的托管方案。