Матричные сборки для нескольких сред

Добро пожаловать к изучению мощной возможности GitHub Actions — матричных сборок! Представьте, что Вам нужно протестировать код в разных средах, например в различных операционных системах или версиях языков программирования.

Вместо создания отдельного рабочего процесса для каждой комбинации матричные сборки позволяют определить набор переменных, а GitHub Actions автоматически запустит задания для каждой возможной комбинации этих переменных.

Матричные сборки невероятно полезны для следующих задач:

• Кроссплатформенное тестирование: проверка работы приложения в Windows, macOS и Linux.
• Совместимость с несколькими версиями: тестирование с разными версиями Node.js, Python или базы данных.
• Параллельное выполнение: одновременный запуск всех этих тестов, что значительно экономит время.

Они помогают эффективно обеспечить более полное покрытие тестами.

Матрица определяется в разделе strategy задания. Внутри strategy.matrix перечислите одну или несколько переменных, каждая из которых содержит массив значений.

Затем GitHub Actions создаёт задание для каждой комбинации. Посмотрим, как это выглядит:

В предыдущем фрагменте мы определили переменную 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.

Матричные сборки полезны в следующих случаях:

• Разработка библиотек: тестирование с несколькими версиями зависимости.
• Многоязычные проекты: сборка и тестирование компонентов, написанных на разных языках или рассчитанных на разные компиляторы.
• Совместимость с браузерами: тестирование веб-приложений в разных браузерах, если используемый инструмент это поддерживает.

Они упрощают сложные сценарии тестирования, превращая их в компактные рабочие процессы, удобные для сопровождения.

Рассмотрим рабочий процесс GitHub Actions, использующий стратегию матрицы. Матрица определена следующим образом:

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

Сколько заданий будет создано этой конфигурацией матрицы?

Отличная работа! Вы изучили матричные сборки в GitHub Actions.

• Они позволяют запускать задания для нескольких комбинаций переменных: ОС, версий языков и других параметров.
• Определяются с помощью strategy.matrix внутри задания.
• include добавляет определенные комбинации, а exclude удаляет их.
• Доступ к переменным осуществляется через ${{ matrix.variable_name }}.

Матричные сборки необходимы для эффективного и комплексного тестирования в разнообразных средах. Продолжайте практиковаться, чтобы освоить их в совершенстве!