记录immich从v1.91.0升级到v1.95.0

immich

IMMICH是一款开源的图片/相册管理工具，相比于群晖Photos，其不依赖于某一个NAS品牌，可以自己在Win，Linux等搭建。

前提：我是使用OMV作为NAS系统，通过SMB共享文件。然后PVE单独开一个LXC机器，运行docker搭建immich

之前是年前折腾的，参考的站内的文章，用得也比较顺心，升级到了v1.91.0。年后（2月21日）查看app时，发现更新到了v1.95.0了，这次更新存在一个breaking changes，即PG数据库从v0.1.11升级到了v0.2.0.

详情请阅读官方文档：https://github.com/immich-app/immich/releases/tag/v1.95.0

IMMICH v1.95.0 - breaking changes

既然存在breaking changes，则需要对docker compose进行一定修改，我在过程中遇到一定问题，特此记录下来。

第一次升级

升级前版本是v1.91.0，我是打算直接升级到v1.95.0

我的docker compose中都是指定的release版本, 本来想贴配置的，才发现ZDM上面这个编辑器，不支持markdown的代码格式。我就贴个图吧，这个yaml文件可以在immich的官方github仓库下载（https://github.com/immich-app/immich/releases/download/v1.95.0/docker-compose.yml）到，自己根据需要修改即可

配置文件

于是我将数据库修改为v0.2.0，然后按照官方文档操作

1. 修改docker-compose.yml

2. 备份数据库：docker exec -t immich_postgres pg_dumpall -c -U postgres | gzip > "/path/to/backup/dump.sql.gz"

3. 暂停容器：docker compose down

4. 拉取更新：docker compose pull

5. 启动： docker compose up

然后我发现，有报错（忘记截图），由pg容器报错，提示找不到facial等信息，也提示没有vector用户，版本为0.1.11，而不是0.2.0。 此时能打开网页，但无法打开缩略图，点击Explorer和MAP会直接出现500服务器错误，还好之前有进行备份（备份是个好习惯，我有设置脚本，每周备份）。

事后我大致总结了一下问题所在，这里直接贴出：

① 我的缩略图和人脸识别等信息在过年期间已丢失，但在升级前我没注意，升级后自然会出现无法点开图片的问题。

② 直接从v1.91.0升级到v1.95.0，出现了不兼容问题，猜测中间某个版本的server有修复。但时间有限，我没有一个个仔细去看各个版本的change log，此处仅为猜测。

由此我打算还原备份，进行第二次升级。

第二次升级

参考官方还原数据的文档：https://immich.app/docs/administration/backup-and-restore/

但官方的文档中有个坑，其实在还原前，需要先删除掉原数据库下所有内容。

1. 关闭容器： docker compose down -v

2. 删除原有数据库内容：rm -rf ./pgdata/* (此步骤谨慎，会删除你的数据库，除非你有备份，不要轻易操作此步骤，谨慎点就将原文件夹mv改名，然后新建一个pgdata文件夹)

3. 修改yaml文件，将immich-server，immich-microservices，immich-machine-learning 的版本修改为v1.91.0

4. 然后拉取：docker compose pull

5. 创建容器（是创建，不是启动）：docker compose create

6. 启动数据库容器：docker start immich_postgres

7. 还原数据库：gunzip < "/path/to/backup/dump.sql.gz" | docker exec -i immich_postgres psql -U postgres -d immich

8. 重新启动所有容器：docker compose up -d

此时就回到了v1.91.0版本，数据也是停留在上周的状态。此时我的略缩图等信息，还是没有的。

后续步骤

我先升级到v1.92.0，此时只需要修改yaml文件中immich-server，immich-microservices，immich-machine-learning等容器版本即可，不需要修改数据库版本，然后docker compose down，pull，up。

因为略缩图等信息消失，此时登入网页后台，进入JOBS，启动 GENERATE THUMBNAILS，EXTRACT METADATA，FACIAL RECOGNITION等任务。

等待任务完成后，再将IMMICH升级到v1.94.0，然后再升级到v1.95.0，此时IMMICH运行正常。

最后记得把APP也升级到最新版本：https://github.com/immich-app/immich/releases/download/v1.95.0/app-arm64-v8a-release.apk