如何在 GitLab 上使用 Git Pages？

推荐答案

在 GitLab 上使用 Git Pages 的步骤如下：

1. 创建项目：首先在 GitLab 上创建一个新的项目，或者使用现有的项目。

2. 配置 .gitlab-ci.yml 文件：在项目的根目录下创建一个 .gitlab-ci.yml 文件，并添加以下内容：

   // www.javascriptcn.com code example
   pages:
     stage: deploy
     script:
       - mkdir .public
       - cp -r * .public
       - mv .public public
     artifacts:
       paths:
         - public
     only:
       - main

   这个配置文件定义了一个 pages 任务，它会在 main 分支上运行，并将生成的文件存储在 public 目录中。

3. 推送代码：将代码推送到 GitLab 仓库的 main 分支。

4. 访问 GitLab Pages：GitLab 会自动构建并部署你的页面。构建完成后，你可以通过 https://<username>.gitlab.io/<projectname> 访问你的 GitLab Pages。

本题详细解读

1. 创建项目

在 GitLab 上创建一个新项目，或者使用现有的项目。确保项目中有你想要展示的内容，比如 HTML、CSS、JavaScript 文件等。

2. 配置 .gitlab-ci.yml 文件

.gitlab-ci.yml 文件是 GitLab CI/CD 的配置文件，用于定义构建、测试和部署的流程。在这个文件中，我们定义了一个名为 pages 的任务，它会在 main 分支上运行。

• stage: deploy：表示这个任务属于 deploy 阶段。
• script：定义了任务的执行脚本。在这个例子中，脚本会创建一个 .public 目录，将项目中的所有文件复制到这个目录中，然后将 .public 目录重命名为 public。
• artifacts：指定了构建过程中生成的文件路径。在这里，public 目录中的内容会被保存为构建产物。
• only: main：表示这个任务只会在 main 分支上运行。

3. 推送代码

将代码推送到 GitLab 仓库的 main 分支。GitLab 会自动检测到 .gitlab-ci.yml 文件，并开始执行 CI/CD 流程。

4. 访问 GitLab Pages

一旦构建成功，GitLab 会将 public 目录中的内容部署到 GitLab Pages。你可以通过 https://<username>.gitlab.io/<projectname> 访问你的页面。其中 <username> 是你的 GitLab 用户名，<projectname> 是你的项目名称。

注意事项

• 确保你的项目中有 index.html 文件，这是 GitLab Pages 的默认入口文件。
• 如果你使用的是自定义域名，可以在项目的设置中配置 GitLab Pages 的域名。
• GitLab Pages 的构建和部署可能需要一些时间，请耐心等待。