部署指南
本章提供详细的部署步骤,帮助您将项目顺利发布到 Pages 平台。无论您是初学者还是经验丰富的开发者,本指南涵盖从环境配置到实际部署的各个环节。遵循这些指导,您将能够高效管理项目部署,确保其在生产环境中的稳定性和可用性。
说明:
对于任何新部署,Pages 都会自动创建一个新的且唯一的 URL ,您可以使用该 URL 预览项目最新的更改。
部署的生命周期
部署生命周期包括从开发到生产的几个阶段:
本地开发:您可以根据自己的开发习惯编写代码。建议在每次开发前拉取最新的 env 文件,以确保使用最新的环境变量。
提交和推送:开发任务完成后,您可以将代码推送至连接的 Git 存储库的开发分支。每次推送都会自动触发一次部署。
预览:部署成功后,Pages 会为该部署分配相应的域名,您可以通过「预览」按钮生成一个有效期为三个小时的访问链接。
生产:完成开发周期后,您最终会将更改合并或提交到生产分支(通常为 main)。Pages 将再次执行构建和部署过程,完成后,您的部署将自动分配部署域名,包括您添加的任何自定义域名。
失效:当成功的部署记录超过十条时,Pages 会按照时间顺序保留前十条部署的构建产物,并将其他成功状态的部署记录标记为已失效。同时,失效的部署将返回 401 状态代码。您可以通过「重新部署」功能,以该部署的配置新创建一个部署,从而恢复失效部署的访问。
触发部署
Git 自动触发部署
将 Pages 项目与 Git 仓库关联后,系统会自动监听推送事件并触发部署。目前默认只有主干分支的提交才会自动触发部署。
手动触发部署
在 Pages 控制台中,您可以通过以下方式手动触发部署:
点击项目列表中的“重新部署”按钮,以重新构建最新的部署配置。
在构建部署记录中选择特定的部署记录进行重新部署。
预览部署
对于每个部署记录,Pages 提供了一个唯一的访问链接,方便您快速验证效果。
说明:
构建日志
构建日志记录了每次构建过程中的详细信息,包括常规的构建输出、成功消息、警告和失败的特别信息。这些日志旨在帮助用户快速定位和解决问题。通过分析构建日志,您可以轻松识别构建过程中的潜在错误和警告,从而优化项目设置和提高构建效率。
构建物料
构建产物列出了构建生成的所有文件。您可以在此列表中查看每个文件的名称和大小,还可以点击具体文件以查看其详细内容,帮助您更好地理解和管理构建产物。
注意:
为提高存储容量的利用效率,当成功状态的部署记录超过十条时,系统会自动清理最早的部署记录对应的构建产物。您可以通过「重新部署」功能,以该部署的配置新创建一个部署,从而恢复失效部署的访问。