Skip to content

数据库、部署与排错 ​

选择数据库并初始化 ​

用途路径
本机首次体验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 会删除本机平台数据,只在确实要清空时执行。

Apache License 2.0