了解 GitHub Actions

注： GitHub 托管的运行器目前在 GitHub Enterprise Server 上不受支持。您可以在 GitHub 公共路线图上查看有关未来支持计划的更多信息。

概览

GitHub Actions is a continuous integration and continuous delivery (CI/CD) platform that allows you to automate your build, test, and deployment pipeline. 您可以创建工作流程来构建和测试存储库的每个拉取请求，或将合并的拉取请求部署到生产环境。

GitHub Actions 不仅仅是 DevOps，还允许您在存储库中发生其他事件时运行工作流程。例如，您可以运行工作流程，以便在有人在您的存储库中创建新问题时自动添加相应的标签。

GitHub 提供 Linux、Windows 和 macOS 虚拟机来运行工作流程，或者您可以在自己的数据中心或云基础架构中托管自己的自托管运行器。

GitHub Actions 的组件

您可以将 GitHub Actions 工作流程配置为在存储库中发生事件时触发，例如打开拉取请求或创建议题。工作流程包含一个或多个作业，这些作业可以按顺序运行，也可以并行运行。每个作业都将在其自己的虚拟机运行器中运行，或者在容器内运行，并且具有一个或多个步骤，这些步骤要么运行您定义的脚本，要么运行操作，这是一个可重用的扩展，可以简化您的工作流程。

工作流程概述

工作流程

工作流程是一个可配置的自动化过程，它将运行一个或多个作业。工作流程由签入到存储库的 YAML 文件定义，并在存储库中的事件触发时运行，也可以手动触发，或按定义的时间表触发。

一个存储库中可以有多个工作流程，每个工作流程可以执行一组不同的步骤。例如，您可以有一个工作流程来构建和测试拉取请求，另一个工作流程用于在每次创建发布时部署应用程序，还有一个工作流程在每次有人打开新议题时添加标签。

有关工作流程的详细信息，请参阅“使用工作流程”。

事件

事件是存储库中触发工作流程运行的特定活动。例如，当有人创建拉取请求、打开议题或将提交推送到存储库时，活动可能源自 GitHub。您还可以通过发布到 REST API 或手动来触发按计划运行的工作流程。

有关可用于触发工作流程的事件的完整列表，请参阅触发工作流程的事件。

Jobs

作业是工作流程中的一组步骤，它们在同一运行器上执行。每个步骤要么是将要执行的 shell 脚本，要么是将运行的操作。步骤按顺序执行，并且相互依赖。由于每个步骤都在同一运行器上执行，因此您可以将数据从一个步骤共享到另一个步骤。例如，可以有一个生成应用程序的步骤，后跟一个测试已生成应用程序的步骤。

您可以配置作业与其他作业的依赖关系；默认情况下，作业没有依赖关系，并且彼此并行运行。当一个作业依赖于另一个作业时，它将等待从属作业完成，然后才能运行。例如，对于没有依赖关系的不同体系结构，您可能有多个生成作业，以及一个依赖于这些作业的打包作业。生成作业将并行运行，当它们全部成功完成后，打包作业将运行。

有关作业的详细信息，请参阅“使用作业”。

操作

操作是 GitHub Actions 平台的自定义应用程序，用于执行复杂但经常重复的任务。使用操作可帮助减少在工作流程文件中编写的重复代码量。操作可以从 GitHub 拉取 git 存储库，为您的构建环境设置正确的工具链，或设置对云提供商的身份验证。

您可以编写自己的操作，也可以在 GitHub Marketplace 中找到要在工作流程中使用的操作。

更多信息请参阅“创建操作”。

运行器

A runner is a server that runs your workflows when they're triggered. 每个运行器一次可以运行一个作业。您必须为 GitHub Enterprise Server 托管自己的运行器。有关的更多信息，请参阅“托管您自己的运行器”。

创建示例工作流程

GitHub Actions 使用 YAML 语法来定义工作流程。每个工作流程都作为单独的 YAML 文件存储在代码存储库中的目录 .github/workflows 下。

您可以在仓库中创建示例工作流程，只要推送代码，该工作流程就会自动触发一系列命令。在此工作流程中，GitHub Actions 检出推送的代码，安装软件依赖项，并运行 -v。

在您的仓库中，创建 .github/workflows/ 目录来存储工作流程文件。

在 .github/workflows/ 目录中，创建一个名为 learn-github-actions.yml 的新文件并添加以下代码。

name: learn-github-actions
on: [push]
jobs:
  check-bats-version:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v2
      - uses: actions/setup-node@v2
        with:
          node-version: '14'
      - run: npm install -g bats
      - run: bats -v

提交这些更改并将其推送到您的 GitHub 仓库。

您的新 GitHub Actions 工作流程文件现在安装在您的仓库中，每次有人推送更改到仓库时都会自动运行。有关作业的执行历史记录的详细信息，请参阅“查看工作流程的活动”。

了解工作流程文件

为帮助您了解如何使用 YAML 语法来创建工作流程文件，本节解释介绍示例的每一行：

`name: learn-github-actions`	可选 - 将出现在 GitHub 仓库的 Actions（操作）选项卡中的工作流程名称。
`on: [push]`	指定此工作流程的触发器。此示例使用`推送`事件，因此每次有人将更改推送到存储库或合并拉取请求时，都会触发工作流程运行。这是由推送到每个分支触发的；有关仅在推送到特定分支、路径或标记时运行的语法示例，请参阅“GitHub Actions 的工作流程语法”。
`jobs:`	将 `learn-github-actions` 工作流程中运行的所有作业组合在一起。
`check-bats-version:`	定义名为 `check-bats-version` 的作业。子键将定义作业的属性。
`runs-on: ubuntu-latest`	将作业配置为在最新版本的 Ubuntu Linux 运行器上运行。这意味着该作业将在 GitHub 托管的新虚拟机上执行。有关使用其他运行器的语法示例，请参阅“GitHub Actions 的工作流程语法”。
`steps:`	将 `check-bats-version` 作业中运行的所有步骤组合在一起。此部分下嵌套的每项都是一个单独的操作或 shell 脚本。
`- uses: actions/checkout@v2`	`uses` 关键字指定此步骤将运行 `actions/checkout` 操作的 `v2`。这是一个将存储库签出到运行器上的操作，允许您对代码（如生成和测试工具）运行脚本或其他操作。每当工作流程将针对存储库的代码运行时，都应使用签出操作。
`- uses: actions/setup-node@v2 with: node-version: '14'`	此步骤使用 `actions/setup-node@v2` 操作来安装指定版本的 Node.js（此示例使用 v14）。这会将 `node` 和 `npm` 命令放在 `PATH`中。
`- run: npm install -g bats`	`run` 关键字指示作业在运行器上执行命令。在这种情况下，使用 `npm` 来安装 `bats` 软件测试包。
`- run: bats -v`	最后，您将运行 `bats` 命令，并且带有输出软件版本的参数。