Dawarich项目从0.25.3升级到0.27.3的技术指南

Dawarich作为一个开源项目，在版本迭代过程中进行了多项重要架构调整。本文将详细介绍从0.25.3版本升级到0.27.3版本的关键技术要点和操作步骤。

主要变更内容

1. 数据库升级要求：从0.26.0版本开始，项目需要PostgreSQL 17配合PostGIS 3.5运行，这对数据库容器配置提出了新的要求。

2. 架构简化：0.27.0版本移除了对Sidekiq和Redis的依赖，显著简化了系统架构。这意味着原先需要维护的额外服务容器现在可以安全移除。

3. 新增配置项：最新版本引入了三个新的必需环境变量以及一个新的数据卷挂载点，这些都需要在升级过程中进行相应配置。

升级步骤详解

数据库容器调整

需要将原有的PostgreSQL 14镜像替换为PostgreSQL 17镜像，并确保PostGIS版本为3.5。在Docker Compose配置中，应将数据库服务定义更新为：

dawarich_db:
  image: postgis/postgis:17-3.5-alpine

服务容器精简

可以完全移除Redis和Sidekiq相关服务定义，因为新版本已不再需要这些组件。这包括：

• 删除redis服务定义
• 删除sidekiq服务定义
• 从主应用服务的depends_on中移除对这些服务的依赖

应用容器更新

将主应用服务指向0.27.3版本镜像：

dawarich_app:
  image: freikin/dawarich:0.27.3

新增配置项

根据0.27.0版本要求，需要：

1. 在环境变量配置文件中添加三个新的必需变量
2. 为主应用服务添加新的数据卷挂载点

升级注意事项

1. 数据备份：在进行任何升级操作前，务必对现有数据库和重要文件进行完整备份。

2. 分步验证：建议按照版本顺序逐步升级(0.25.3→0.26.0→0.27.0→0.27.3)，并在每个阶段验证系统功能。

3. 配置检查：特别注意新版本引入的配置要求，确保所有必需参数都已正确设置。

通过遵循上述步骤，用户可以顺利完成Dawarich项目从0.25.3到0.27.3版本的升级过程，享受新版本带来的性能改进和架构简化优势。