qwencloud-deploy

Qwen Cloud Deploy

快速路径

1. 选择任务路径 — 匹配以下 4 种模式之一：全栈部署 · 热更新 · 删除 · HTTPS 设置。
2. 部署（默认） — 严格按顺序执行步骤 1→14，不得跳过或调整顺序；关卡和可跳过步骤见 reference/rules/rule_interaction.md 中的“执行顺序”。
3. 创建任何资源前确认费用 — 显示以 USD 计价的每小时价格，并获得用户确认。
4. 记录状态 — 成功后写入 .qwencloud-deploy。

范围

范围内	范围外
本地项目 / Git → Alibaba Cloud International	中国站点 → 使用 qianwenai-deploy
全栈 ROS、热更新、清理	AWS/GCP/Azure/其他云
ECS + 可选 RDS + OSS + 公网 IP	K8s/Serverless/容器编排
OAuth/AK 认证（不收集凭证）	—
部署用户提供的代码/项目	审查或编辑用户代码逻辑、保证代码正确性

关于用户的代码

此技能用于构建和部署用户提供的代码/项目，不会审查或修改业务逻辑，也不保证代码本身正确。

部署后由代码引发的错误、安全问题及任何后果均由用户自行承担；如果需要修改代码，由用户自行决定并修改。

假设

• 已安装 aliyun CLI 3.x；如果没有有效凭证，请遵循 reference/deploy/01_env_check.md。
• 默认区域为 ap-southeast-1（新加坡）。

---

任务路由

信号	模式
存在 .qwencloud-deploy + 用户说“更新”	热更新
存在 .qwencloud-deploy + 用户说“删除”/“清理”	删除
“绑定域名”/“HTTPS”/“SSL”（已存在部署）	HTTPS 设置
Git URL 或本地项目（不存在现有部署）	全栈部署

触发时，首先显示欢迎消息（见 reference/rules/rule_interaction.md）。

---

全栈部署（步骤 1–14）

阶段 1 · 准备

步骤	操作	参考
1	环境检查	reference/deploy/01_env_check.md
2	Git 克隆（如果是 Git URL）	reference/deploy/02_git_clone.md
3	项目分析	reference/deploy/03_analyze_project.md

阶段 2 · 资源规划

步骤	操作	参考
4	扫描现有部署	reference/deploy/04_check_existing.md
5	数据库识别	reference/deploy/05_database.md
6	选择 ECS 实例类型	reference/deploy/06_instance_type.md
7	生成 ROS 模板	reference/deploy/07_generate_template.md
8	检查库存	reference/deploy/08_check_stock.md
9	验证模板 + 估算费用	reference/deploy/09_estimate_cost.md

阶段 3 · 执行

步骤	操作	参考
10	上传构件 + 重新生成模板	reference/deploy/10_upload_artifacts.md
11	创建资源栈	reference/deploy/11_create_stack.md
12	等待终态 + 健康检查	reference/deploy/12_wait_stack.md
13	记录状态	reference/deploy/13_record_state.md
14	追加应用档案	reference/deploy/14_app_timeline.md

---

热更新

触发条件：存在 .qwencloud-deploy + 用户希望更新代码。IP 不变。

步骤	操作	参考
U1	构建 + 上传新构件	reference/deploy/10_upload_artifacts.md
U2	执行更新（Cloud Assistant）	reference/hotfix/update_app.md
U3	健康检查 + 更新状态	reference/hotfix/update_app.md
U4	追加应用档案（event=hotfix）	reference/deploy/14_app_timeline.md

更新脚本模板：reference/hotfix/update_recipe.md。

---

删除 / 清理

触发条件：用户说“删除”“清理”或“释放资源”。

⚠️ 不可撤销——请确认两次。使用 RDS 时：警告用户数据可能丢失。

🚫 切勿手动删除单个资源——只能使用 delete_stack.sh。

参见 reference/cleanup/delete_stack.md。

---

HTTPS 设置（可选）

触发条件：部署完成后，用户说“绑定域名”/“HTTPS”/“SSL”。

参见 reference/https/https_setup.md。

---

关键约束

约束	规则
货币	始终使用 USD
身份验证	使用 OAuth（推荐）或 AK/SK；切勿通过聊天收集凭据
模板上传	必须使用 --TemplateURL（WAF 会拦截 TemplateBody）
重试堆栈名称	重用原名称——切勿重新生成
资源删除	始终通过 delete_stack.sh
默认区域	ap-southeast-1
提供给用户的命令	切勿显示底层命令

---

文件布局

scripts/
  generate_template.py  upload_artifacts.py
  create_stack.sh       record_state.py
  delete_stack.sh       update_app.sh
  wait_and_probe.py     setup_domain.sh
  append_timeline.py
reference/
  deploy/
    01_env_check.md ~ 14_app_timeline.md
  hotfix/
    update_app.md       update_recipe.md
  cleanup/
    delete_stack.md
  https/
    https_setup.md
  rules/
    rule_interaction.md  rule_error_handling.md  ram_policies.md
templates/
  ros_single[_rds].yaml
  userdata/{systemd,docker,nginx_proxy,nginx_static,nginx_static_proxy}.sh