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

关于 GitHub 操作

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

GitHub 操作 目前为有限公测期,可能会有变动。 在公测期间,强烈建议不要将此功能用于高价值工作流程和内容。

有关使用 GitHub 操作 的更多信息,请参阅“使用 GitHub 操作 自动化工作流程”。

本文内容

关于 GitHub 操作

GitHub 操作 可让您灵活地构建自动化的软件部署生命周期工作流程。您可以编写个别任务、调用的操作,以及结合它们创建自定义工作流程。 工作流程是您可以在仓库中创建的自定义自动化流程,用于在 GitHub 上构建、测试、封装、发行或部署任何代码项目。

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

工作流程在 GitHub 托管的服务器上的 Linux、macOS、Windows 和容器中运行。 您可以使用仓库中定义的操作、GitHub 上公共仓库中的开源操作或者发布的 Docker 容器图像来创建工作流程。 复刻仓库中的工作流程默认不运行。

您可以在 GitHub 上发现要用于工作流程的操作,以及创建要与 GitHub 社区共享的操作。 有关创建自定义操作的更多信息,请参阅“创建操作”。

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

For a definition of common terms, see "Core concepts for GitHub 操作."

工作流程运行通知

If you enable email or web notifications for GitHub 操作, you'll receive a notification when any workflow runs that you've triggered have completed. The notification will include the workflow run's status (including successful, failed, neutral, and canceled runs). You can also choose to receive a notification only when a workflow run has failed.

You can also see the status of workflow runs on a repository's Actions tab. 更多信息请参阅“管理工作流程运行”。

发现 GitHub 社区中的操作

您可以使用 GitHub 上公共仓库中共享的开源操作自定义项目。 您可以找到并使用 GitHub in the github.com/actions 组织创建的操作。

将 GitHub 操作 从 HCL 迁移到 YAML 语法

GitHub 不再支持 GitHub 操作 中的 HCL 语法。

如果您参加有限公测并使用 HCL 语法创建了工作流程,便已经获得对使用 YAML 语法的新有限公测版的访问权。

您需要迁移使用 HCL 语法的工作流程文件以使用新的 YAML 语法。 有关 YAML 语法以及 GitHub 操作 其他更改的详细信息,请参阅“GitHub 操作 的工作流程语法”和“关于 GitHub 操作”。

您还需要确保为构建的任何操作创建元数据文件。 更多信息请参阅“GitHub 操作 的 Metadata 语法"和"关于操作”。

使用限制

超过使用限制可能导致作业排队、无法运行或无法完成。 限制可能会有变动。

  • 每个仓库可以同时执行最多 20 个工作流程。

  • 一个仓库中所有操作在一小时内最多可以执行 1000 条 API 请求。

  • 工作流程中每项作业的最长执行时间为 6 小时。

  • 可在帐户所有仓库中同时运行的作业数量取决于您的 GitHub 计划。

    GitHub 计划 同时运行的作业总数 MacOS 作业同时运行的最大数量
    免费 20 5
    Pro 40 5
    团队 60 5
    企业 180 15

此外,GitHub 操作 不可用于:

  • 非法或者我们的服务条款社区指导方针禁止的内容或活动。
  • 密码破解
  • 无服务器计算
  • 威胁 GitHub 用户或 GitHub 服务的活动。
  • 与其中使用 GitHub 操作 的仓库相关软件项目的创建、测试、部署或发布无关的任何其他活动。 换句话说,酷一点,不要以您知道不该采取的方式来使用 GitHub 操作。

为防止违反这些限制和滥用 GitHub 操作,GitHub 得监控您对 GitHub 操作 的使用。 GitHub 操作 的误用可能导致作业终止,或者限制您使用 GitHub 操作 的能力。

申请加入 GitHub 操作 的有限公测版

GitHub 操作 目前为有限公测期,可能会有变动。 在公测期间,强烈建议不要将此功能用于高价值工作流程和内容。

如果您目前未参加有限公测,可到 GitHub 操作 页面申请加入有限公测

联系支持

If you need help with anything related to workflow configuration, such as syntax, virtual environments, or building actions, look for an existing topic or start a new one in the GitHub 社区论坛's GitHub 操作 board.

If you have feedback or feature requests for GitHub 操作, share those in the GitHub 操作的反馈表.

Contact GitHub 支持GitHub 高级支持 for any of the following, whether your use or intended use falls into the usage limit categories:

  • If you believe your account has been incorrectly restricted
  • If you encounter an unexpected error when executing one of your Actions, for example: a unique ID
  • If you encounter a situation where existing behavior contradicts expected, but not always documented, behavior

如果您目前未参加有限公测,可到 GitHub 操作 页面申请加入有限公测

GitHub 支持 将只支持 YAML 语法,而不再支持 HCL 语法。

延伸阅读

问问别人

找不到要找的内容?

联系我们