为静态站点创建 GitLab Pages 部署

创建 GitLab Pages 部署，将您的静态站点或框架转换为托管在 GitLab 上的网站。 通过分步表单，GitLab 会：

• 根据您的项目设置生成自定义 CI/CD 配置。
• 创建为 GitLab Pages 部署配置的 .gitlab-ci.yml 文件。
• 通过合并请求提交更改供您审核。
• 当合并请求被提交时自动部署您的网站。

本指南说明如何使用 Pages UI 部署静态站点或基于框架的应用程序。

前置条件

• 您的应用程序必须 将文件输出到 public 文件夹。如果您在构建过程中创建了这个文件夹，则无需将其提交到 Git。

  此步骤很重要。请确保您的文件位于根级别的 public 文件夹中。

• 您必须拥有一个项目，该项目能够：

  • 生成静态站点或客户端渲染的单页应用程序（SPA），如 Eleventy、Astro 或 Jekyll。
  • 包含配置为静态输出的框架，如 Next.js、Nuxt 或 SvelteKit。

• 必须为项目启用 GitLab Pages。（要启用，请转到 设置 > 通用， 展开 可见性、项目功能、权限，然后打开 Pages 开关。）

创建 Pages 部署

要完成设置并生成 GitLab Pages 部署：

1. 在左侧边栏，选择 搜索或转到 并找到您的项目。

2. 选择 部署 > Pages。

   将出现 开始使用 Pages 表单。如果此表单不可用， 请参阅 故障排除。

3. 对于 步骤 1，输入镜像名称。您也可以 设置要与 Pages 一起部署的自定义文件夹。

4. 选择 下一步。

5. 对于 步骤 2，输入您的安装步骤。如果您的框架构建过程不需要提供的构建命令之一，您可以：

• 通过选择 下一步 跳过该步骤。
• 如果您仍希望将该步骤的样板代码合并到 .gitlab-ci.yml 文件中，请输入 :（bash “什么都不做” 命令）。

1. 选择 下一步。
2. 对于 步骤 3，输入指示如何构建应用程序的脚本。
3. 选择 下一步。
4. 可选。根据需要编辑生成的 .gitlab-ci.yml 文件。
5. 对于 步骤 4，添加提交消息并选择 提交。此提交将触发您的第一次 GitLab Pages 部署。

要查看正在运行的流水线，请转到 构建 > 流水线。

要查看部署过程中创建的工件，请查看作业， 然后在右侧选择 下载工件。

故障排除

如果 Get Started with Pages 表单不可用

如果出现以下情况，Get Started with Pages 表单将不可用：

• 之前已部署过 GitLab Pages 网站。
• 至少通过表单提交过一次 .gitlab-ci.yml。

要解决此问题：

• 如果出现 等待 Pages 流水线完成 的消息，请选择 重新开始 以再次启动表单。
• 如果您的项目之前已成功部署过 GitLab Pages， 请 手动更新 您的 .gitlab-ci.yml 文件。