test-version

test-version

测试 AppMarket Draft 版本，创建测试实例并验证部署功能。

命令说明：/test-version 是 Claude Code 斜杠命令的简写，底层调用的是：

python3 scripts/appmarket-cli.py test-version --app-id <appID> --version <version> [options]

两种方式等价，本文档中的 /test-version 示例均可替换为上述 CLI 命令。

---

用法

/test-version <appID> <version> [options]

参数

参数	必需	说明	示例
appID	是	应用 ID	app-xxxxxxxxxxxx
version	是	版本号（必须是 Draft 状态）	1.0.0, 1.0.0-draft
--region	否	部署区域	ap-northeast-1（默认）
--inputs	否	输入参数 JSON 文件路径	test-inputs.json
--wait	否	等待实例部署完成	默认启用
--cleanup	否	测试完成后自动删除实例	默认禁用

---

快速开始

1. 基本测试

使用默认参数测试 Draft 版本：

/test-version app-xxxxxxxxxxxx 1.0.0

命令会自动：

1. 检查版本是否为 Draft 状态
2. 使用 InputSchema 中的默认值创建测试实例
3. 监控部署进度，输出实例状态和 outputs
4. 部署完成（或失败）后打印摘要；实例不会自动删除，需手动调用 delete-instance 清理，或在测试时加 --cleanup

2. 自定义参数测试

使用自定义输入参数：

# 创建输入参数文件
cat > test-inputs.json <<EOF
{
  "instance_name": "test-mysql",
  "instance_type": "ecs.c1.c2m4",
  "system_disk_size": 50,
  "mysql_username": "admin",
  "mysql_password": "<YourPassword>",
  "mysql_db_name": "testdb"
}
EOF

# 执行测试
/test-version app-xxxxxxxxxxxx 1.0.0 --inputs test-inputs.json

3. 自动清理模式

测试完成后自动删除实例：

/test-version app-xxxxxxxxxxxx 1.0.0 --cleanup

注意：--cleanup 仅在部署成功后自动删除实例。部署失败时始终保留实例，供 SSH 进去查看 cloud-init 日志排查问题；排查完毕后用 delete-instance 手动清理：

python3 scripts/appmarket-cli.py delete-instance \
  --instance-id appi-xxxxxxxxxxxx --region ap-northeast-1

---

错误处理

版本不是 Draft 状态

✗ 错误: 版本 1.0.0 状态为 Published，只能测试 Draft 版本

建议:
  1. 创建新的 Draft 版本进行测试
  2. 或使用现有的 Draft 版本

必需参数缺失

✗ 错误: InputSchema 中有必需参数但未提供默认值

缺失参数:
  - mysql_password (type: string, required: true)

解决方法:
  1. 在 InputSchema 中为必需参数添加默认值
  2. 或使用 --inputs 参数提供输入文件

区域不可用

✗ 错误: 指定的区域 'cn-west-1' 不可用

可用区域:
  - ap-northeast-1 (亚太东北)
  - ap-southeast-1 (亚太东南 1)
  - ap-southeast-2 (亚太东南 2)
  - cn-changshan-1 (常山)
  - cn-hongkong-1 (香港)
  - cn-shaoxing-1 (绍兴)