redmine4.1升级4.2

### Redmine 4.1 升级至 4.2 的方法及注意事项

#### 备份现有数据
在执行任何升级操作之前，确保备份现有的数据库和文件系统。这可以防止意外的数据丢失或损坏。

对于使用 SQLite 数据库的情况，在宿主机上定位到存储 SQLite 文件的位置并复制该文件作为备份[^1]。如果采用 MySQL 或 PostgreSQL，则应导出完整的数据库转储文件。

#### 停止当前服务
停止正在运行的 Redmine 容器实例以准备更新过程。可以通过命令 `docker stop <container_name>` 来实现这一点，其中 `<container_name>` 是指代具体容器的名字或者 ID。

docker stop my_redmine_container

#### 获取最新镜像
拉取官方最新的 Redmine Docker 镜像版本，通常会带有标签如 `latest` 或者指定版本号 `4.2.x`：

docker pull redmine:4.2

此步骤确保获得目标版本中的所有修复程序和支持的新特性。

#### 更新配置文件
检查环境变量设置是否需要调整来匹配新版需求；特别是注意那些涉及插件兼容性和安全性的参数。另外也要确认挂载路径正确无误以便于持久化保存重要资料。

#### 运行新版本的服务
启动新的 Redmine 实例时建议先不删除旧版容器而是创建一个新的名称用于测试验证。这样可以在遇到问题时不破坏原有环境快速回滚:

docker run -d \
    --name new-redmine-instance \
    -v /path/to/redmine-data:/usr/src/redmine/files \
    -e REDMINE_DB_MYSQL=mysql-server-name \
    -p 80:3000 \
    redmine:4.2

上述命令假设读者已经有一个名为 `mysql-server-name` 的 MySQL/MariaDB 服务器，并且希望将端口 3000 映射到本地机器上的 HTTP (TCP/80)。

#### 测试与验证
访问 Web 页面登录后仔细审查各项功能是否正常运作，尤其是最近更改过的地方。依据软件测试原则，每当有改动都需要进行全面回归测试以发现潜在缺陷[^3]。

一旦确认一切顺利就可以考虑移除之前的低版本容器并将此次部署设为主用节点。

#### 版本间差异说明
不同次要版本之间可能存在 API 变更或其他内部结构调整，因此强烈推荐查阅官方文档了解详细的迁移指南。