qwencloud-deploy

Compare original and translation side by side

🇺🇸

Original

English

🇨🇳

Translation

Chinese

Qwen Cloud Deploy

Quick Path

快速路径

Route the task — Match to one of 4 modes: Full-Stack Deploy · Hot Update · Delete · HTTPS Setup.
Deploy (default) — Execute steps 1→13 in order; each step has a reference doc.
Confirm cost before creating anything — Show hourly price in USD, get user confirmation.
Record state — On success write
```
.qwencloud-deploy
```
.

任务路由 — 匹配以下4种模式之一：全栈部署 · 热更新 · 删除 · HTTPS配置。
部署（默认） — 按顺序执行步骤1→13；每个步骤都有参考文档。
创建资源前确认成本 — 以美元显示每小时价格，获取用户确认。
记录状态 — 成功后写入
```
.qwencloud-deploy
```
文件。

Scope

适用范围

In Scope	Out of Scope
Local project / Git → Alibaba Cloud International	China site → use `qianwenai-deploy`
Full-stack ROS, hot update, cleanup	AWS/GCP/Azure/other clouds
ECS + optional RDS + OSS + public IP	K8s/Serverless/container orchestration
OAuth/AK auth (no credential collection)	—

包含范围	排除范围
本地项目/Git仓库 → 阿里云国际版	中国站 → 使用 `qianwenai-deploy`
全栈ROS、热更新、资源清理	AWS/GCP/Azure/其他云平台
ECS + 可选RDS + OSS + 公网IP	K8s/Serverless/容器编排
OAuth/AK认证（不收集凭证）	—

Assumptions

前提假设

```
aliyun
```
CLI 3.x installed; when no valid credential, follow
```
reference/deploy/01_env_check.md
```
.
Default region
```
ap-southeast-1
```
(Singapore).

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

Task Routing

任务路由

Signal	Mode
`.qwencloud-deploy` exists + user says "update"	Hot Update
`.qwencloud-deploy` exists + "delete"/"cleanup"	Delete
"bind domain"/"HTTPS"/"SSL" (deployment exists)	HTTPS Setup
Git URL or local project (no existing deployment)	Full-Stack Deploy

