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后需要执行哪些命令?

需要执行数据库迁移、创建超级用户和收集静态文件等命令,以确保服务正常运行。

➡️

继续阅读