想体验 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 版本、使用的提示词和脱敏后的报错,帮助我们持续完善。