Bỏ qua tới nội dung
~/hth
Tất cả ghi chú
#CI/CD & GitOps

Deploy lên Cloudflare Pages bằng GitHub Actions

Pipeline của chính trang này, và hai lỗi làm tôi mất thời gian. Một là sai quyền của token, hai là deploy nhầm nhánh.

Viết ngày 21/11/20262 phút đọc

  • GitHub Actions
  • Cloudflare Pages
  • Wrangler
  • CI/CD
Trong bài này

Cách dựng

Project Pages dùng Direct Upload: Cloudflare không build gì cả. GitHub Actions build site rồi dùng Wrangler upload thư mục dist/.

  • Push lên main: npm ci → npm run build → deploy production → smoke test.
  • Pull request: chỉ build, để code lỗi không lọt vào main mà không ai biết.

Bước deploy:

- name: Deploy to Cloudflare Pages
  run: npx wrangler pages deploy dist --project-name hth-portfolio --branch production
  env:
    CLOUDFLARE_API_TOKEN: ${{ secrets.CLOUDFLARE_API_TOKEN }}
    CLOUDFLARE_ACCOUNT_ID: ${{ secrets.CLOUDFLARE_ACCOUNT_ID }}

Lỗi 1: token chỉ có quyền đọc

Deploy thất bại với lỗi:

A request to the Cloudflare API (/accounts/***/pages/projects/hth-portfolio/upload-token) failed.
Authentication error [code: 10000]

Token của tôi có Cloudflare Pages: Read, cộng thêm hai quyền không liên quan (Account Custom Pages và Access: Custom Pages). Gõ “Pages” vào ô chọn quyền là ra cả ba mục, và ô cuối mặc định là Read.

Thứ deploy thực sự cần chỉ là một dòng: Account → Cloudflare Pages → Edit, giới hạn trong tài khoản chứa project.

Hai chỗ dễ gây hiểu nhầm:

  • Wrangler in ra Super Administrator - All Privileges. Đó là vai trò của tôi trong tài khoản, không phải quyền của token.
  • Cloudflare trả mã 10000 cho cả token sai lẫn token đúng nhưng thiếu quyền. Xem trang tóm tắt của token là cách nhanh nhất để biết là trường hợp nào.

Lỗi 2: deploy rơi vào Preview

Mỗi project Pages có một production branch, chọn lúc tạo project. Wrangler gợi ý tên production. Nếu không có --branch, Wrangler lấy tên nhánh git hiện tại. Repo đang ở main nên mọi lần deploy đều thành bản preview (alias main.<project>.pages.dev), còn site thật không đổi.

Cách sửa là luôn truyền --branch <production-branch> và kiểm tra bản deploy đã đi đâu:

npx wrangler pages deployment list --project-name hth-portfolio
# Cột Environment phải là Production

Nên giữ trong mọi pipeline

  • Ghim action bên ngoài theo commit SHA, ghi phiên bản trong comment.
  • Dừng sớm với thông báo rõ ràng khi thiếu secret.
  • Smoke test URL thật sau khi deploy: curl phải trả 200.
  • Dùng concurrency để hai lần push không deploy cùng lúc.
  • Máy local và CI dùng chung một lệnh deploy (ở đây là npm run deploy:upload), để hai bên không lệch nhau.