18. Job Matrix

Matrix

Matrix คืออะไร?
Matrix ใน GitHub Actions เป็นฟีเจอร์ที่ช่วยให้เราสามารถรัน job เดียวกันหลายครั้งด้วยค่าตัวแปรที่แตกต่างกัน เหมือนกับการสร้าง “ตาราง” ของการทดสอบที่ครอบคลุมหลายๆสถานการณ์

ทำให้เราเขียน Workflow ครั้งเดียว แล้วสามารถรัน workflow ได้หลายครั้งด้วยค่าตัวแปรที่แตกต่างกัน เช่นเราอยาก build app สำหรับ Linux, Mac และ Windows เราก็จะเขียน Workflow ครั้งเดียว แล้วกำหนด Matrix ให้มี Linux, Mac และ Windows
ทำให้ Workflow จะทำงาน 3 ครั้ง แบบขนานกัน แบ่งเป็น

Linux
Mac
Windows

ตัวอย่างการใช้งาน

ทดสอบหลาย Environment (Node.js versions, OS, browsers)
Build หลาย Configuration (development, staging, production)
Deploy ไปหลาย Target (different regions, environments)
ประหยัดเวลา - รันแบบ parallel แทนการเขียน job แยก

ตัวอย่างการใช้งาน Matrix กับ React CSR (Vite)

1
name: React CI/CD
2

3
on:
4
  push:
5
    branches: [main, develop]
6
  pull_request:
7
    branches: [main]
8

9
jobs:
10
  test:
11
    runs-on: ${{ matrix.os }}
12
    strategy:
13
      matrix:
14
        # ทดสอบหลาย OS และ Node version
15
        os: [ubuntu-latest, windows-latest, macos-latest]
16
        node-version: [18, 20, 21]
17
        # ทดสอบหลาย browser (สำหรับ e2e testing)
18
        browser: [chrome, firefox, safari]
19
        exclude:
20
          # Safari ใช้ได้แค่บน macOS
21
          - os: ubuntu-latest
22
            browser: safari
23
          - os: windows-latest
24
            browser: safari
25
        include:
26
          # เพิ่ม configuration พิเศษ
27
          - os: ubuntu-latest
28
            node-version: 20
29
            browser: chrome
30
            coverage: true
31

32
    steps:
33
      - uses: actions/checkout@v4
34

35
      - name: Setup Node.js ${{ matrix.node-version }}
36
        uses: actions/setup-node@v4
37
        with:
38
          node-version: ${{ matrix.node-version }}
39
          cache: "npm"
40

41
      - name: Install dependencies
42
        run: npm ci
43

44
      - name: Run tests
45
        run: npm test
46
        env:
47
          BROWSER: ${{ matrix.browser }}
48

49
      - name: Run coverage (if enabled)
50
        if: matrix.coverage
51
        run: npm run test:coverage
52

53
      - name: Build for ${{ matrix.os }}
54
        run: npm run build
55
        env:
56
          NODE_ENV: production
57

58
  build-and-deploy:
59
    needs: test
60
    runs-on: ubuntu-latest
61
    strategy:
62
      matrix:
63
        environment: [staging, production]
64
        include:
65
          - environment: staging
66
            api_url: https://api-staging.example.com
67
            deploy_target: staging-bucket
68
          - environment: production
69
            api_url: https://api.example.com
70
            deploy_target: prod-bucket
71

72
    steps:
73
      - uses: actions/checkout@v4
74

75
      - name: Setup Node.js
76
        uses: actions/setup-node@v4
77
        with:
78
          node-version: 20
79
          cache: "npm"
80

81
      - name: Install dependencies
82
        run: npm ci
83

84
      - name: Build for ${{ matrix.environment }}
85
        run: npm run build
86
        env:
87
          VITE_API_URL: ${{ matrix.api_url }}
88
          VITE_ENV: ${{ matrix.environment }}
89

90
      - name: Deploy to ${{ matrix.deploy_target }}
91
        run: |
92
          echo "Deploying to ${{ matrix.environment }}"
93
          # AWS S3 deployment example
94
          aws s3 sync dist/ s3://${{ matrix.deploy_target }}

ตัวอย่างการใช้ Matrix กับ Elysia

เป็นตัวอย่างง่ายๆนะ
เราจะ build Elysia โดยการใช้ Bun versions ต่างๆ เพื่อให้เห็นภาพการใช้งาน Matrix เท่านั้นนะ

1
name: ElysiaJS CI - Bun Versions
2

3
on:
4
  push:
5
    branches: [main, develop]
6
  pull_request:
7
    branches: [main]
8

9
jobs:
10
  test:
11
    runs-on: ${{ matrix.os }}
12
    strategy:
13
      matrix:
14
        # ทดสอบหลาย Bun version
15
        bun-version: ["1.0.0", "1.0.15", "1.0.25", "latest", "canary"]
16
        # ทดสอบหลาย OS
17
        os: [ubuntu-latest, macos-latest, windows-latest]
18
        exclude:
19
          # Canary อาจไม่เสถียรบน Windows
20
          - os: windows-latest
21
            bun-version: canary
22

23
    steps:
24
      - uses: actions/checkout@v4
25

26
      - name: Setup Bun ${{ matrix.bun-version }}
27
        uses: oven-sh/setup-bun@v1
28
        with:
29
          bun-version: ${{ matrix.bun-version }}
30

31
      - name: Show Bun version
32
        run: bun --version
33

34
      - name: Install dependencies
35
        run: bun install
36

37
      - name: Run tests
38
        run: bun test
39
        env:
40
          NODE_ENV: test
41

42
      - name: Build project
43
        run: bun run build