Campus-i茅台项目版本升级指南

项目背景

Campus-i茅台是一个基于Docker容器化部署的开源项目，主要用于校园场景下的茅台酒预约系统。该项目采用微服务架构，通过Docker Compose进行服务编排，使得部署和维护变得更加便捷。

版本升级流程

准备工作

在进行版本升级前，建议先做好以下准备工作：

1. 备份当前运行环境中的重要数据
2. 查看当前运行的版本号
3. 阅读新版本的更新日志，了解变更内容

升级步骤

1. 停止当前运行的服务

   在项目根目录下执行：

   docker-compose down
   

2. 替换项目文件

   将新版本的文件解压后覆盖到原有目录中。注意保留原有的配置文件（如.env等），避免覆盖个性化设置。

3. 检查Docker Compose配置

   虽然大多数情况下docker-compose.yml文件不需要修改，但建议对比新旧版本的差异，特别是：

   • 服务定义是否有变化
   • 环境变量是否有新增或修改
   • 端口映射是否有调整

4. 重建并启动服务

   执行以下命令：

   docker-compose up -d --build
   

5. 验证升级结果

   检查服务是否正常启动，并通过接口或界面验证功能是否正常。

升级注意事项

1. 数据持久化：确保数据库等需要持久化的数据卷配置正确，避免升级过程中数据丢失。

2. 依赖更新：新版本可能会引入新的依赖项，建议在升级后执行：

   docker-compose build --no-cache
   

   以确保所有依赖都是最新的。

3. 版本兼容性：直接从1.0.12升级到1.0.13通常是安全的，但如果跨多个主版本升级，建议查阅版本间的迁移指南。

4. 回滚方案：升级前应准备好回滚方案，如备份旧版本的docker-compose.yml和镜像，以便在升级失败时快速回退。

常见问题解决

1. 端口冲突：如果升级后服务无法启动，检查是否有端口冲突问题。

2. 环境变量缺失：新版本可能需要新的环境变量配置，请确保.env文件包含所有必需的配置项。

3. 镜像构建失败：如果遇到构建失败，可以尝试清理旧的Docker镜像和缓存后重新构建。

通过遵循上述步骤和注意事项，可以确保Campus-i茅台项目的版本升级过程顺利完成，同时最大限度地减少服务中断时间和数据丢失风险。