Thiết kế CI/CD Pipeline: Từ Push đến Production trong chưa đầy 10 phút

Một pipeline CI/CD thực thụ không chỉ đơn thuần là "chạy test trước khi deploy". Một quy trình thực sự mạnh mẽ cần thực hiện các nhiệm vụ sau:

1. Thẩm định chất lượng code (lint, kiểm tra kiểu dữ liệu, chạy test).
2. Xây dựng các artifact (build artifacts).
3. Tự động triển khai lên môi trường Staging.
4. Kiểm soát việc lên Production thông qua cơ chế phê duyệt hoặc lịch trình.
5. Tự động hoàn tác (rollback) khi gặp lỗi.

Dưới đây là cách để xây dựng một pipeline như vậy sử dụng GitHub Actions.

Pipeline cơ bản

Để bắt đầu, chúng ta cần định nghĩa một workflow đơn giản trong tệp .github/workflows/ci.yml. Workflow này sẽ được kích hoạt khi có code push lên nhánh chính hoặc có Pull Request.

# .github/workflows/ci.yml
name: CI

on:
  push:
    branches: [main, develop]
  pull_request:
    branches: [main]

jobs:
  validate:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4

      - uses: actions/setup-node@v4
        with:
          node-version: '20'
          cache: 'npm'

      - run: npm ci

      - name: Kiểm tra kiểu dữ liệu (Type check)
        run: npx tsc --noEmit

      - name: Kiểm tra code (Lint)
        run: npm run lint

      - name: Chạy test
        run: npm test -- --coverage

      - name: Tải lên báo cáo phủ sóng code
        uses: codecov/codecov-action@v3
        with:
          token: ${{ secrets.CODECOV_TOKEN }}

Chạy song song các công việc (Jobs)

Để tiết kiệm thời gian, bạn nên tách biệt các công việc kiểm tra để chúng chạy song song thay vì tuần tự. Ví dụ dưới đây tách riêng lint, typecheck và test, sau đó mới chạy deploy-staging.

jobs:
  lint:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20', cache: 'npm' }
      - run: npm ci && npm run lint

  typecheck:
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20', cache: 'npm' }
      - run: npm ci && npx tsc --noEmit

  test:
    runs-on: ubuntu-latest
    services:
      postgres:
        image: postgres:16
        env:
          POSTGRES_PASSWORD: testpass
          POSTGRES_DB: testdb
        options: >-
          --health-cmd pg_isready
          --health-interval 10s
    env:
      DATABASE_URL: postgresql://postgres:testpass@localhost:5432/testdb
    steps:
      - uses: actions/checkout@v4
      - uses: actions/setup-node@v4
        with: { node-version: '20', cache: 'npm' }
      - run: npm ci
      - run: npx prisma migrate deploy
      - run: npm test

  deploy-staging:
    needs: [lint, typecheck, test]  # Chạy sau khi tất cả các job trên pass
    if: github.ref == 'refs/heads/main'
    runs-on: ubuntu-latest
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh staging
        env:
          DEPLOY_KEY: ${{ secrets.STAGING_DEPLOY_KEY }}

Triển khai Production với cơ chế phê duyệt

Để đảm bảo an toàn, việc triển khai lên Production nên yêu cầu sự chấp thuận thủ công. GitHub Actions hỗ trợ tính năng này thông qua environments.

  deploy-production:
    needs: deploy-staging
    runs-on: ubuntu-latest
    environment: production  # Yêu cầu phê duyệt trong cài đặt GitHub
    steps:
      - uses: actions/checkout@v4
      - run: ./scripts/deploy.sh production
        env:
          DEPLOY_KEY: ${{ secrets.PROD_DEPLOY_KEY }}

Trong phần Settings → Environments → production trên GitHub, bạn có thể cấu hình yêu cầu người xem xét (reviewers) trước khi job này được chạy.

Tối ưu hóa Cache (Caching Dependencies)

