华为云 DevKit 实战：把 2048 小游戏从沙箱一键搬到 ECS 持久化部署

一、背景

最近我用 HuaweiCloud DevKit 做了一次完整的部署实践：把一款纯单文件 HTML 的 2048 小游戏，先从沙箱快速部署获取公网预览，再迁移到 ECS 做持久化托管。整个流程覆盖了 DevKit 插件、KooCLI、沙箱、VPC/EIP/安全组、nginx、cloud-init 等多个华为云能力，收获颇丰。本文记录完整流程与踩坑经验，供同样想快速验证想法、又想把作品长期上线的开发者参考。

二、作品：纯单文件 2048

先说说作品本身。这是一款经典的 2048 数字合并游戏，特点：

• 纯单文件：HTML/CSS/JavaScript 全部内联在一个 index.html（约 7.6KB），零依赖、零构建，双击即玩；
• 双端适配：PC 端支持方向键 / WASD，移动端支持触摸滑动，响应式布局自动适配屏幕；
• 完整玩法：4×4 网格、合并得分、游戏结束判定、localStorage 持久化最高分。

因为它是纯静态资源，非常适合作为"部署练手"的样例——无需后端、无需数据库。

三、沙箱部署：分钟级拿到公网预览

第一步是用 HuaweiCloud DevKit 的沙箱能力快速验证。核心步骤：

1. 环境就绪：DevKit 插件自带 29 个技能与安全策略，KooCLI（hcloud）一键安装；
2. 连接沙箱：通过 sandbox_connect 创建实例（我用的是 2vCPU 4GiB 规格，资源紧张时优先小规格更容易创建成功）；
3. 上传作品：用 sandbox_upload_file 把 index.html 上传到沙箱（带 MD5 校验，确保传输完整）；
4. nginx 托管：安装 nginx 并用 deploy_nginx 配置静态站点；
5. 公网暴露：通过 DevBridge 隧道把本地端口映射为 https://xxx.devbridge-s2.hwtunnel.com 公网地址；
6. 验证：curl -sI 确认返回 HTTP 200 OK。

这一步最大的感受是快——从零到有公网地址，只用了十几分钟，非常适合快速预览。

四、ECS 持久化部署：cloud-init 全自动

沙箱是临时的，作品要长期在线就得落脚到 ECS。完整流程：

1. 网络基础：复用已有 VPC/子网，新建安全组（HTTP 80 放通 0.0.0.0/0，SSH 22 仅放通调试来源）；
2. 弹性公网 IP：创建 5M BGP 按流量计费 EIP；
3. 规格与镜像：选用 1 核 2G 的鲲鹏规格 kc2.small.2 + Huawei Cloud EulerOS 3.0 ARM 镜像（注意：flavor 与镜像的架构必须匹配，我之前用 x86 镜像配 ARM flavor 直接报错）；
4. cloud-init 自动化：这是最精彩的部分——通过 user_data 注入一段 shell 脚本，让实例首次启动时一次性完成：安装 nginx、把 base64 编码的 index.html 解码写入 /usr/share/nginx/html/hc-activity/index.html、启动 nginx；
5. 等待与验证：轮询实例状态到 ACTIVE，绑定 EIP，curl -sI http://<EIP>/hc-activity/index.html 返回 HTTP 200 OK，Server 头显示 nginx/1.24.0。

cloud-init 的价值在于：无需 SSH 登录、无需手动配置，实例一启动服务就已就绪，真正实现了基础设施即代码式的自动化。

五、踩坑与经验

1. flavor 与镜像架构必须匹配
鲲鹏（ARM）规格只能配 ARM 镜像，x86 规格配 x86 镜像，否则报 Flavor does not match the image。

2. 废弃 flavor 要留意
as7.medium.2 这类曾经的通用规格可能已废弃（Ecs.0019: Flavor abandoned），选型前用 hcloud ECS ListFlavors 查询最新可用规格。

3. 参数名以 --help 为准
hcloud 的参数命名（如安全组端口 --security_group_rule.multiport、EIP 关联 --publicip.associate_instance_type）不看帮助很容易猜错。养成"先 --help 再执行"的习惯。

4. 资源紧张时的应对
沙箱节点池偶尔会出现 No available node pool，可尝试换更小的规格或稍后重试；遇到实例卡在中间状态，可在控制台关闭/删除后重建。

5. 用 cloud-init 而非手工 SSH
对于静态站点这类简单部署，user_data 一次性搞定，比 SSH 上传再配置更可靠、更可复现。

六、总结

这次实践让我体会到华为云对开发者的友好：DevKit 沙箱适合快速验证与预览，ECS + cloud-init 适合持久化落地，两者组合覆盖了"从想法到上线"的完整链路。用一套工具、几十行命令，就把一个小游戏从本地开发推进到了公网可访问。

如果你也在做类似的 Web 应用部署，不妨试试这条"沙箱预览 → ECS 持久化"的路线，相信会有不错的体验。

本文基于真实实践整理，欢迎交流。