升级指南

本文档用于说明微信机器人从旧版本升级到新版本时的通用步骤与检查项。

升级前准备

• 先阅读 更新日志，确认目标版本是否包含破坏性更新，可能docker-compose.yml会新增服务，或者某个服务新增了一些必需的环境变量

• docker compose命令报错就使用docker-compose，哪个能用就用哪个

升级流程

温馨提示

如果你是严格按照快速开始来的，docker-compose.yml没有任何改动，可以不用管上面的升级前准备

1. 在docker-compose.yml同级目录(也就是项目下的.deploy/local目录)执行git pull --rebase拉取最新代码

2. 执行docker compose pull 拉取最新镜像

3. docker compose up -d 启动容器

4. 进入机器人详情界面，右上角点击更新镜像，这里更新的是机器人客户端和机器人服务端镜像

5. 更新镜像旁边有个向下的箭头，鼠标悬浮，依次操作删除客户端容器 -> 删除服务端容器 -> 创建服务端容器 -> 创建客户端容器，其中删除服务端容器需要的时间比较久，请耐心等待

6. 如果有多个机器人，重复执行步骤 5

温馨提示

如果你自定义了docker-compose.yml配置，请查看更新日志，看是否有破坏性更新，同步修改你自己的docker-compose.yml,然后执行上面的 2 3 4 5 6步骤，拉取最新代码不是必需的

FAQ

Q: 我升级失败了，我可以删除所有容器，重新创建一遍吗？

A: 可以的，最好把.deploy/local目录下由 Docker 创建的挂载目录也一并删除。这样会丢失历史数据，新创建的机器人也是登录新设备，多次登录新设备有风控风险。

Q: 为什么我都执行步骤 2，拉取最新镜像了，还要执行步骤 4 更新镜像呢？

A: 因为机器人客户端容器和机器人服务端容器，是由机器人管理后台动态创建的，不受 docker compose 管理。