山月
·
Bookwyrm由0.7.5升级至Production（e217a17）完整过程及疑难解答
内容提要
本教程指导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-compose.yml文件。这一步骤可以防止在升级过程中出现意外情况导致数据丢失，确保可以随时恢复到之前的状态。
网络配置的重要性
在升级过程中，特别是使用host网络模式时，nginx的端口配置至关重要。确保nginx监听的端口未被其他服务占用，以避免启动失败。建议在升级前检查宿主机的端口使用情况，确保顺利运行。
Cloudflare Zero Trust的配置
使用Cloudflare Zero Trust处理HTTPS加密时，需要在其控制台中正确配置应用程序，以确保HTTP请求能够顺利转发到服务器的指定端口。错误的配置可能导致访问问题，因此在设置时需仔细核对。
延伸问答
如何备份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后需要执行哪些命令？
需要执行数据库迁移、创建超级用户和收集静态文件等命令，以确保服务正常运行。
