Compilaciones matriciales para varios entornos

¡Le damos la bienvenida a una potente función de GitHub Actions: las compilaciones en matriz! Imagine que necesita probar su código en muchos entornos diferentes, como varios sistemas operativos o versiones de un lenguaje de programación.

En lugar de crear un flujo de trabajo independiente para cada combinación, las compilaciones en matriz le permiten definir un conjunto de variables, y GitHub Actions ejecutará automáticamente sus trabajos para cada combinación posible de esas variables.

Las compilaciones en matriz son muy útiles para:

• Pruebas multiplataforma: garantizar que su aplicación funcione en Windows, macOS y Linux.
• Compatibilidad con varias versiones: probar con diferentes versiones de Node.js, Python o su base de datos.
• Ejecución en paralelo: ejecutar todas estas pruebas simultáneamente y ahorrar mucho tiempo.

Le ayudan a lograr una mayor cobertura de pruebas de forma eficiente.

Se define una matriz dentro de la sección strategy de un trabajo. Dentro de strategy.matrix, se enumeran una o más variables, cada una con una matriz de valores.

Después, GitHub Actions crea un trabajo para cada combinación. Veamos cómo se representa:

En el fragmento anterior, definimos una variable node-version con tres valores: 14, 16 y 18.

Esta definición de un solo trabajo activará tres trabajos independientes, cada uno ejecutándose en ubuntu-latest, pero utilizando una versión diferente de Node.js. Esto garantiza que su proyecto funcione en todas estas versiones.

¡No está limitado a una sola variable! Puede combinar varias variables en su matriz. Por ejemplo, puede que quiera probar diferentes sistemas operativos con distintas versiones de Node.js.

Solo tiene que añadir más pares clave-valor en strategy.matrix. El número total de trabajos será el producto del número de valores de cada variable.

Esta es la forma de configurar una matriz para realizar pruebas tanto en Ubuntu como en Windows, con las versiones 16 y 18 de Node.js.

Esto creará 2 (sistemas operativos) * 2 (versiones de Node.js) = 4 trabajos independientes.

A veces necesita combinaciones específicas que no están incluidas en el producto cartesiano predeterminado, o quiere añadir variables adicionales para determinadas compilaciones. Use include para añadir nuevas entradas a la matriz.

Por ejemplo, puede que quiera ejecutar una prueba adicional solo en Ubuntu con Node.js 14, o pasar una variable de entorno específica a una combinación determinada de sistema operativo y versión.

¿Qué ocurre si tiene una combinación que se sabe que falla o que no es relevante para su proyecto? La palabra clave exclude le permite eliminar configuraciones específicas de su matriz.

Esto le ayuda a evitar ejecuciones de trabajos innecesarias y a centrarse en los casos de prueba relevantes.

Dentro de los pasos de su trabajo, puede acceder a los valores actuales de las variables de la matriz mediante la sintaxis ${{ matrix.variable_name }}. Esto es fundamental para configurar herramientas o ejecutar comandos específicos para cada combinación de la matriz.

Por ejemplo, ${{ matrix.os }} establece dinámicamente el sistema operativo del ejecutor, y ${{ matrix.node-version }} configura la acción de instalación de Node.js.

Las compilaciones en matriz son muy útiles para:

• Desarrollo de bibliotecas: realizar pruebas con varias versiones de una dependencia.
• Proyectos multilingües: compilar y probar componentes escritos en diferentes lenguajes o compiladores.
• Compatibilidad entre navegadores: si utiliza una herramienta que lo admite, probar aplicaciones web en diferentes navegadores.

Permiten simplificar escenarios de prueba complejos y convertirlos en flujos de trabajo concisos y fáciles de mantener.

Considere un flujo de trabajo de GitHub Actions que utiliza una estrategia de matriz. La matriz se define de la siguiente manera:

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

¿Cuántos trabajos creará esta configuración de matriz?

¡Excelente trabajo! Ha aprendido sobre las compilaciones en matriz de GitHub Actions.

• Le permiten ejecutar trabajos para varias combinaciones de variables (sistemas operativos, versiones de lenguajes, etc.).
• Se definen mediante strategy.matrix dentro de un trabajo.
• include añade combinaciones específicas, mientras que exclude las elimina.
• Se accede a las variables mediante ${{ matrix.variable_name }}.

Las compilaciones en matriz son esenciales para realizar pruebas eficientes y exhaustivas en diversos entornos. ¡Siga practicando para dominarlas!