Core

Core · 多应用架构 · 多应用

管理应用实例

选择版本与运行节点,创建实例

在系统设置 → 部署管理 → 应用实例选择创建实例,或从某个构建产物版本的更多操作发起创建。

选择应用包、版本和可用运行节点,填写显示名称与唯一实例标识,再配置数据库、实例参数、初始管理员和平台访问。实例标识影响访问路径,不要使用主应用保留的 main。

检查运行要求与必填配置后提交。平台会创建部署记录;要求审批的节点先等待审批,其余按部署阶段执行。只有部署完成并且运行状态正常后,才验证实际访问。

选择版本、运行节点和数据库后,在提交前核对实例访问地址。
选择版本、运行节点和数据库后,在提交前核对实例访问地址。

查看运行状态与进入应用

实例详情显示实际版本、运行节点和访问地址。使用打开应用进入实例;其他维护操作位于更多菜单中。工作台提供普通用户的应用入口。

“运行中”说明进程状态,不证明登录和业务功能正常。首次部署、升级及登录配置变更后都应访问真实页面检查。

实例列表展示运行状态与当前版本。
实例列表展示运行状态与当前版本。

保存初始管理员账号

平台为新实例生成管理员时,会在详情页提示查看并保存。有权限的管理员应将凭据保存到安全位置,再确认已保存;此后平台不再保留密码。项目部署 CLI 不读取该密码。

初始管理员只在初始化时创建。修改初始化配置不会重置已有账号密码。需要维护时使用子应用本地登录及其账号恢复机制。

确认前先安全保存生成的管理员凭据,截图中的密码保持隐藏。
确认前先安全保存生成的管理员凭据,截图中的密码保持隐藏。

修改名称与实例配置

在更多操作中重命名实例,修改的是展示名称,不是实例标识或访问路径。

进入配置查看当前生效值,使用编辑入口修改配置。已安装实例的数据库类型不能修改;平台签发的 SSO 凭据由平台管理,不在普通配置中手动覆盖。需要新插件或数据库驱动时,先发布包含该依赖的新版本。

配置应用前检查变化并完成备份确认。操作可能重启实例,提交后查看部署记录与实际生效配置。

配置页展示运行环境及当前生效的实例设置。
配置页展示运行环境及当前生效的实例设置。

启动、停止与重启

在更多操作中选择相应动作,等待记录完成并刷新状态。停止实例会保留数据和平台入口配置,之后可以再次启动。重启会中断当前连接,应避开业务繁忙时段。

停用平台入口与停止进程不同:前者控制平台访问,后者控制运行状态。

升级版本

先发布新版本,在实例更多操作中选择升级。核对目标版本、配置变化、必需变量和数据库要求,处理冲突并确认备份,再提交。

升级后确认实例显示目标版本,并验证登录、业务数据和关键操作。版本降级不能撤销数据库迁移,不应作为通用恢复手段。

处理部署审批

节点启用审批后,操作保留在等待审批状态。另一位具有审批权限的管理员需要核对实例、版本、配置和影响后批准或拒绝;发起人不能自批。

批准前节点配置或实例状态发生变化时,应按提示重新检查或重新生成请求。等待审批不是成功,也不应通过换节点绕过原本要求的审批。

查看部署记录与运行日志

实例的部署历史按次展示创建、配置、升级及生命周期操作;全局部署记录可以跨实例查看。打开具体记录查看阶段、错误和部署日志。实例的日志用于查看运行输出,两者用途不同。

排查时记录实例标识、操作标识、发生时间与错误代码。日志可能受大小和保留策略限制,没有日志不代表操作没有执行。

部署记录汇总各应用实例的操作结果。
部署记录汇总各应用实例的操作结果。
部署日志展示解包、激活及操作成功等阶段。
部署日志展示解包、激活及操作成功等阶段。
运行日志展示应用自身的输出,供排查运行问题。
运行日志展示应用自身的输出,供排查运行问题。

排查失败与恢复中断操作

先读具体错误及实例日志,确认是节点不可用、构建不兼容、数据库连接、缺少变量还是登录回调策略导致失败。修复原因后,在原操作提供的重试或恢复入口继续。

连接中断、超时或结果未知时,先查询原记录,确认是否已经执行。不要立即删除实例、重新创建同名实例或清理操作文件。恢复操作仍需权限,并受当前状态与审批规则约束。

项目 CLI 的回执与退出码处理见开发与部署子应用。

删除实例与保留数据

删除前核对实例标识并保存必要备份。默认删除保留持久数据;只有明确选择清理数据并完成额外确认才会删除相应实例数据。保留数据不等于自动迁移或一键恢复实例。

平台会先撤销访问,再移除运行资源。操作失败时检查原部署记录,避免留下仍可访问的入口或重复执行删除。外部接入应用仅管理平台接入,其运行和数据由原系统维护。

NocoBase 文档助手

关于 NocoBase,你想了解什么?

每次提问独立回答,不会参考之前的问答。请提供完整背景。