用途:esa-deploy 用于将 React/Vite 前端应用部署到阿里云 ESA Pages(边缘计算静态站点托管,含全球 CDN 加速),并管理部署、自定义域名与路由,同时支持本地开发调试。
前置条件:需安装 ESA CLI:npm install esa-cli@latest -g;需配置 AccessKey 的阿里云账号;并执行 esa-cli login 登录。
基本用法:进入应用目录后构建并部署:cd app,npm run build && esa-cli deploy。部署前需确保存在 esa.jsonc 配置,其中可定义 name、assets.directory、assets.notFoundStrategy(如 singlePageApplication)以及 dev.port 等。生产环境变量在构建前写入 .env.local,例如 VITE_SUPABASE_URL、VITE_SUPABASE_ANON_KEY,以及 VITE_ENABLE_MSW=false、VITE_LOG_LEVEL=info。
主要命令:认证有 esa-cli login 与 esa-cli logout;部署有 esa-cli deploy、esa-cli deploy ./dist、esa-cli deployments;项目管理有 esa-cli init my-project、esa-cli project、esa-cli site;域名管理有 esa-cli domain add your-domain.com、esa-cli domain list、esa-cli domain remove your-domain.com;路由管理有 esa-cli route add -r your-domain.com -s <site-name>、esa-cli route list;本地开发有 esa-cli dev、esa-cli dev --port 3000。
部署检查:关闭 MSW 模拟(VITE_ENABLE_MSW=false)、确认环境变量、成功执行 npm run build、检查 dist/ 目录存在、核对 esa.jsonc 配置,再运行 esa-cli deploy。成功后输出会显示应用名与形如 https://your-app.xxx.er.aliyun-esa.net 的 URL。
常见问题:提示“esa.jsonc not found”时确认处在包含该文件的目录;提示“Not logged in”时执行 esa-cli login;构建失败可检查 Node 版本(>= 20.x),并清理重装:rm -rf node_modules && npm install,再 npm run build。出现 bundle 体积过大警告时可考虑代码分割。
限制:资料未提供该技能的收费、价格、平台覆盖范围之外的细节及具体效果说明;部分参考文档(环境配置、自定义域名、CI/CD 集成)仅给出文件名,未提供其内容。