一句话部署 OceanBase:AI Skill 快速上手

想体验 OceanBase,但还不熟悉部署步骤和 OBD 命令?可以先给你的 AI 编程助手安装 oceanbase-deploy Skill,再用自然语言告诉它要做什么。

这个开源 Skill 将 OceanBase 的部署和运维流程交给 Agent 按步骤执行:检查环境、制定方案、调用 OBD,以及验证结果。不用换一个指定的 AI 工具,也不需要一开始就手写部署配置。

开始前,准备这三样

  • 一个已经能正常使用模型、支持 Skill 和终端/SSH 操作的 AI 编程助手。
  • 在运行助手的环境中安装 Node.js(建议当前 LTS 版本,包含 npm/npx)和 Git,并能访问 npm 源和 GitHub。
  • 一台可以通过 SSH 登录的专用 Linux 测试服务器。Agent 可以留在你的电脑上,不需要每台数据库服务器都安装一个。

Skill 本身不提供模型账号、订阅或 API 额度。首次体验建议使用专用测试机;如果是共享服务器,请提前告诉 Agent 可使用的 CPU、内存和磁盘上限。

第一步:一条命令安装 Skill

在你使用 AI 助手的项目目录中打开终端,执行:

npx skills add oceanbase/oceanbase-skills --skill oceanbase-deploy -y

这是推荐的 skills.sh 安装方式-y 用于跳过 Skill 安装器的交互确认;安装完成后,在同一项目中开启新的 Agent 会话,确认它能识别 oceanbase-deploy

习惯使用 ClawHub 的用户,也可以从 OceanBase Deploy 页面按说明安装。两种方式选择一种即可,并保留完整的 Skill 目录。

第二步:把部署需求告诉 AI

将下面的占位符替换成自己的信息,粘贴到 Agent 对话框,不是终端:

使用 oceanbase-deploy Skill,帮我部署一个 OceanBase 社区版测试集群,名称为 ob-lab。

服务器:<服务器 IP>
SSH 用户:<登录用户名>
使用我已有的 SSH 登录方式。这是一台专用测试服务器。

先检查环境,给出部署方案,保留已有数据,等我确认后再执行。

Agent 会检查服务器环境和已有部署情况,并给出版本、资源配置及所需准备工作的建议。检查通过、方案确认后,再回复:

按刚才确认的方案部署 ob-lab,并验证集群健康状态和带认证的 SQL 连接。
不要自动创建业务租户。

完成后,查看 Agent 汇总的实际部署版本、集群状态和 SQL 验证结果。如果某一步失败,让它说明原因和下一步,不要直接跳过检查。

想部署三节点?将第一段需求改成“新建三节点集群 ob-lab-3z”,列出三台服务器的 IP、SSH 用户和资源限制即可,仍然先检查、再确认。

第三步:继续用自然语言管理

部署只是开始。你还可以在同一会话里继续提问:

想做什么 可以这样说
查看集群状态 检查 ob-lab 的运行状态,解释发现的问题,不要修改配置。
启停集群 先给出停止 ob-lab 的影响和操作计划,保留数据,等我确认后再执行。
准备业务租户 为 ob-lab 规划一个 MySQL 模式业务租户,明确资源限制、非空密码和客户端访问范围,先不要创建,也不要让我在聊天中发送密码。
规划升级 检查 ob-lab 的当前版本,评估升级到 <目标版本> 的条件和风险,先不要执行。

Skill 还覆盖配置管理、监控、诊断、租户备份恢复和性能测试等流程。具体可用功能取决于数据库版本、版本类型和已安装工具,Agent 会先检查支持情况。 当前这个 Skill 主要面向部署和运维,不要把它当成专门的 SQL 编写或索引设计 Skill。

两个小提醒

  • 控制资源和操作范围。 默认部署可能使用较多资源;共享机器务必明确资源上限。删除、重建、故障切换等高影响操作,要先确认具体对象和影响。
  • 不要在聊天或帖子中发送密钥。 SSH 私钥、API Token、数据库密码请通过工具支持的安全方式配置。

安装时如果出现 spawn git ENOENT,先运行 git --version,检查 Git 是否安装并加入 PATH;如果是仓库连接超时,再检查 GitHub 网络。

项目源码和详细说明:oceanbase/oceanbase-skills

欢迎先用测试环境体验!遇到问题,可以在评论中附上操作系统、Agent/OBD 版本、使用的提示词和脱敏后的报错,帮助我们持续完善。