yuki-aigc/pomeloclaw/aliyun-resource-ops

Aliyun Resource Ops - 云资源运维管理

多产品云资源的运维管理工具，提供资源的生命周期管理能力。

核心特性

1. 基础运维操作

• ECS 云服务器：创建、删除、启动、停止、重启、批量操作
• RDS 数据库：启动、停止、重启、释放

2. optimizer 联动执行

• 从 optimizer 导入优化建议到 Action Store
• 查询待执行的优化动作
• 执行优化动作（释放/降配）
• 跳过不需要的优化建议

何时使用此 Skill

当用户表达以下意图时，应该调用此 skill：

基础运维场景

• 查询资源："查看 ECS 实例"、"列出 RDS"、"有哪些服务器"
• 启动资源："启动实例"、"开机"、"启动服务器"
• 停止资源："停止实例"、"关机"、"停止服务器"
• 重启资源："重启实例"、"重启服务器"、"reboot"
• 创建资源："创建 ECS"、"新建实例"、"开一台服务器"
• 删除/释放资源："释放实例"、"删除 ECS"、"销毁服务器"

成本优化联动场景

• 导入优化建议："把 optimizer 的分析建议保存到 Action Store"
• 查询待执行动作："有哪些待执行的优化动作"、"列出可以优化的资源"
• 执行优化动作："执行这个优化建议"、"释放这台闲置机器"
• 跳过优化建议："跳过这条建议"、"这个资源需要保留"

注意：标签相关操作（打标签、查标签）请使用 aliyun-tag-foundation / aliyun-tag-automation skill。

功能列表

ECS 实例

RDS 实例

optimizer 联动

支持的资源类型

• ecs:instance - ECS 云服务器
• rds:instance - RDS 数据库
• optimizer:action-store - 优化动作存储（联动用）

使用前提

1. 已通过 copaw ops credential add 配置 AKSK 凭证
2. 在 config.json 中启用 ops.enabled = true
3. 凭证具有相应的 RAM 权限

区域参数

所有工具都支持 region_id 参数，默认为 cn-hangzhou。

常用区域 ID：

• cn-hangzhou - 华东 1（杭州）
• cn-shanghai - 华东 2（上海）
• cn-beijing - 华北 2（北京）
• cn-shenzhen - 华南 1（深圳）
• cn-hongkong - 香港

安全说明

• 所有操作都会被审计记录
• 高风险操作（如释放实例）需要审批
• 敏感信息（如 AccessKey）会被自动脱敏

典型使用场景

基础运维场景

场景 1：用户要求"查看 ECS 实例"

ops_ecs_list_instances(region_id="cn-hangzhou")

场景 2：用户要求"重启实例 i-xxx"

ops_ecs_restart_instance(instance_id="i-xxx", region_id="cn-hangzhou")

场景 3：用户要求"创建一台测试服务器"

ops_ecs_create_instance(
    region_id="cn-hangzhou",
    instance_name="test-server",
    instance_type="ecs.t5-lc1m2.small"
)

optimizer 联动场景

重要执行流程：当用户要求"执行优化动作"、"执行优化建议"、"释放/降配上面分析出的资源"时，必须按以下流程执行：

1. 先调用 `ops_list_pending_actions` 从 Action Store 查询待执行动作

2. 向用户展示待执行动作列表（包含 action_id、resource_id、策略、预计节省等）

3. 用户确认后，使用查询到的 action_id 调用 ops_execute_action 执行

禁止：直接从上下文或历史报告中提取资源 ID 执行操作，必须从 JSON 文件查询。

场景 4：从 optimizer 导入优化建议

# 假设 optimizer_results 是 optimizer 分析返回的 JSON 字符串
ops_import_optimizer_actions(
    optimizer_results_json=optimizer_results,
    region_id="cn-hangzhou",
    analysis_id="report_20260321",
    supported_products=["ECS", "RDS"],
    replace_pending=False  # 不替换现有的 pending 动作
)

场景 5：查询待执行的优化动作

# 列出所有待执行动作
ops_list_pending_actions(limit=50)
# 过滤 ECS 的释放动作
ops_list_pending_actions(product="ECS", strategy="Release", min_saving=100)

场景 6：执行优化动作

# 干运行模式（只验证不执行）
ops_execute_action(action_id="act_xxx", confirm=True, dry_run=True)
# 实际执行（需要审批）
ops_execute_action(action_id="act_xxx", confirm=True, dry_run=False)

场景 7：跳过优化建议

# 标记为已跳过
ops_skip_action(action_id="act_xxx", reason="业务高峰期需要保留")

Action Store 数据流转

optimizer 分析 → 提取可执行动作 → Action Store → resource-ops 执行
     ↓                                    ↑
  生成报告                          查询/执行/跳过

Action Store 存储路径: ~/.copaw/data/optimization_actions.json

动作有效期: 默认 7 天（过期后自动标记为 expired）