Phần 4 — Matrix builds, Caching và Artifacts

Series GitHub Actions Toàn Tập — 8 phần:

1. Phần 1 — Tổng quan: CI/CD, GitHub Actions và các khái niệm cốt lõi

2. Phần 2 — Workflow YAML đầu tiên và Triggers nâng cao

3. Phần 3 — Secrets, Variables và Environment protection

4. Phần 4 — Matrix builds, Caching và Artifacts ← bạn đang đọc

5. Phần 5 — Self-hosted Runner: cài đặt, security, auto-scaling

6. Phần 6 — Reusable Workflows và Composite Actions

7. Phần 7 — Pipeline thực tế: Next.js + Docker + VPS deploy

8. Phần 8 — Best practices, Debug và OIDC hardening

Mở đầu

Pipeline chậm = trải nghiệm dev tệ. Phần này gộp ba kỹ thuật bắt buộc phải biết: matrix builds để chạy song song nhiều combination (OS × ngôn ngữ × version), cache để tận dụng lại artifact giữa các pipeline run (đặc biệt node_modules và Docker layer), và artifacts để truyền file giữa các job trong cùng pipeline mà không cần build lại.

1. Matrix — Build nhiều version một lúc

Muốn test code trên nhiều Node version cùng lúc:

jobs:
  test:
    runs-on: ${{ matrix.os }}
    strategy:
      fail-fast: false
      matrix:
        os: [ubuntu-latest, macos-latest, windows-latest]
        node: [18, 20, 22]
        exclude:
          - os: windows-latest
            node: 18
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with:
          node-version: ${{ matrix.node }}
      - run: npm ci && npm test

Workflow trên tạo 8 job song song (3 OS × 3 Node − 1 exclude). fail-fast: false cho phép các job khác chạy tiếp khi một job fail — cần thiết để debug đầy đủ.

2. Caching và Artifacts

2.1. Cache

Cache giúp tái sử dụng data giữa các lần chạy workflow (vd: node_modules, ~/.gradle, Docker layers). Với npm/yarn/pnpm, action setup-node đã bật cache sẵn:

- uses: actions/setup-node@v4
  with:
    node-version: '20'
    cache: 'pnpm'  # hoặc 'npm', 'yarn'

Trường hợp tự cache:

- uses: actions/cache@v4
  with:
    path: |
      ~/.cache/pip
      .venv
    key: ${{ runner.os }}-pip-${{ hashFiles('**/requirements.txt') }}
    restore-keys: |
      ${{ runner.os }}-pip-

2.2. Artifacts

Artifact là file/folder bạn muốn lưu lại sau khi job kết thúc — để job khác dùng, hoặc để download về máy.

jobs:
  build:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: npm ci && npm run build
      - uses: actions/upload-artifact@v4
        with:
          name: build-output
          path: dist/
          retention-days: 7

  deploy:
    runs-on: ubuntu-latest
    needs: build
    steps:
      - uses: actions/download-artifact@v4
        with:
          name: build-output
          path: dist/
      - run: ./deploy.sh dist/

Job deploy nhận lại đúng folder dist/ từ job build — không cần build lại.

Tóm tắt

Trong phần này bạn đã nắm:

• Matrix sinh job song song theo cartesian product; exclude để bỏ combo không cần; fail-fast: false để job khác chạy tiếp khi 1 job fail.

• Cache built-in qua actions/setup-node với cache: pnpm/npm/yarn; tự cache qua actions/cache@v4 với key + restore-keys dùng hashFiles().

• Artifacts: upload qua actions/upload-artifact@v4, download qua actions/download-artifact@v4 — truyền data giữa job build và deploy.

• Đặt retention-days cho artifact để tránh tốn storage; mặc định 90 ngày là quá dài cho hầu hết use case.

Trong Phần 5, ta đi vào chủ đề được hỏi nhiều nhất: cài self-hosted runner trên server riêng — từ chuẩn bị máy, cài service, đến quy tắc bảo mật bắt buộc khi vận hành.

Phần 5: Self-hosted Runner: cài đặt, security, auto-scaling →