GitLab Pages

GitLab Pages

版本历史

  • 在 GitLab 企业版 8.3 中引入 .
  • GitLab 企业版 8.5 中了具有 TLS 支持的自定义 CNAME.
  • 移植到 GitLab 8.17 中的 GitLab 社区版.
  • 在 GitLab 11.8 中了对子组项目网站的支持.
  • 捆绑的项目模板在 GitLab 11.8 中引入 .

借助 GitLab 页面，您可以直接从 GitLab 中的存储库发布静态网站.

  • 用于任何个人或企业网站.
  • 为您的项目，组或用户帐户创建网站.
  • 免费在自己的 GitLab 实例或 GitLab.com 上托管您的网站.
  • 连接您的自定义域和 TLS 证书.
  • 将任何许可归于您的内容.

要发布包含 Pages 的网站，您可以使用任何 SSG，例如 Gatsby，Jekyll，Hugo，Middleman，Harp，Hexo 和 Brunch 等. 您还可以发布直接用纯 HTML，CSS 和 JavaScript 编写的任何网站.

网页不支持动态服务器端的处理，例如，作为和.asp需要. 了解更多有关 .

要创建一个 GitLab Pages 网站：

了解更多信息并查看示例：

要使用 GitLab 页面，您必须在 GitLab 中创建一个项目以将您网站的文件上传到该项目. 这些项目可以是公共的，内部的或私人的.

GitLab 始终从资源库中一个非常特定的文件夹部署您的网站. 在 GitLab 中创建新项目时， 存储库将自动可用.

为了部署您的站点，GitLab 使用其内置工具来构建您的站点并将其发布到 GitLab Pages 服务器. GitLab CI / CD 运行以完成此任务的脚本序列是从名为.gitlab-ci.yml的文件中创建的 ，您可以随意 . 配置文件中称为pages的特定job会使 GitLab 知道您正在部署 GitLab Pages 网站.

您可以将 GitLab 的默认域用于 *.gitlab.io ，也可以使用自己的域（ example.com ）. 在这种情况下，您需要对您域的注册商（或控制面板）具有管理员权限，才能使用 Pages 对其进行设置.

下图显示了开始使用 Pages 可能需要遵循的工作流程.

如果您使用的是 GitLab Pages 默认域（ .gitlab.io ），则您的网站将自动安全并在 HTTPS 下可用. 如果您使用自己的自定义域，则可以选择使用 SSL / TLS 证书对其进行保护.

If you’re using GitLab.com, your website will be publicly available to the internet. To restrict access to your website, enable GitLab Pages Access Control.

如果您使用的是自我管理的实例（Core，Starter，Premium 或 Ultimate），则根据 sysadmin 选择的 ，您的网站将发布在您自己的服务器上，管理员可以将其设置为公开或内部.

有一些因特定原因而建立的 GitLab Pages 网站的出色示例. 这些示例可以教您使用高级技术并适应您自己的需求：

如果您正在运行 GitLab 的自我管理实例（GitLab 社区版和企业版），请按照管理步骤来配置页面.

观看有关如何开始使用 GitLab 页面管理的 .