CompShare API 技能
任务目标
- 本技能用于：管理优云智算CompShare平台的GPU实例资源
- 能力包含：创建GPU实例、查询实例列表、启动/停止/重启实例、重置密码、删除实例
- 触发条件：用户需要创建或管理CompShare平台的GPU云服务器实例
前置准备
依赖安装
pip install ucloud-sdk-python3 PyYAML paramiko
配置文件
在使用前，需要在Skill目录下创建配置文件 assets/config.yaml：
- 编辑配置文件，填入API凭证：
compshare:
public_key: "your-public-key"
private_key: "your-private-key"
region: "cn-wlcb"
zone: "cn-wlcb-01"
base_url: "https://api.compshare.cn"
-
获取API凭证：
-
配置文件查找优先级：
- 命令行参数
--config 指定的路径
- 默认路径
assets/config.yaml（Skill目录下）
操作步骤
1. 创建GPU实例（默认创建抢占式）
调用 scripts/compshare_client.py 脚本，使用 create 命令：
python scripts/compshare_client.py create \
--gpu-type 4090 \
--gpu-count 1 \
--cpu 16 \
--memory 64 \
--disk-size 200 \
--image-id 500WHhII1fnz \
--name "ComfyUI-4090" \
--charge-type Spot
2. 查询实例列表
调用脚本使用 list 命令：
python scripts/compshare_client.py list
# 或查询特定实例
python scripts/compshare_client.py list --instance-ids "instance-id-1,instance-id-2"
3. 启动实例
正常开机（带GPU）：
python scripts/compshare_client.py start --instance-id <UHostId>
无卡开机（不带GPU，节省费用）：
python scripts/compshare_client.py start --instance-id <UHostId> --without-gpu
4. 停止实例
调用脚本使用 stop 命令：
python scripts/compshare_client.py stop --instance-id <UHostId>
5. 重启实例
调用脚本使用 reboot 命令：
python scripts/compshare_client.py reboot --instance-id <UHostId>
6. 重置实例密码
调用脚本使用 reset-password 命令：
python scripts/compshare_client.py reset-password --instance-id <UHostId> --password <new-password>
7. 删除实例
调用脚本使用 delete 命令：
python scripts/compshare_client.py delete --instance-id <UHostId>
8. SSH连接实例
通过实例的 SshLoginCommand 和 Password 连接实例：
- 先查询实例获取 SSH 登录信息：
python scripts/compshare_client.py list
# 返回结果中包含 SshLoginCommand 和 Password
- 使用 SSH 客户端连接：
python scripts/ssh_client.py connect \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password"
9. SSH远程执行命令
python scripts/ssh_client.py exec \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--cmd "ls -la /home"
10. SSH文件操作
列出目录：
python scripts/ssh_client.py ls \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--path "/home"
上传文件：
python scripts/ssh_client.py upload \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--local ./local_file.txt \
--remote /home/remote_file.txt
下载文件：
python scripts/ssh_client.py download \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--remote /home/remote_file.txt \
--local ./local_file.txt
上传整个目录：
python scripts/ssh_client.py upload-dir \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--local ./my_project \
--remote /home/my_project
下载整个目录：
python scripts/ssh_client.py download-dir \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--remote /home/data \
--local ./data_backup
查看文件内容：
python scripts/ssh_client.py cat \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--path /etc/hosts
创建目录：
python scripts/ssh_client.py mkdir \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--path /home/new_dir
删除文件：
python scripts/ssh_client.py rm \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--path /home/old_file.txt
重命名文件/目录：
python scripts/ssh_client.py rename \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--old /home/old_name \
--new /home/new_name
修改权限：
python scripts/ssh_client.py chmod \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password" \
--path /home/script.sh \
--mode 755
交互式Shell：
python scripts/ssh_client.py shell \
--ssh-command "ssh -p 12345 root@192.168.1.1" \
--password "your-password"
资源索引
注意事项
- 删除实例前必须先停止实例，否则会报错
- 密码需要符合平台规范，并通过 base64 编码传输
- GPU类型支持：4090、3080Ti、3090、A800、A100、H20等
- 地域和可用区固定为 cn-wlcb 和 cn-wlcb-01
- 所有API响应中的 RetCode=0 表示操作成功
- 配置文件包含敏感信息，请勿提交到版本控制系统
- SSH密码可通过查询实例列表获取（Password字段）
- SSH登录命令可通过查询实例列表获取（SshLoginCommand字段）
