GitHub Actions for GitHub Enterprise Server 使用入门

了解首次在 GitHub Enterprise Server 上启用和配置 GitHub Actions。

Site administrators can enable GitHub Actions and configure enterprise settings.

注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

本文介绍站点管理员如何配置 GitHub Enterprise Server 来使用 GitHub Actions。 它涵盖了硬件和软件需求、存储选项以及安全管理策略。

查看硬件注意事项

The CPU and memory resources available to 您的 GitHub Enterprise Server 实例 determine the number of jobs that can be run concurrently without performance loss.

The peak quantity of concurrent jobs running without performance loss depends on such factors as job duration, artifact usage, number of repositories running Actions, and how much other work your instance is doing not related to Actions. Internal testing at GitHub demonstrated the following performance targets for GitHub Enterprise Server on a range of CPU and memory configurations:

vCPU内存Maximum Concurrency*
32128 GB1500 个作业
64256 GB1900 个作业
96384 GB2200 个作业

*Maximum concurrency was measured using multiple repositories, job duration of approximately 10 minutes, and 10 MB artifact uploads. You may experience different performance depending on the overall levels of activity on your instance.

如果您计划中的测试版以便为现有实例的用户启用 GitHub Actions,请查看用户的活动级别和实例上的自动化,并确保已为用户预配足够的 CPU 和内存。 有关监控 GitHub Enterprise Server 容量和性能的更多信息,请参阅“监控您的设备”。

有关 您的 GitHub Enterprise Server 实例 的最低硬件要求的更多信息,请参阅实例平台的硬件考虑因素。

有关为现有实例调整资源的更多信息,请参阅“增加存储容量”和“增加 CPU 或内存资源”。

外部存储要求

要在 GitHub Enterprise Server 上启用 GitHub Actions,您必须有权访问外部 Blob 存储。

GitHub Actions 使用 Blob 存储来存储工作流程运行生成的构件,如工作流程日志和用户上传的构建构件。 所需存储量取决于您使用 GitHub Actions 的情况。 仅支持单个外部存储配置,不能同时使用多个存储提供程序。

GitHub Actions 支持以下存储提供商:

  • Azure Blob 存储
  • Amazon S3
  • S3 兼容的 MinIO Gateway for NAS

注:只有这些是 GitHub 支持并可以提供帮助的存储提供程序。 由于 S3 API 的差异,其他 S3 API 兼容的存储提供程序难以正常工作。 联系我们 以请求支持额外的存储提供程序。

Networking considerations

If GitHub Actions is enabled for your enterprise, only HTTP proxies are supported. SOCK5 and HTTPS proxies and Polipo are not supported. For more information about using a proxy with GitHub Enterprise Server, see "Configuring an outbound web proxy server."

使用您的存储提供程序启用 GitHub Actions

请按照以下过程之一使用所选存储提供程序启用 GitHub Actions:

管理企业中 GitHub Actions 的访问权限

您可以使用策略来管理 GitHub Actions 的访问。 更多信息请参阅“为企业执行 GitHub Actions 策略”。

添加自托管的运行器

注: GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。 您可以在 GitHub 公共路线图 上查看有关未来支持计划的更多信息。

要运行 GitHub Actions 工作流程,您需要添加自托管运行器。 您可以在企业、组织或仓库级别添加自托管运行器。 更多信息请参阅“添加自托管的运行器”。

管理哪些操作可用于您的企业

您可以控制允许用户在企业中使用哪些操作。 这包括设置 GitHub Connect 以自动访问来自 GitHub.com 的操作,或手动同步来自 GitHub.com 的操作。

更多信息请参阅“关于使用企业中的操作”。

GitHub Actions 的一般安全性增强

如需了解有关 GitHub Actions 安全实践的更多信息,请参阅“GitHub Actions 的安全性增强”。

Reserved Names

When you enable GitHub Actions for your enterprise, two organizations are created: github and actions. If your enterprise already uses the github organization name, github-org (or github-github-org if github-org is also in use) will be used instead. If your enterprise already uses the actions organization name, github-actions (or github-actions-org if github-actions is also in use) will be used instead. Once actions is enabled, you won't be able to use these names anymore.

此文档对您有帮助吗?

隐私政策

帮助我们创建出色的文档!

所有 GitHub 文档都是开源的。看到错误或不清楚的内容了吗?提交拉取请求。

做出贡献

或, 了解如何参与。