升级

​

升级之前

1. 阅读当前版本到目标版本之间每个版本的发布说明。
2. 备份 PostgreSQL 与对象存储，参见备份与恢复。
3. 记下正在运行的版本。molesignal --version 会输出版本号，GET /api/v1/version 返回版本、commit、构建 id、发布通道与版本类型，该请求需要 Bearer Token。
4. 部署比较关键时，先在数据库的恢复副本上演练一次升级。

​

schema 变更如何生效

• 比数据库更旧的二进制会拒绝启动，并报 migration <version> was previously applied but is missing in the resolved migrations。
• 携带了已应用迁移的修改版本的二进制会拒绝启动，并报 migration <version> was previously applied but has been modified。预发布构建可能修改基线 schema，因此某个构建创建的数据库不保证能被另一个构建打开。

​

升级步骤

docker compose -f deploy/docker/docker-compose.yaml --profile standalone pull
docker compose -f deploy/docker/docker-compose.yaml --profile standalone up -d

sudo systemctl stop molesignal
sudo install -Dm755 bin/molesignal /usr/local/bin/molesignal
sudo install -Dm644 mmdb/dbip-city-lite.mmdb \
  /usr/share/molesignal/mmdb/dbip-city-lite.mmdb
sudo systemctl start molesignal
sudo journalctl -u molesignal -n 50

kubectl apply -f 30-router.yaml -f 40-intake.yaml -f 50-querier.yaml \
              -f 60-compactor.yaml -f 70-alert.yaml
kubectl -n molesignal rollout status statefulset/intake

​

分角色集群

1. 先停止 router 节点，再停止 intake 与 querier 节点，最后停止 compactor 与 alert。
2. 启动一个新版本的节点，等待 GET /api/v1/healthz 返回 200，该节点会应用迁移。
3. 启动其余节点。

​

验证升级

• 日志中没有迁移错误，且 GET /api/v1/healthz 返回 200。
• GET /api/v1/version 返回新版本。
• 对近期数据的查询能返回行，新记录也在持续到达。
• /metrics 中 storage_reconciler_issues_total 没有增长。