> For the complete documentation index, see [llms.txt](https://docs.checkcle.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.checkcle.io/checkcle-docs-zh/ru-men/upgrading.md).

# 版本升级

在升级 CheckCle 时，重要的是要注意该过程不仅限于拉取最新的 Docker 镜像。完整的升级还包括更新数据库模式以符合新版本的要求。这可确保所有新功能、错误修复和结构性更改被正确应用，使系统继续平稳运行。

升级过程通常包括：

1. **移除并拉取最新的 Docker 镜像** — 以获取最新的应用代码和改进。

```sh
# 查找并停止现有容器
docker ps -q --filter "name=checkcle" | xargs -r docker stop

# 删除已停止的容器
docker ps -a -q --filter "name=checkcle" | xargs -r docker rm

# 删除现有的 Docker 镜像
docker images -q "operacle/checkcle" | xargs -r docker rmi

# 拉取最新的 CheckCle 镜像
docker pull operacle/checkcle:latest

# 使用最新镜像启动新容器
使用现有的 Compose 文件运行容器，命令为：
docker compose up -d

# 或者，您也可以使用 docker run 命令运行它。
docker run -d \
  --name checkcle \
  --restart unless-stopped \
  -p 8090:8090 \
  -v /opt/pb_data:/mnt/pb_data \ # 确保您填写了正确的现有路径
  --ulimit nofile=4096:8192 \
  operacle/checkcle:latest

# 验证容器正在运行并查看日志
docker ps | grep checkcle
docker logs -f checkcle
```

2. **应用数据库模式迁移** — 更新新版本所需的表、字段或关系。 
   * 前往 ***关于系统*** 仪表盘中的页面。
   * 您会看到一个新的 *<mark style="color:绿色;">**更新模式**</mark>* 按钮 — 只需点击它即可更新，如我与您共享的图片所示。

<figure><img src="/files/aed04833c6766bb4006063a5a36ce275adc9d494" alt=""><figcaption></figcaption></figure>

2. **验证兼容性** — 检查已升级的应用和数据库是否一致，是否不存在缺失字段或结构不匹配的情况。还应检查关于系统页面中的版本号。
3. **升级后的系统测试** — 确认告警、监控和集成仍按预期工作。