用途:管理火山引擎(Volcengine)上的 ESCloud/CloudSearch(Elasticsearch + OpenSearch)集群,分为控制面与数据面两条路径。控制面用于实例的开通、查看、扩缩容、删除,以及查询 VPC、子网、可用区、节点规格、管理 IP 白名单和重置管理员密码;数据面用于创建/删除/列出索引、写入/读取/删除文档、搜索和批量导入。
使用方式:仓库不内置虚拟环境,首次使用需创建并安装依赖:cd {baseDir};python3 -m venv {baseDir}/venv;{baseDir}/venv/bin/pip install -r {baseDir}/requirements.txt。随后统一用 {baseDir}/venv/bin/python 运行脚本:control.py 处理控制面,data.py 处理数据面;若运行时报 Missing Dependency,可执行 {baseDir}/venv/bin/python -m pip install -r {baseDir}/requirements.txt 重装依赖。
常用命令示例:control.py list 列出实例;control.py detail --id <instance-id> 查看实例详情;control.py versions 查看支持的版本;data.py --endpoint https://domain:9200 info 检查连通性。更多命令见 CONTROL_PLANE.md 与 DATA_PLANE.md。
认证与限制:控制面操作需要环境变量 VOLCENGINE_AK 与 VOLCENGINE_SK,VOLCENGINE_REGION 可选(默认 cn-beijing)。删除类操作(删除实例、删除索引、delete-by-query 等)必须获得用户明确确认,命令行也要求加 --confirm;数据面操作前应先验证 endpoint 可达,否则快速失败并检查 IP 白名单、公网端点与凭据;参数缺失时不应静默失败,需拉取可用 VPC、子网、节点规格供用户选择。该技能不适用于火山引擎之外运行的 ES/OpenSearch,不生成向量(向量搜索需自行提供向量),也不涵盖 ILM、快照、安全等高级管理能力。分类上属于部署与运维范畴。