升级你的实例

升级 KolleK 的设计目标就是“无聊”：拉取新版本，重新构建，完成。本页解释这为什么是安全的，以及升级之后你需要知道的一个额外步骤。

为什么升级不会丢失数据

有两个特性保证了升级路径的安全：

• 你的数据存放在具名数据卷中（数据库使用 db-data，文件使用 storage-data），独立于容器和镜像存在。重建容器不会影响它们。
• 迁移只会向前推进。 web 容器在启动时会通过 migrate --force 应用所有待处理的数据库迁移，而 KolleK 从不会发布重置数据或破坏性重写数据的迁移。升级只会为你的数据库结构做增量修改。

升级步骤

git pull

docker compose up -d --build

如果你希望手动掌控迁移过程，可以设置 RUN_MIGRATIONS=false，并在升级流程中自行执行 docker compose exec app php artisan migrate --force，具体做法参见 使用 Docker 安装。

照片搜索索引这一步

有一次升级包含了一项一次性维护任务：早于照片库页面上线的实例，需要为已有照片手动构建一次照片搜索索引，否则这些照片的搜索结果会一直是空的。

docker compose exec app php artisan photos:rebuild-search-index

这个命令是幂等的，在任何实例上运行都是安全的，如果不确定就直接运行它。它还会为那些在记录图片尺寸功能上线之前上传的照片补全尺寸信息。

账户搜索索引这一步

账户范围的搜索读取自己的索引。迁移只创建数据表，填充数据的只有重建命令，因此在已有实例上，搜索在命令运行一次之前什么也找不到：

docker compose exec app php artisan search:rebuild-index

它会遍历每个账户里的每条记录，实例较大时请稍等片刻。之后索引会随着记录变化自行保持更新。参见 搜索整个账户。

接下来去哪里

• 保持 备份 是最新的，让每一次升级都有备份可依。
• 了解 定时维护任务，这些任务会在 scheduler 容器恢复运行后自动继续执行。