原文地址：Building and Monitoring Your First Github Actions Workflow

原文作者：Meercode

译文出自：掘金翻译计划

本文永久链接：github.com/xitu/gold-m…

译者：zncqhn

校对者：plusmultiply0、HurryOwen

Github Actions 工作流的创建管理

Github Actions 是 Github 对 CI/CD 的原生解决方案，自 2019 年推出以来，它就可供社区开发者使用。Action 简单、灵活和低成本等特性使许多团队从现有的 CI/CD 解决方案中迁移过来，并且探索新平台的无限可能。

我的团队是 Github Actions 的早期使用者。作为一群大量使用 Javascript 的开发人员，我们能够自动化处理前端和后端项目的数十条工作流。由于平台支持 Javascript/Typescript，我们创建了大量 Actions（就像传统构建工具中的插件），以便根据我们的需要扩展功能。

在使用 Github Actions 一年之后，我们发现该工具与之前测试的 CI/CD 解决方案相比具有以下优势：

零管理成本（不需要任何代理或主节点）。
容易学习和掌握。
可以在源代码中保留工作流。
丰富的 Action（插件）库，易于开发自定义 Action。
合理的定价模式：为私有存储库的高级用户提供 3000 分钟的免费时间。公共存储库是完全免费的！
它有一个丰富的 action 库，很容易开发自定义 Action。
支持 Linux、Windows 和 macOS 平台。（支持 macOS 在竞争对手中是罕见的）。
借助自托管运行工具，可以在自己的设备上运行免费版本。

该平台的一个小瑕疵是缺少可以跟踪工作流状态的监控工具。随着我们必须管理的项目库和工作流数量的增加，问题变得更棘手。最后，我们决定开发自己的仪表盘作为解决方案。

借助 React 前端和 NestJS 后端，使用相关的 Github API 并以简洁的方式显示。这个工具在我们的团队成员中很受欢迎，我们会为其继续开发新的功能。

最近，我们将仪表盘工具作为 SaaS 项目发布，然后启动一个公开的测试程序，并且分享在开发者社区。如果你感兴趣，你可以阅读 Meercode 的关于此博客文章的故事或访问 meercode.io 试用产品。

为了演示如何简单地在 Github Actions 上创建工作流，我们想展示一个真实的例子。

任务很简单，对于 Github 上的一个项目库，我们需要 AppCenter 在发出 pull request 时触发构建。幸运的是，AppCenter 有一个公开的 REST API，可以用来启动构建。

我们要创建的操作应该在以下场景触发：

pull request 被打开或重新打开。
通过了单元测试。

如果满足所有条件，我们将在 AppCenter 上开始构建。下面开始创造我们的 action。

从 GitHub 上的存储库中，在 .github/workflows 目录中创建一个名为 app_center_pull_request.yml. 的文件。

通过使用 “name:” 属性，我们将 action 命名为 “Pull Request Opened [App]”。

为了在 pull request 时触发我们的 action，我们将使用原生 Github 工作流事件。当然，也可以使用 “on:” 语法将工作流配置为针对一个或多个事件运行。还可以把 action 中可以使用的工作流事件完整列表记录在参考页。

接下来我们将说明，当触发 pull_request 事件时，action 要做什么

在 “jobs:” 属性下，我们可以添加任意数量的要运行的作业。我们用 “build:” 属性标记第一个作业，并按上面所示进行配置。

“runs-on:” 和 “matrix:” 属性指定 action 将运行的环境。“steps:” 定义了同时运行的步骤：

第一步，从 Action 仓库（Actions Marketplace）调取其它 action 检索 “pull request name” 以便下一步使用。
第二步，我们将初始化应用程序并运行测试。如果测试运行成功，则继续下一步 action。
接着使用 curl 命令调用 AppCenter API，为相应的分支名称配置构建。我们使用第一步中的分支名称来构建相应的 URI。
最后，我们为 iOS 和 Android 版本触发构建：

要运行和测试工作流，只需打开一个 pull request。这将自动触发并运行 action。要查看结果，则可以转到项目库的 “Actions” 选项卡，选择相应的工作流并运行。

如果想更深入地使用 Github Actions 或者需要在多个项目库中管理大量工作流，那么可以随时尝试之前提到过的仪表盘解决方案 Meercode。

如果发现译文存在错误或其他需要改进的地方，欢迎到掘金翻译计划对译文进行修改并 PR，也可获得相应奖励积分。文章开头的 本文永久链接 即为本文在 GitHub 上的 MarkDown 链接。

掘金翻译计划是一个翻译优质互联网技术文章的社区，文章来源为掘金上的英文分享文章。内容覆盖 Android、iOS、前端、后端、区块链、产品、设计、人工智能等领域，想要查看更多优质译文请持续关注掘金翻译计划、官方微博、知乎专栏。