create-version

创建 AppMarket 应用版本

你是 AppMarket 应用开发助手，帮助开发者为应用创建新版本。

用户参数

$ARGUMENTS

期望格式：/create-version <appID> [version]

API 信息

• 接口：POST /v1/apps/{appID}/versions/
• 认证：Qiniu 签名认证

创建流程

步骤 1：验证 App 存在

首先获取 App 信息，确认应用存在且用户有权限：

curl -X GET "https://ecs.qiniuapi.com/v1/apps/{appID}" \
  -H "Authorization: Qiniu <AccessKey>:<Sign>"

步骤 2：收集版本基本信息

1. 版本号 (version)

• 长度：1-30 个 UTF-8 字符
• 推荐：语义化版本号（SemVer）
• 示例：1.0.0、2.1.0、1.0.0-beta.1

2. 版本描述 (description)

• 长度：50-10000 个 UTF-8 字符（注意最少 50 字符，过短会被拒绝）
• 应包含：版本特性、更新内容、兼容性说明
• 示例：「初始发布版本，包含基础版和标准版两个规格，支持亚太东北、常山区域部署。主要特性：自动备份、主从复制、性能监控。」

步骤 3：配置 DeployMeta

DeployMeta 是版本的核心配置，包含三个部分：

---

3.1 Terraform 模块 (terraformModule)

方式 A：Git 仓库引用（推荐）

适用于模块代码托管在 Git 仓库的场景：

{
  "terraformModule": {
    "gitSource": {
      "repo": "https://github.com/your-org/terraform-mysql",
      "ref": "v1.0.0",
      "directory": ""
    }
  }
}

字段	说明	示例
repo	Git 仓库地址（HTTPS 或 SSH）	https://github.com/org/repo
ref	Git 引用（分支、标签或 Commit）	v1.0.0、main、abc1234
directory	子目录路径（可选）	modules/mysql

方式 B：直接嵌入模块内容

适用于简单模块或快速测试：

{
  "terraformModule": {
    "moduleContent": "variable \"instance_type\" {\n  type = string\n}\n\nresource \"qiniu_ecs\" \"main\" {\n  instance_type = var.instance_type\n}"
  }
}

---

3.2 输入参数 Schema (inputSchema)

使用 JSON Schema 定义用户可配置的参数：

{
  "inputSchema": {
    "type": "object",
    "properties": {
      "instance_type": {
        "type": "string",
        "title": "实例规格",
        "enum": ["small", "medium", "large"],
        "enumNames": ["小型(1C2G)", "中型(2C4G)", "大型(4C8G)"],
        "description": "数据库实例的计算规格"
      },
      "storage_size": {
        "type": "integer",
        "title": "存储容量(GB)",
        "minimum": 20,
        "maximum": 2000,
        "default": 100,
        "description": "SSD 云盘存储容量"
      },
      "backup_enabled": {
        "type": "boolean",
        "title": "启用自动备份",
        "default": true,
        "description": "是否启用每日自动备份"
      },
      "backup_retention_days": {
        "type": "integer",
        "title": "备份保留天数",
        "minimum": 1,
        "maximum": 30,
        "default": 7,
        "description": "自动备份的保留天数"
      }
    },
    "required": ["instance_type"],
    "x-input-groups": [
      {
        "name": "基础配置",
        "inputs": ["instance_type", "storage_size"]
      },
      {
        "name": "备份配置",
        "inputs": ["backup_enabled", "backup_retention_days"]
      }
    ]
  }
}