适用于多环境的矩阵构建

欢迎了解 GitHub 操作中的一项强大功能：矩阵构建！想象一下，您需要在许多不同的环境中测试代码，例如各种操作系统或编程语言版本。

您不必为每种组合创建单独的工作流程，矩阵构建允许您定义一组变量，而 GitHub 操作会自动为这些变量的每种可能组合运行作业。

矩阵构建对于以下情况非常有用：

• 跨平台测试：确保您的应用程序能够在 Windows、macOS 和 Linux 上运行。
• 多版本兼容性：针对不同版本的 Node.js、Python 或数据库进行测试。
• 并行执行：同时运行所有这些测试，节省大量时间。

它们可以帮助您高效地实现更广泛的测试覆盖率。

您可以在作业的 strategy 部分定义矩阵。在 strategy.matrix 中，列出一个或多个变量，并为每个变量指定一个值数组。

GitHub 操作随后会为每种组合创建一个作业。下面来看看它的样子：

在前面的代码片段中，我们为 node-version 变量定义了三个值：14、16 和 18。

这个单一的作业定义会触发三个独立作业，每个作业都在 ubuntu-latest 上运行，但使用不同的 Node.js 版本。这样可以确保您的项目能够兼容这些版本。

您不受限于只有一个变量！您可以在矩阵中组合多个变量。例如，您可能希望在不同操作系统上使用不同的 Node.js 版本进行测试。

只需在 strategy.matrix 下添加更多键值对即可。作业总数等于每个变量的值数量的乘积。

下面介绍如何设置一个矩阵，在 Ubuntu 和 Windows 上使用 Node.js 16 和 18 进行测试。

这将创建 2（OS）* 2（Node.js 版本）= 4 个独立作业。

有时，默认的笛卡尔积无法覆盖您需要的特定组合，或者您希望为某些构建添加额外变量。您可以使用 include 添加新的矩阵条目。

例如，您可能希望仅在 Ubuntu 上使用 Node.js 14 运行一次额外测试，或者向某个特定的操作系统/版本组合传递一个环境变量。

如果某个组合已知会失败，或者与您的项目无关，该怎么办？exclude 关键字允许您从矩阵中移除特定配置。

这样可以避免不必要的作业运行，并专注于相关的测试用例。

在作业步骤中，您可以使用 ${{ matrix.variable_name }} 语法访问当前矩阵变量的值。这对于配置工具或运行针对每种矩阵组合的命令至关重要。

例如，${{ matrix.os }} 会动态设置运行器的操作系统，而 ${{ matrix.node-version }} 会配置 Node.js 设置操作。

矩阵构建适用于以下场景：

• 库开发：针对依赖项的多个版本进行测试。
• 多语言项目：构建或测试使用不同语言或编译器编写的组件。
• 浏览器兼容性：如果使用支持此功能的工具，可以在不同浏览器中测试 Web 应用程序。

它们将复杂的测试场景简化为简洁且易于维护的工作流程。

请考虑一个使用矩阵策略的 GitHub 操作工作流程。矩阵定义如下：

strategy:
  matrix:
    os: [ubuntu-latest, macos-latest]
    python-version: [3.8, 3.9]
    exclude:
      - os: macos-latest
        python-version: 3.8

此矩阵配置会创建多少个作业？

做得很好！您已经了解了 GitHub 操作的矩阵构建。

• 它们允许您针对变量的多个组合运行作业（OS、语言版本等）。
• 在作业中使用 strategy.matrix 定义。
• include 用于添加特定组合，而 exclude 用于移除组合。
• 通过 ${{ matrix.variable_name }} 访问变量。

矩阵构建对于在各种环境中高效、全面地进行测试至关重要。请继续练习，掌握这项技术！