本文介绍 IGA Pages 部署的概念以及创建、重新部署、预览部署的操作步骤。
在 IGA Pages 中，部署指项目下具体的应用发布实例。每个部署提供一个独立的预览链接，您预览每个部署的效果。每当一个部署生成时，系统会自动触发边缘缓存刷新，会在域名根目录进行一次目录刷新。

前提条件 #

您已经创建了 IGA Pages 项目。详情请参见创建 IGA Pages 项目。

查看部署记录 #

1. 登录全站加速控制台。
2. 在左侧导航栏，点击 服务概览。
3. 切换到 Pages 标签页，然后在项目列表中点击您的项目 ID。
4. 在项目详情中的 部署记录 标签页，可看到该项目的所有部署。

新建部署 #

在 部署记录 标签页，点击 新建部署。部署的触发方式取决于项目的创建方式：

重新部署 #

重新部署会基于所选部署的源代码以及最新的项目配置（环境变量、Node.js 版本、构建命令等），生成一个新的部署并发布到线上。
常见使用场景：

• 修改了环境变量或构建配置后，将变更应用到线上。
• 当前线上版本异常，需要回滚到历史某个部署版本。

操作步骤：

1. 在 部署记录 标签页，找到需要重新部署的记录。
2. 在 操作 列点击 ...，然后点击 重新部署。
3. 在弹出的确认对话框中点击 确定 继续。

预览部署 #

部署成功后，您可以通过两种方式预览：

方式一：项目级预览（最新生效版本） #

在项目详情页右上角，点击 预览，弹窗中会显示当前线上生效版本的预览 URL。

方式二：部署级预览（任一历史版本） #

在 部署记录 列表中，找到目标部署，在 操作 列点击 预览，可获取该次部署对应的预览链接。

排查部署失败 #

部署失败时，点击对应部署记录的 ID 进入 部署详情，查看构建和部署日志。常见原因：

• 缺少依赖或 package.json 配置错误。
• 构建命令不正确：可在构建配置中调整。
• 输出目录配置错误：参考IGA Pages 框架指南确认对应框架的默认输出目录。
• Node.js 版本与项目要求不匹配：可在Node.js 版本中切换。

详细排查思路请参考IGA Pages 构建指南。