Việc caching đúng cách có thể giảm thời gian CI xuống tới 40-60%. Đặc biệt với các dự án Next.js hoặc Node.js, việc cache cả node_modules và thư mục build là rất quan trọng.

- uses: actions/cache@v3
  with:
    path: |
      ~/.npm
      ${{ github.workspace }}/.next/cache
    key: ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-${{ hashFiles('**/*.js', '**/*.jsx', '**/*.ts', '**/*.tsx') }}
    restore-keys: |
      ${{ runner.os }}-nextjs-${{ hashFiles('**/package-lock.json') }}-

Mô hình Script triển khai (Deploy Script Pattern)

Thay vì viết lệnh dài dòng trong YAML, hãy đóng gói logic triển khai vào một script shell. Điều này giúp dễ bảo trì và thêm các bước như smoke test (kiểm tra nhanh).

#!/bin/bash
# scripts/deploy.sh
set -euo pipefail

ENV=${1:-staging}
echo "Đang triển khai lên $ENV..."

# Build
npm run build

# Chạy migration trước khi deploy code mới
if [ "$ENV" = "production" ]; then
  npx prisma migrate deploy
fi

# Triển khai (ví dụ với Vercel)
vercel deploy --prod --token=$VERCEL_TOKEN

# Smoke test (kiểm tra nhanh sức khỏe hệ thống)
sleep 10
curl -f https://app.example.com/api/health || {
  echo "Kiểm tra sức khỏe thất bại, đang thực hiện rollback"
  vercel rollback --token=$VERCEL_TOKEN
  exit 1
}

echo "Triển khai hoàn tất"

Thông báo Slack

Giữ cho đội ngũ được cập nhật trạng thái triển khai là rất quan trọng. Bạn có thể gửi thông báo tới Slack bất kể việc deploy thành công hay thất bại.

  notify:
    needs: deploy-production
    if: always()
    runs-on: ubuntu-latest
    steps:
      - name: Thông báo Slack
        uses: slackapi/[email protected]
        with:
          payload: |
            {
              "text": "${{ needs.deploy-production.result == 'success' && '✅' || '❌' }} Production deploy ${{ needs.deploy-production.result }}",
              "attachments": [{
                "text": "${{ github.event.head_commit.message }}",
                "footer": "bởi ${{ github.actor }}"
              }]
            }
        env:
          SLACK_WEBHOOK_URL: ${{ secrets.SLACK_WEBHOOK_URL }}

Quản lý Secrets (Secrets Management)

Tuyệt đối không hardcode các thông tin nhạy cảm trong code. Hãy sử dụng tính năng Secrets của GitHub.

# Không nên:
# env:
#   API_KEY: sk-abc123

# Nên làm:
env:
  API_KEY: ${{ secrets.API_KEY }}

# Sử dụng secrets riêng cho từng môi trường
# Vào: Settings → Environments → staging/production
# Giá trị khác nhau cho từng môi trường, tự động áp dụng

Mục tiêu 10 phút

Phân bổ thời gian lý tưởng cho từng giai đoạn của pipeline:

• Lint + Kiểm tra kiểu dữ liệu: 2 phút (chạy song song).
• Chạy test với cơ sở dữ liệu: 3 phút.
• Build: 2 phút.
• Triển khai: 1 phút.
• Smoke test: 30 giây.

Tổng thời gian chỉ khoảng 8.5 phút. Bất kỳ thứ gì vượt quá 10 phút đều được xem là sự cản trở (friction), khiến các kỹ sư có xu hướng gộp code (merge) mà không đợi CI chạy xong.

Pipeline nhanh sẽ được sử dụng. Pipeline chậm sẽ bị bỏ qua.

Giải pháp Whoff Agents AI SaaS Starter Kit cung cấp sẵn các workflow GitHub Actions để test, build và deploy, bạn có thể áp dụng ngay để tiết kiệm thời gian thiết lập.