Skip to main content

关于在企业中使用操作

GitHub Enterprise Server包括大多数由GitHub编写的操作,并提供了用于启用对来自GitHub.com和GitHub Marketplace的其他操作的访问的选项。

注意

GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。

有关 GitHub Enterprise Server 的操作

GitHub Actions 工作流可使用 操作,它们是可组合起来以创建作业并自定义工作流的单个任务。 可以创建自己的操作,也可以使用社区共享 GitHub 的操作并自定义操作。

GitHub Actions 上的 GitHub Enterprise Server 设计为在没有完全 Internet 访问权限的环境中工作。 默认情况下,工作流不能使用直接来自 GitHub.com 和 GitHub Marketplace 的操作。 你可以限制开发人员只能使用存储在 你的 GitHub Enterprise Server 实例 上的操作,其中包括大多数由 GitHub 官方编写的操作,以及开发人员自行创建的任何操作。 或者,为了让开发人员能够受益于由行业领导者和开源社区构建的完整操作生态系统,您可以配置对来自GitHub.com的其他操作的访问。

建议允许从 GitHub.com中自动访问所有操作。 但是,这确实需要 GitHub Enterprise Server 向 GitHub.com 发起出站连接。 如果您不想允许这些连接,或者想更严格地控制企业中使用哪些操作,则可以从 GitHub.com 手动同步特定操作。

与你的企业实例捆绑的正式操作

大多数官方 GitHub 编写的操作都会自动与 GitHub Enterprise Server 捆绑在一起,并且会在某个时间点从 GitHub Marketplace 获取。

捆绑的官方操作包括以下内容等。

  • actions/checkout
  • actions/upload-artifact
  • actions/download-artifact
  • actions/labeler
  • 各种 actions/setup- 操作

若要查看企业实例中包含的所有官方操作,请浏览到实例上的 actions 组织:https://HOSTNAME/actions

要使用这些操作,你的 GitHub Enterprise Server 实例 和 GitHub.com 之间不需要建立连接。

每个操作都是 actions 组织中的存储库,每个操作存储库都包含工作流可以用于引用操作的必要标记、分支和提交 SHA。 有关如何更新捆绑的正式操作的信息,请参阅“使用官方捆绑操作的最新版本”。

注意

  • actions/setup-LANGUAGE 上使用自托管运行器时,如果使用设置操作(例如 GitHub Enterprise Server),则可能需要在无法访问互联网的运行器上配置工具缓存。 有关详细信息,请参阅“在未接入互联网的自托管运行器上设置工具缓存”。
  • 所有 actions/setup-LANGUAGE action 仓库目前都支持三个平台:macOS、Windows 和 Ubuntu。
  • 更新后 GitHub Enterprise Server ,捆绑操作将自动替换为升级包中的默认版本。
  • 与 GitHub Enterprise Server 捆绑提供意味着该操作可在该环境中使用,但这并不自动保证它与所有平台或自托管运行器兼容。

配置对 GitHub.com 上操作的访问权限

如果企业中的用户需要访问来自 GitHub.com 或 GitHub Marketplace 的其他操作,有几个配置选项。

推荐的方法是启用从 GitHub.com 对所有操作的自动访问。 你可以通过使用 GitHub Connect 将 GitHub Enterprise Server 与 GitHub Enterprise Cloud 集成来实现这一点。 有关详细信息,请参阅“使用 GitHub Connect 启用对 GitHub.com操作的自动访问”。

注意

在配置对 GitHub.com 上操作的访问权限之前,必须先配置 你的 GitHub Enterprise Server 实例 以使用 GitHub Actions。 有关详细信息,请参阅“GitHub Actions for GitHub Enterprise Server 使用入门”。

要使用来自 GitHub.com、 的操作,GitHub Enterprise Server 和自托管运行器都必须能够与 GitHub.com 建立出站连接。 不需要来自 GitHub.com 入站连接。 有关详细信息,请参阅“自托管运行程序参考”。

启用 GitHub Connect后,可以使用策略来限制企业存储库中可以使用哪些公共操作。 有关详细信息,请参阅“在企业中强制实施GitHub Actions策略”。

或者,如果您希望更严格地控制企业中允许执行哪些操作,或者不想允许与 GitHub.com 的出站连接,则可以使用 actions-sync 工具手动下载这些操作并将其同步到企业实例中。 有关详细信息,请参阅“从 GitHub.com 手动同步操作”。