使用 AWS Amplify Hosting 部署

自动检测能用，但提前心里有数会更顺畅

Amplify 会在首次连接时尝试检测你的框架。对于常见框架，无需干预即可正常工作——Next.js、Nuxt、Vite、Create React App、Hugo、纯 HTML 都没问题。对于不太常见的框架（SvelteKit edge runtime、Remix、带适配器的 Astro），自动检测选取的默认值未必符合你的配置。

连接之前，请确认以下几点：

• 你的构建命令（npm run build、pnpm build、hugo 等）。
• 输出目录（./dist、./out、./public、./.next）。
• 是否需要服务端渲染（Amplify 支持 Next.js 和 Nuxt 的 SSR；静态导出在所有框架下都更简单）。

GitHub 是最顺畅的路径，其他选项也能用

在 AWS 控制台，打开 Amplify → 创建新应用 → 托管 Web 应用。选择你的 git 提供商：

• GitHub：跳转到 GitHub 进行 OAuth 授权；你授予 Amplify GitHub App 访问特定仓库（或所有仓库）的权限。流程最为完善。
• Bitbucket / GitLab：同样通过 OAuth；可以正常工作。
• AWS CodeCommit：AWS 自有的 git 托管——使用 IAM，无需 OAuth。只有在你已经在用 CodeCommit 的情况下才值得选；否则 GitHub 更快。

授权后，选择仓库和分支（生产环境通常是 main）。点击"下一步"。

Amplify 为你生成的 amplify.yml 文件

Amplify 会展示一个描述构建过程的 YAML 文件。对于自动检测到的 Vite 项目，它看起来像这样：

version: 1
frontend:
  phases:
    preBuild:
      commands:
        - npm ci
    build:
      commands:
        - npm run build
  artifacts:
    baseDirectory: dist
    files:
      - '**/*'
  cache:
    paths:
      - node_modules/**/*

如果检测结果看起来正确，直接接受并继续。如果输出目录有误（最常见的错误——Amplify 猜测是 dist，但你的实际是 build，或者反过来），在这里修改 baseDirectory。你也可以将此文件以 amplify.yml 的形式提交到仓库根目录，以便将构建配置纳入源码管理。

五个阶段，逐一变绿

点击保存并部署。Amplify 会执行以下流水线：

1. Provision（预置）——启动一个 CodeBuild 容器。
2. Build（构建）——运行你的构建命令。
3. Deploy（部署）——将构建产物上传到 CloudFront 支持的 CDN。
4. Verify（验证）——快速检查部署是否已上线。
5. Test（测试）——如果已配置则运行端到端测试（默认跳过）。

耗时：小项目 2–5 分钟，依赖包较多时更长。当 Deploy 变绿后，Amplify 会显示上线 URL——https://main.d1234abcde.amplifyapp.com。点击它，你的站点应该可以正常访问。这个 URL 已启用 HTTPS，由 CloudFront 边缘节点缓存，在你绑定自定义域名之前就已经可以用了。

DNS 在 Route 53 则一键搞定；否则需要手动添加 CNAME

App → 域名管理 → 添加域名。输入 mybrand.com。Amplify 会展示子域名映射关系：

• mybrand.com → main 分支
• www.mybrand.com → main 分支（可设置重定向到顶级域名，或反过来——选择你的规范域名）

点击保存。Amplify 会申请 ACM 证书（在 us-east-1 内部处理，你无需操心）并请求 DNS 验证：

• 如果 DNS 在同一账户的 Route 53 中：Amplify 会自动将验证记录写入你的托管区域。等待 5–15 分钟后，域名状态显示为"活跃"。
• 如果 DNS 在其他地方：Amplify 会展示需要在你的 DNS 提供商处添加的 CNAME 记录。添加完成后等待验证，再回到 Amplify 控制台确认。

一个分支对应一个 URL

在应用概览页，点击连接分支。选择一个功能分支——Amplify 会在 https://<branch-name>.d1234abcde.amplifyapp.com 创建一个独立的部署。向该分支推送代码会触发预览部署，main 分支不受影响。

基于 PR 的预览：应用设置 → 预览 → 启用。Amplify 会监听连接的 GitHub/GitLab 仓库中的未关闭 PR，并为每个 PR 创建临时预览 URL。便于代码评审；PR 关闭后 URL 自动消失。

git push 就是部署命令

就这么简单。推送到 main → Amplify 构建 → 部署 → 使 CloudFront 缓存失效 → 几分钟内你就能在 mybrand.com 看到新版本。CLI 虽然存在（amplify push 用于 Amplify Studio 侧；amplify pull 用于同步配置），但仅做托管的话你很少会用到它。

构建日志在 App → 分支 → 构建编号处查看。构建失败默认会发邮件通知；如需更丰富的告警，可通过应用设置 → 通知接入 Slack / Discord。