GitHub Actions — tự build, tự deploy

Một file YAML cho bạn máy chủ miễn phí tự đưa web lên mỗi lần push. Kèm bẫy quyền, bẫy bindings bị ghi đè, và quy trình hai bước preview → duyệt → production.

GitHub Actions là máy tính của GitHub chạy việc hộ bạn mỗi khi có sự kiện trong repo. Miễn phí cho repo công khai; repo riêng tư có hạn mức phút/tháng, đủ thừa cho mọi việc trong giáo trình.

Từ bài này, bạn sẽ không gõ lệnh deploy nữa: git push là web cập nhật.

Hai cách tự deploy — chọn đúng cái

Lời khuyên thật: nếu project chỉ là HTML tĩnh, dùng Pages nối Git, bỏ qua Actions cho tới khi cần. Đừng thêm phức tạp vì nghe sang. Khi nào cần build bằng script riêng, hoặc cần chặn bản lỗi, hãy quay lại bài này.

File Actions đầu tiên

Tạo .github/workflows/deploy.yml:

name: Deploy len Cloudflare Pages

on:
  push:
    branches: [main]
  workflow_dispatch:        # cho phep bam chay tay tren web

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

      - uses: actions/setup-python@v5
        with:
          python-version: '3.11'

      - name: Build
        run: |
          pip install markdown pygments
          python build.py

      - name: Deploy
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy dist --project-name=web-dau-tien

Đọc từng khối — bốn ý, hiểu rồi thì mọi file Actions khác đều đọc được:

• on: — khi nào chạy. Ở đây: mỗi lần đẩy vào main, hoặc bấm tay.
• runs-on: ubuntu-latest — GitHub cấp cho bạn một máy Linux sạch, miễn phí, mỗi lần chạy.
• steps: — các bước, chạy tuần tự. uses: là dùng việc người khác viết sẵn; run: là lệnh của bạn.
• ${{ secrets.X }} — lấy bí mật từ kho của repo, không bao giờ viết thẳng khóa vào file này.

Lấy token Cloudflare đúng quyền

Đây là chỗ hay sai nhất, và sai thì thông báo lỗi rất tối nghĩa.

1. dash.cloudflare.com/profile/api-tokens → Create Token.
2. Chọn mẫu Edit Cloudflare Workers (mẫu này phủ cả Pages và Workers).
3. Giới hạn vào đúng tài khoản của bạn, đừng để All accounts.
4. Tạo, rồi sao chép ngay — nó chỉ hiện một lần.

Lấy Account ID: dashboard → Workers & Pages → cột phải có Account ID.

Nạp vào GitHub:

gh secret set CLOUDFLARE_API_TOKEN
gh secret set CLOUDFLARE_ACCOUNT_ID

Lệnh này hỏi giá trị rồi nhập — bạn tự dán, giá trị không nằm lại trong lịch sử dòng lệnh. Hoặc làm trên web: repo → Settings → Secrets and variables → Actions → New repository secret.

Kiểm nó chạy

git add . ; git commit -m "Them workflow tu deploy" ; git push
gh run watch           # xem trực tiếp trong dòng lệnh

Hoặc mở tab Actions trên repo. Xanh là xong, đỏ là lỗi — bấm vào bước đỏ để đọc log.

Lỗi hay gặp lần đầu:

gh run view --log-failed > loi.txt

Đọc loi.txt (log của bước Actions bị lỗi) và .github/workflows/deploy.yml.
Nói nguyên nhân gốc trong 2 dòng, rồi sửa đúng chỗ đó trong file YAML.
Đừng viết lại cả workflow.

Quy trình hai bước: preview → duyệt → production

Đây là mức Cấp 5 nhưng dựng ngay từ bây giờ thì về sau khỏi phải sửa. Dùng cho mọi project có người ngoài dùng.

Ý tưởng: push vào main chỉ tạo bản preview. Lên bản thật phải bấm duyệt.

name: Deploy hai buoc

on:
  push:
    branches: [main]

jobs:
  preview:
    runs-on: ubuntu-latest
    outputs:
      url: ${{ steps.dep.outputs.deployment-url }}
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: python build.py
      - id: dep
        uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy dist --project-name=web-dau-tien --branch=preview

  production:
    needs: preview
    runs-on: ubuntu-latest
    environment: production        # <-- cho nay chan lai, cho duyet
    steps:
      - uses: actions/checkout@v4
      - name: Build
        run: python build.py
      - uses: cloudflare/wrangler-action@v3
        with:
          apiToken: ${{ secrets.CLOUDFLARE_API_TOKEN }}
          accountId: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}
          command: pages deploy dist --project-name=web-dau-tien --branch=main

Rồi bật cổng duyệt: repo → Settings → Environments → New environment tên production → tích Required reviewers → chọn chính bạn.

Từ đó mỗi lần push: GitHub deploy bản preview, gửi bạn thông báo "chờ duyệt". Bạn mở link preview, bấm thử, thấy ổn thì vào Actions bấm Approve. Lúc đó bản thật mới đổi.

Việc khác Actions làm được, rất đáng dùng

Chặn bản lỗi: thêm bước test trước bước deploy. Test đỏ là không deploy.

      - name: Kiem tra co ban
        run: |
          python build.py
          test -f dist/index.html
          grep -q "Chang An" dist/index.html

Ba dòng này đã bắt được lỗi thật: build "thành công" nhưng sinh ra file rỗng.

Việc định kỳ: thay cho cron trên máy bạn.

on:
  schedule:
    - cron: '0 1 * * *'   # 01:00 UTC = 08:00 gio Viet Nam