数据库、部署与排错
选择数据库并初始化
| 用途 | 路径 |
|---|---|
| 本机首次体验 | KAIWU_DB_TYPE=mysql ./kaiwu up 创建 MySQL,平台启动时执行迁移。 |
| 已有 MySQL | 为平台准备独立空库,在受保护的运行配置中提供 KAIWU_DB_HOST、端口、库名、用户和密码,再初始化。 |
| 达梦 DM8 | 准备独立空 Schema,核对 UTF-8、页大小、大小写和兼容模式,按数据库手册完成迁移前检查。 |
| DBA 审阅初始化数据 | 在独立空库中先执行对应方言的 mysql-01-ddl.sql 或 dm8-01-ddl.sql,再执行同前缀的 02-dml.sql 文件查看种子数据。应用安装需要 Flyway 迁移历史,请另备空库交给 Compose 或 Helm 的迁移任务初始化。 |
v0.3.0 安装执行 V127 基线和 V128 增量,现有 v0.2.0 按原迁移流程应用 V128。旧 v0.1.0(V44)需要另建数据库;中间版本根据现有 Flyway 成功记录走对应升级路径。在已有数据的库里执行初始化脚本可能破坏数据,升级前保留可恢复的备份。数据库配置 · 初始化 SQL 下载与说明 · 按迁移版本升级
部署到服务器或 Kubernetes
- 单机 Compose。在服务器备齐同版本产品仓,到 System 目录用
./scripts/kaiwu-server-env.sh ../.kaiwu-server/runtime.env准备运行配置,再按手册组合基础与服务器 Compose 文件。配置反向代理和同源入口,分别部署业务后端和前端。最后从工作台登录并完成一次业务读取。单机部署与外部 MySQL / Redis - Kubernetes。在入口运行
./kaiwu deploy-init获取 GitOps 仓;Chart 位于 System 的deploy/helm/kaiwu。固定镜像版本、准备命名空间和运行凭据,先用helm lint、helm template验证目标 values。安装后依次看迁移 Job、Pod 就绪、Gateway 路由和业务前端同源访问。安装、升级与回滚 - Nacos 开发环境。System 与 Gateway 用各自的 Data ID,显式配置路由及 audience。对象存储与模型服务按实际域名配置出站策略。用 System 脚本的
local-up对接该环境,用local-status和local-logs检查原生进程。配置模板与启动参数
常见问题
| 现象 | 从哪里查 |
|---|---|
| 第二套平台启动时端口冲突或连到旧库 | 用新的检出目录、项目名、对外端口及平台网络,保持该实例各次启动的配置一致。查看 ./kaiwu status。 |
| 镜像拉取失败 | 看日志区分下载失败和源码构建失败;要主动走源码路径可执行 ./kaiwu up --build。 |
| 无法登录或 CLI 指向别的平台 | 核对浏览器地址、CLI 的 KAIWU_URL 与 ./kaiwu whoami。初次登录密码在本机查看。 |
| 工作台可用,业务页打不开 | 分别核对成员角色、项目入口、前端挂载位置和网关显式路由。查看 ./kaiwu logs --tail 100。请求路径 |
| 更新配置后行为未变 | 核对项目编码、同步预览、实际目标环境和当前账号;需要重新登录时建立新会话。配置移交 |
暂停本机平台用 ./kaiwu down,数据保留。./kaiwu reset 会删除本机平台数据,只在确实要清空时执行。