On trigger, display welcome message first (see

reference/rules/rule_interaction.md

触发信号	模式
存在 `.qwencloud-deploy` 文件 + 用户提及“update”	热更新
存在 `.qwencloud-deploy` 文件 + 用户提及“delete”/“cleanup”	删除
用户提及“bind domain”/“HTTPS”/“SSL”（已完成部署）	HTTPS配置
Git URL或本地项目（无现有部署）	全栈部署

触发任务后，先显示欢迎信息（详见

reference/rules/rule_interaction.md

）。

Full-Stack Deploy (Steps 1–13)

全栈部署（步骤1–13）

Phase 1 · Preparation

阶段1 · 准备工作

Step	Action	Reference
1	Environment check	`reference/deploy/01_env_check.md`
2	Git clone (if Git URL)	`reference/deploy/02_git_clone.md`
3	Project analysis	`reference/deploy/03_analyze_project.md`

步骤	操作	参考文档
1	环境检查	`reference/deploy/01_env_check.md`
2	Git克隆（若提供Git URL）	`reference/deploy/02_git_clone.md`
3	项目分析	`reference/deploy/03_analyze_project.md`

Phase 2 · Resource Planning

阶段2 · 资源规划


reference/deploy/04_check_existing.md
reference/deploy/05_database.md
reference/deploy/06_instance_type.md
reference/deploy/07_generate_template.md
reference/deploy/08_check_stock.md
reference/deploy/09_estimate_cost.md

Step	Action	Reference
4	Existing deployment scan	`reference/deploy/04_check_existing.md`
5	Database identification	`reference/deploy/05_database.md`
6	ECS instance type selection	`reference/deploy/06_instance_type.md`
7	Generate ROS template	`reference/deploy/07_generate_template.md`
8	Stock check	`reference/deploy/08_check_stock.md`
9	Template validation + cost estimate	`reference/deploy/09_estimate_cost.md`


reference/deploy/04_check_existing.md
reference/deploy/05_database.md
reference/deploy/06_instance_type.md
reference/deploy/07_generate_template.md
reference/deploy/08_check_stock.md
reference/deploy/09_estimate_cost.md

步骤	操作	参考文档
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`

Phase 3 · Execution

阶段3 · 执行部署

Step	Action	Reference
10	Upload artifacts + regenerate template	`reference/deploy/10_upload_artifacts.md`
11	Create stack	`reference/deploy/11_create_stack.md`
12	Wait for terminal state + health check	`reference/deploy/12_wait_stack.md`
13	Record state	`reference/deploy/13_record_state.md`

步骤	操作	参考文档
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`

Hot Update

热更新

Trigger:

.qwencloud-deploy

exists + user wants to update code. IP unchanged.

Step	Action	Reference
U1	Build + upload new artifacts	`reference/deploy/10_upload_artifacts.md`
U2	Deliver update (Cloud Assistant)	`reference/hotfix/update_app.md`
U3	Health check + update state	`reference/hotfix/update_app.md`

Update script template:

reference/hotfix/update_recipe.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`

更新脚本模板：

reference/hotfix/update_recipe.md

。

Delete / Cleanup

删除 / 资源清理

Trigger: User says "delete", "cleanup", "release resources".

⚠️ Irreversible — confirm twice. With RDS: warn about data loss.

🚫 Never manually delete individual resources — only use
delete_stack.sh
.

See

reference/cleanup/delete_stack.md

触发条件：用户提及“delete”、“cleanup”、“release resources”。

⚠️ 操作不可逆 — 需双重确认。若包含RDS：需警告数据丢失风险。

🚫 禁止手动删除单个资源 — 仅可使用
delete_stack.sh
脚本。

详见

reference/cleanup/delete_stack.md

。

HTTPS Setup (Optional)

HTTPS配置（可选）

Trigger: User says "bind domain" / "HTTPS" / "SSL" after deployment exists.

See

reference/https/https_setup.md

触发条件：用户在部署完成后提及“bind domain”/“HTTPS”/“SSL”。

详见

reference/https/https_setup.md

。

Key Constraints

关键约束

Constraint	Rule
Currency	Always USD
Auth	OAuth (recommended) or AK/SK; never collect credentials via chat
Template upload	Must use `--TemplateURL` (WAF blocks TemplateBody)
Stack name retry	Reuse — never regenerate
Resource deletion	Always via `delete_stack.sh`
Region default	`ap-southeast-1`
Commands to user	Never show underlying commands

约束项	规则
货币单位	始终使用美元（USD）
认证方式	OAuth（推荐）或AK/SK；绝不通过聊天收集凭证
模板上传	必须使用 `--TemplateURL` （WAF会拦截TemplateBody）
资源栈名称重试	重复使用 — 绝不重新生成
资源删除	始终通过 `delete_stack.sh` 执行
默认区域	`ap-southeast-1`
向用户展示的命令	绝不显示底层命令

File Layout

文件结构

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
reference/
  deploy/
    01_env_check.md ~ 13_record_state.md
  hotfix/
    update_app.md       update_recipe.md
  cleanup/
    delete_stack.md
  https/
    https_setup.md
  rules/
    rule_interaction.md  rule_error_handling.md
templates/
  ros_single[_rds].yaml
  userdata/{systemd,docker,nginx_proxy,nginx_static,nginx_static_proxy}.sh

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
reference/
  deploy/
    01_env_check.md ~ 13_record_state.md
  hotfix/
    update_app.md       update_recipe.md
  cleanup/
    delete_stack.md
  https/
    https_setup.md
  rules/
    rule_interaction.md  rule_error_handling.md
templates/
  ros_single[_rds].yaml
  userdata/{systemd,docker,nginx_proxy,nginx_static,nginx_static_proxy}.sh