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
mainmà 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ã
10000cho 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:
curlphả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.