Matrix Strategy Patterns

Matrix Strategy Patterns

Status: ✅ Stable Summary: Choose a matrix that matches support policy: dual-bitness, multi-version, nightly schedules.

Patterns

Pattern	When to Use	Pros	Trade-offs
Single-version dual-bitness	Toolkits for x86 and x64	One .vip, decent coverage	Packaging step longer
Multi-version single-bitness	Validate across 2021/2023	Cross-version assurance	Longer wall time
Multi-version dual-bitness	Broad coverage	Max assurance	Highest runtime
Nightly matrix	Heavy builds/tests	Keep PR fast	Needs infra capacity

YAML Sketch (dual-bitness)

strategy:
  matrix:
    bitness: [32, 64]
steps:
  - uses: .../build-lvlibp@v1
    with:
      supported_bitness: ${{ matrix.bitness }}

YAML Sketch (multi-version dual-bitness)

strategy:
  matrix:
    lv: [2021, 2023]
    bitness: [32, 64]
steps:
  - uses: .../run-unit-tests@v1
    with:
      minimum_supported_lv_version: ${{ matrix.lv }}
      supported_bitness: ${{ matrix.bitness }}

Nightly Schedule

on:
  schedule:
    - cron: "0 3 * * *"

See also: Workflow Semantics & Reusable Actions

↑ Back to top