Bookwyrm由0.7.5升级至Production(e217a17)完整过程及疑难解答
💡
原文中文,约9900字,阅读约需24分钟。
📝
内容提要
本教程指导Bookwyrm用户将其部署从v0.7.5升级到最新的production分支(e217a17版本)。升级过程中需备份数据,调整docker-compose.yml和nginx配置,以解决外部数据库、Cloudflare Zero Trust和nginx端口冲突等问题。完成后,Bookwyrm实例应能正常运行。
🎯
关键要点
- 本教程指导Bookwyrm用户将其部署从v0.7.5升级到最新的production分支(e217a17版本)。
- 升级过程中需备份数据,包括数据库和docker-compose.yml文件。
- 在Docker Compose配置中,db服务被注释掉,web和celery服务设置为network_mode: 'host'。
- 使用Cloudflare Zero Trust处理HTTPS加密,nginx需监听未被占用的端口(如8001)。
- 在docker-compose.yml中,nginx、web、celery等服务需设置network_mode: 'host',并调整volumes配置。
- 执行数据库迁移和创建超级用户,确保服务正常运行。
- Cloudflare Zero Trust需配置为将HTTP请求转发到服务器的8001端口。
❓
延伸问答
如何备份Bookwyrm的数据库和配置文件?
可以使用docker exec命令备份数据库,并复制docker-compose.yml和自定义配置文件以确保数据安全。
在升级Bookwyrm时需要注意哪些配置?
需要调整docker-compose.yml和nginx配置,确保服务使用network_mode: 'host',并解决端口冲突问题。
如何处理nginx端口冲突问题?
需要检查宿主机上是否有其他服务占用nginx计划监听的端口,并调整nginx配置为监听未被占用的端口,如8001。
Cloudflare Zero Trust在Bookwyrm升级中有什么作用?
Cloudflare Zero Trust用于处理HTTPS加密,将HTTP请求转发到服务器的8001端口,简化了SSL/TLS的管理。
如何确认Bookwyrm服务正常运行?
可以通过检查docker compose logs命令查看nginx、Web和Celery服务的日志,确保没有错误并正常监听。
升级Bookwyrm后需要执行哪些命令?
需要执行数据库迁移、创建超级用户和收集静态文件等命令,以确保服务正常运行。
🏷️
标签
➡️