注意:GitHub Enterprise Server 目前不支持 GitHub 托管的运行器。 可以在 GitHub public roadmap 上查看有关未来支持计划的更多信息。
示例概述
本文使用示例工作流演示 GitHub Actions 的某些主要 CI 功能。 此工作流触发后,会自动运行一个脚本,用于检查 GitHub Docs 站点是否有任何损坏的链接。 如果找到任何损坏的链接,工作流将使用 GitHub CLI 创建包含详细信息的 GitHub 问题。
下图显示了工作流步骤的高级视图以及它们如何在作业中运行:
此示例中使用的功能
示例工作流演示了 GitHub Actions 的以下功能。
功能 | 实现 |
---|---|
定期运行工作流 | schedule |
示例工作流
GitHub Docs 工程团队创建了以下工作流。 若要查看 github/docs
存储库中此文件的最新版本,请参阅 check-all-english-links.yml
。
注意:此工作流的每一行将在下一部分“了解示例”中介绍。
|
了解示例
下表介绍了在创建 GitHub Actions 工作流时如何使用这些功能。
代码 | 解释 |
---|---|
|
将显示在 GitHub 存储库的“操作”选项卡中的工作流名称。 |
|
将
|
|
修改授予 |
|
将工作流文件中运行的所有作业组合在一起。 |
|
定义 ID 为 |
|
仅当存储库名为 |
|
配置作业在 Ubuntu Linux 运行器上运行。 这意味着作业将在 GitHub. 托管的新虚拟机上执行。 有关使用其他运行器的语法示例,请参阅“GitHub Actions 的工作流语法”。 |
|
创建自定义环境变量,并重新定义内置的 |
|
将作为 |
|
|
|
此步骤使用 |
|
|
|
此 |
|
如果 |
|
使用 |
|
使用 然后,使用 |
|
如果上一次运行中的问题已打开且已分配给某人,则使用 |
|
如果上一次运行中的问题已打开但未分配给任何人,则:
|
后续步骤
- 若要了解 GitHub Actions 概念,请参阅“了解 GitHub Actions”。
- 有关创建基本工作流的分步指南,请参阅“GitHub Actions 快速入门”。
- 如果你熟悉 GitHub Actions 的基础知识,可以在“关于工作流程”中了解工作流及其功能。