我们经常发布文档更新,此页面的翻译可能仍在进行中。有关最新信息,请访问英文文档。如果此页面上的翻译有问题,请告诉我们

关于 GitHub 操作

GitHub 操作 可让您直接在 GitHub 仓库中创建自定义软件开发生命周期 (SDLC) 工作流程。

GitHub 操作 可用于 GitHub Free、GitHub Pro、组织的 GitHub Free、GitHub Team、GitHub Enterprise Cloud 和 GitHub One。 GitHub 操作 不适用于使用旧版按仓库计划的帐户所拥有的私有仓库。 更多信息请参阅“GitHub 的产品”。

本文内容

关于 GitHub 操作

GitHub 操作 帮助您在您存储代码的同一位置自动执行软件开发工作流程,并协作处理拉取请求和议题。 您可以写入个别任务,称为操作,并结合它们创建一个自定义的工作流程。 工作流程是您可以在仓库中创建的自定义自动化流程,用于在 GitHub 上构建、测试、封装、发行或部署任何代码项目。

通过 GitHub 操作 可直接在仓库中构建端到端持续集成 (CI) 和持续部署 (CD) 功能。 GitHub 操作 支持 GitHub 的内置持续集成服务。 更多信息请参阅“关于持续集成”。

工作流程在 GitHub 托管的计算机(称为“运行器”)上的 Linux、macOS、Windows 和容器中运行。 或者,您也可以托管自己的运行器,以在您拥有或管理的计算机上运行工作流程。 更多信息请参阅“关于自托管运行器”。

您可以使用仓库中定义的操作、GitHub 上公共仓库中的开源操作或者发布的 Docker 容器镜像来创建工作流程。 复刻仓库中的工作流程默认不运行。

您可以在 GitHub 上发现要用于工作流程的操作,以及创建要与 GitHub 社区共享的操作。 For more information on creating a custom action, see "Creating actions."

您可以创建配置为对特定事件运行的工作流程文件。 更多信息请参阅“配置工作流程”和“GitHub 操作 的工作流程语法”。

有关常用术语的定义,请参阅“GitHub 操作 的核心概念”。

发现 GitHub 社区中的操作

GitHub Marketplace 是一个中心位置,您可以查找、分享和使用由 GitHub 社区构建的操作。 更多信息请参阅“在工作流程中使用 GitHub Marketplace 中的操作”。

您也可以使用 GitHub 的公共仓库中分享的开源操作自定义项目,以及使用 actions 组织中 GitHub 构建的操作。

禁用或限制仓库或组织的 GitHub 操作

默认情况下,GitHub 操作 在所有仓库上启用。 您可以选择禁用 GitHub 操作 或限制使用公共操作。 当您限制使用公共操作时,别人只能使用您仓库或组织中存在的本地操作。

更多信息请参阅“禁用或限制仓库的 GitHub 操作”或“禁用或限制组织的 GitHub 操作”。

工作流程运行通知

如果为 GitHub 操作 启用电子邮件或 web 通知,则在触发的任何工作流程运行完成时,您将收到通知。 通知将包括工作流程运行的状态(包括成功、失败、中立和取消的运行)。 您也可以选择仅在工作流程运行失败时接收通知。

您也可以在仓库的 Actions(操作)选项卡上查看工作流程的状态。 更多信息请参阅“管理工作流程运行”。

使用限制

GitHub 操作 的使用受到一些不同限制,具体取决于您使用的是 GitHub 托管的运行器还是自托管的运行器。 这些限制可能会有变动。

  • 作业执行时间 - 工作流程中的每个作业最多可以运行 6 个小时。 如果作业达到此限制,该作业将会终止而无法完成。 此限制不适用于自托管运行器。

  • 工作流程运行时间 - 每个工作流程的运行时限为 72 小时。 如果工作流程运行时间达到此限制,其运行将被取消。 此限制也适用于自托管运行器。

  • 作业排队时间 - 自托管运行器的每个作业最多可排队 24 小时。 如果自托管运行器在此限制内没有开始执行作业,则作业将被终止,并且无法完成。 此限制不适用于 GitHub 托管的运行器。

  • API 请求 - 在一个仓库的所有操作中,一个小时内最多可执行 1000 个 API 请求。 如果超出,额外的 API 调用将失败,这可能导致作业失败。 此限制也适用于自托管运行器。

  • 并发作业 - 您的帐户中可并发运行的作业数量,具体取决于您的 GitHub 计划,如下表所示。 如果超出,任何额外的作业都会排队。 对于自托管运行器没有并发限制。

    GitHub 计划同时运行的作业总数MacOS 作业同时运行的最大数量
    免费205
    Pro405
    团队605
    企业18050
  • 作业矩阵 - 作业矩阵在每次工作流程运行时最多可生成 256 个作业。 此限制也适用于自托管运行器。

使用策略

除了使用限制外,还必须确保使用 GitHub 服务条款 中的 GitHub 操作。 有关 GitHub 操作 特定条款的更多信息,请参阅 GitHub 附加产品条款

关于 GitHub 操作 的计费

公共仓库免费使用 GitHub 操作。 对于私有仓库,每个 GitHub 帐户可获得一定数量的免费记录和存储,具体取决于帐户所使用的产品。 更多信息请参阅“关于 GitHub 操作 的计费”。

联系支持

如果需要任何与工作流程配置相关的帮助,比如语法、GitHub 托管的运行器或构建操作,请在 GitHub Community Support 的 GitHub 操作 版面中查找现有主题或发起一个新主题。

如果您有对 GitHub 操作 的反馈或功能请求,请在 GitHub 操作的反馈表 中分享。

如有以下任意情况,无论您的使用或预期使用是否属于使用限制类别,都请联系 GitHub 支持GitHub 高级支持

  • 如果您认为您的帐户受到不正确的限制
  • 如果您在执行您的操作之一时遇到意外错误,例如:唯一的 ID
  • 如果你遇到与预期矛盾现有行为,但不一定是文件记录的情况。

延伸阅读

问问别人

找不到要找的内容?

联系我们