Skip to main content

此版本的 GitHub Enterprise Server 将于以下日期停止服务 2024-08-29. 即使针对重大安全问题,也不会发布补丁。 为了获得更好的性能、更高的安全性和新功能,请升级到最新版本的 GitHub Enterprise。 如需升级帮助,请联系 GitHub Enterprise 支持

配置 GitHub Pages 站点的发布源

可将 GitHub Pages 站点配置为在将更改推送到特定分支时发布,也可以编写 GitHub Actions 工作流来发布站点。

谁可以使用此功能?

People with admin or maintainer permissions for a repository can configure a publishing source for a GitHub Pages site.

GitHub Pages 适用于具有 GitHub Free 和组织的 GitHub Free 的公共存储库,以及具有 GitHub Pro、GitHub Team、GitHub Enterprise Cloud 和 GitHub Enterprise Server 的公共和专用存储库。

关于发布源

可以在将更改推送到特定分支时发布站点,也可以编写 GitHub Actions 工作流来发布站点。 若要将 GitHub Actions 用作 GitHub Pages 的发布源,站点管理员必须为 你的 GitHub Enterprise Server 实例启用 GitHub Actions。 有关详细信息,请参阅“启用 GitHub Actions for GitHub Enterprise Server”。

如果不需要对站点的生成过程进行任何控制,则建议在将更改推送到特定分支时发布站点。 可以指定要用作发布源的分支和文件夹。 源分支可以是存储库中的任何分支,源文件夹可以是源分支上的存储库根目录 (/),也可以是源分支上的 /docs 文件夹。 将更改推送到源分支时,源文件夹中的更改将发布到 GitHub Pages 站点。

如果想使用 Jekyll 以外的生成过程,或者不想使用专用分支来保存已编译的静态文件,则建议编写 GitHub Actions 工作流来发布站点。 GitHub Enterprise Server 为常见的发布方案提供入门工作流,以帮助编写工作流。

警告:如果你的站点管理员启用了公共页面,GitHub Pages 站点将在 Internet 上公开,即使该站点的存储库是私有的或内部的也是如此。 如果站点的存储库中有敏感数据,你可能想要在发布前删除数据。 有关详细信息,请参阅“为企业配置 GitHub Pages”和“关于仓库”。

从分支进行发布

  1. 确保你要用作发布源的分支已经存在于你的存储库中。

  2. 在 GitHub Enterprise Server 上,导航到站点的仓库。

  3. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  4. 在边栏的“代码和自动化”部分中,单击“ Pages”。

  5. 在“生成和部署”的“源”下,选择“从分支进行部署”。

  6. 在“生成和部署”下,使用分支下拉菜单并选择发布源。

    GitHub 存储库中 Pages 设置的屏幕截图。 用于为发布源选择分支的菜单(标有“无”)用深橙色框出。

  7. (可选)使用文件夹下拉菜单选择发布源的文件夹。

    GitHub 存储库中 Pages 设置的屏幕截图。 用于为发布源选择文件夹的菜单(标有“/(根)”)用深橙色框出。

  8. 单击“ 保存”。

从分支进行发布疑难解答

Note: If your repository contains symbolic links, you will need to publish your site using a GitHub Actions workflow. For more information about GitHub Actions, see "GitHub Actions 文档."

注释

  • 如果从分支进行发布且站点尚未自动发布,请确保具有管理员权限和经验证的电子邮件地址的人员已将站点推送到发布源。

  • 由使用 GITHUB_TOKEN 的 GitHub Actions 工作流推送的提交不会触发 GitHub Pages 生成。

如果选择任意分支上的 docs 文件夹作为发布源,稍后从存储库中的该分支中删除 /docs 文件夹,则站点不会生成,并且你将收到缺失 /docs 文件夹的页面生成错误消息。 有关详细信息,请参阅“排查 GitHub Pages 站点的 Jekyll 构建错误”。

使用自定义 GitHub Actions 工作流进行发布

若要将站点配置为使用 GitHub Actions 进行发布,请执行以下操作:

  1. 在 GitHub Enterprise Server 上,导航到站点的仓库。

  2. 在存储库名称下,单击 “设置”。 如果看不到“设置”选项卡,请选择“”下拉菜单,然后单击“设置”********。

    存储库标头的屏幕截图,其中显示了选项卡。 “设置”选项卡以深橙色边框突出显示。

  3. 在边栏的“代码和自动化”部分中,单击“ Pages”。

  4. 在“生成和部署”的“源”下,选择“GitHub Actions”。

  5. GitHub Enterprise Server 将推荐多个入门工作流。 如果已有用于发布站点的工作流,可跳过此步骤。 否则,请选择其中一个选项来创建 GitHub Actions 工作流。 有关创建自定义工作流的详细信息,请参阅“创建自定义 GitHub Actions 工作流以发布站点”。

    GitHub Pages 不会将特定工作流与 GitHub Pages 设置相关联。 但 GitHub Pages 设置将链接到最近部署你的站点的工作流运行。

创建自定义 GitHub Actions 工作流以发布站点

有关 GitHub Actions 的详细信息,请参阅“GitHub Actions 文档”。

将站点配置为使用 GitHub Actions 进行发布时,GitHub Enterprise Server 将针对常见发布方案推荐入门工作流。 工作流的一般流程如下:

  1. 每当推送到存储库的默认分支,或者每当从“操作”选项卡手动运行工作流时,就会触发工作流。
  2. 使用 actions/checkout 操作签出存储库内容。
  3. 如果站点需要,请生成任何静态站点文件。
  4. 使用 actions/upload-pages-artifact 操作将静态文件作为项目上传。
  5. 如果推送到默认分支触发了工作流,请使用 actions/deploy-pages 操作来部署项目。 如果拉取请求触发了工作流,则跳过此步骤。

入门工作流使用名为 github-pages 的部署环境。 如果存储库尚未包含名为 github-pages 的环境,则自动创建该环境。 建议添加部署保护规则,确保仅默认分支可部署到该环境。 有关详细信息,请参阅“使用环境进行部署”。

使用自定义 GitHub Actions 工作流进行发布故障排除

有关如何对 GitHub Actions 工作流进行故障排除的信息,请参阅“关于监控和疑难解答”。