SuperAPI AI 工具集

aiven-setup

部署与运维

查看项目

更新于 10-16 03:11

技能介绍

用途:这是一个面向 Aiven for OpenSearch 的部署技能,帮助用户先开通 Aiven 托管 OpenSearch 服务,再把搜索配置部署上去。流程与 AWS 版本类似,但目标是 Aiven 而非 Amazon OpenSearch Service。

前置条件:Aiven 账号、项目与 API Token;已连接 Aiven MCP 服务器;已安装 uv(用于运行 opensearch_ops.py 脚本与 Search UI);以及一份搜索配置(通常由 opensearch-launchpad 技能生成)。

主要能力与工作流:

  1. 开通服务:先选择项目,调用 aiven_service_type_plans(service_type="opensearch")列出套餐、用 aiven_list_project_clouds 列出可用云区域,由用户确认后调用 aiven_service_create,等待状态变为 RUNNING,再读取连接信息。
  2. 部署搜索配置:把 opensearch-mcp-server 指向 Aiven 端点,再将索引、字段映射、模型、管线与示例文档的构建交给 opensearch-launchpad 技能完成。
  3. 启动 Search UI:使用 uv run python scripts/opensearch_ops.py launch-ui,并传入 --index、--endpoint、--username、--password。注意 launch-ui 默认假设 443 端口,而 Aiven 使用非标准端口,需修正端口后启动。
  4. 健康检查(可选):通过 Aiven 控制面批量执行 aiven_service_metrics_fetch(CPU、内存、磁盘、JVM 压力)、aiven_project_get_service_logs(集群日志)与 aiven_service_get(确认 RUNNING 与节点健康)。
  5. 提供访问信息:OpenSearch 端点 URL、OpenSearch Dashboards URL、凭据(安全方式)、示例查询及 Search Builder UI URL。

关键规则:不得猜测套餐或云区域,必须列出并由用户选择;密码由 Aiven 生成,需通过 aiven_service_connection_info 读回,不能编造;创建后不要循环轮询,提示用户数分钟后再检查;凭据视为敏感信息;Aiven 使用自签项目 CA,需 TLS 校验处理;部署状态记录在 .opensearch-deploy-state.json。

限制:需要 Aiven 账号、项目、API Token 与相应 MCP 服务器;若 Aiven MCP 以只读/仅开通模式连接,则无法执行监控步骤;未提供具体定价、套餐规格或性能数据。