3文档

Core · 部署与运维

发布应用新版本

修改代码后重新构建,按原来的部署方式更新已有应用。

发布应用新版本,就是把修改后的代码重新构建,再部署到原来的应用。沿用已有数据库、运行配置和文件存储,应用地址通常也不需要改变。

使用 Agent

告诉 Agent 原应用部署在哪里、使用哪种部署方式,例如:

请把当前应用的新版本部署到原来的服务器,继续使用 Docker。
部署目录是 /srv/nocobase/tasks。保留已有数据和配置,更新前做好备份,更新后检查应用是否正常。

使用 app-installer 时提供服务器和安装目录;使用 Studio 时提供应用和目标环境。

不使用 Agent

先完成代码修改和测试,再按照原部署方式重新构建、发布。三种方式主要有以下差别:

部署方式 更新时怎么做
Docker 构建新标签的镜像,修改 Compose 中的镜像版本并重新创建容器,保留原配置和存储挂载。
app-installer 构建新的部署包,使用 upgrade 更新原安装目录;从开发机远程发布时继续使用 deploy --ssh。
Studio 在原应用中上传或构建新版本,再部署到原运行环境。

具体命令见各部署指南的“部署新版本”章节。

如果修改涉及数据库结构,将新增迁移随代码一起发布,保留已经执行过的迁移。更新前备份数据库和文件,并留存旧部署包或镜像;切回旧代码不一定能恢复数据库。

更新后检查应用能否访问、已有数据和权限是否保留、新功能是否正常。需要升级框架依赖时,先按升级 NocoBase Core完成升级和验证,再按同样的流程部署。

NocoBase 3 文档 · 草稿 2026-10-24