Migrate Forest website to Workers Build

Đang mở
#7,648 0 bình luận 0 reaction 0 người được giao Xem trên GitHub

Maintainer thường phản hồi trong vòng 1 ngày

Chưa có ai nhận issue này.

Đánh giá

Độ khó
3/5
Thời gian dự kiến
1-2 ngày
Mức phù hợp với người mới
65/100
Loại issue
Tái cấu trúc
Độ rõ ràng
Đặc tả rõ ràng
Mức độ hoạt động
Sôi nổi
Công nghệ
github-actions, javascript
Lĩnh vực
ci-cd, cloud, devops

Hướng nghiên cứu

The issue is to migrate the forest-website deployment from Cloudflare Pages Direct Upload to Workers Build. Start by examining the linked PR (https://github.com/ChainSafe/forest-website/pull/184) to understand the current setup. The main steps involve adding a wrangler.jsonc configuration file, updating package.json to include wrangler, and configuring the Cloudflare dashboard for Workers Builds. Test locally with yarn build && npx wrangler dev and a dry-run deploy. The completion criteria is a successful migration with the custom domain attached to the new Worker.

Do mô hình lập chỉ mục viết ra từ nội dung của issue.

Mô tả

Type: Task

Summary

The action we were relying on is deleted, so now we have to do some manual dance because we're stuck on Direct Upload.

https://github.com/ChainSafe/forest-website/pull/184

This works, but a cleaner solution would be to migrate to something that CF really supports and doesn't put traps on.

Completion Criteria

  • Migrate Forest website to Workers Build

Additional Links & Resources

https://developers.cloudflare.com/workers/static-assets/migration-guides/migrate-from-pages/
https://developers.cloudflare.com/workers/ci-cd/builds/configuration/
https://developers.cloudflare.com/workers/ci-cd/builds/git-integration/

Claude's migration steps (unverified, treat with caution)

Prerequisites (verified)

  • chainsafe.io runs on Cloudflare nameservers (gene/toby.ns.cloudflare.com). Required — Workers custom domains don't support external DNS with a CNAME, unlike Pages. This was the likeliest blocker; it's fine.
  • No functions/, no _headers, no _redirects. Nothing Pages-specific to port.
  • out/404.html exists, so 404 handling maps cleanly.

Steps

  1. Add wrangler.jsonc at repo root. Assets-only Worker, so no main and no ASSETS binding:
    {
    "name": "forest-website",
    "compatibility_date": "2026-09-22",
    "assets": {
    "directory": "./out",
    "not_found_handling": "404-page"
    }
    }

  2. Add wrangler to devDependencies. Verify locally before touching anything remote: yarn build && npx wrangler dev (port 8787, not Pages' 8788), then npx wrangler deploy --dry-run.

  3. In the Cloudflare dashboard, create the Worker and connect the GitHub repo via Workers Builds. Settings:

    • build command yarn build
    • deploy command npx wrangler deploy
    • preview deploy command npx wrangler versions upload (this is what non-production branches get)
    • enable non-production branch builds, so Dependabot branches keep getting previews
    • build variable NODE_VERSION=22 — same wrangler requirement that just failed your run
  4. Confirm it works on *.workers.dev while Pages still serves production. No user impact yet.

  5. Cut over the domain. forest.chainsafe.io can only attach to one of them, so: remove it as a custom domain from the Pages project, then add it as a Custom Domain on the Worker. This is the only step with a downtime window — keep it short and do it deliberately.

  6. Delete .github/workflows/cf-deploy.yaml. Workers Builds does check runs and PR comments natively, so the whole Record GitHub deployment step disappears with it.

  7. Clean up afterwards: delete the Pages project once you're satisfied, and drop CLOUDFLARE_API_TOKEN / CLOUDFLARE_ACCOUNT_ID from the Actions and Dependabot secret stores if nothing else uses them.

Caveats worth knowing before you commit to this

  • The Deployments sidebar probably still won't come back. Docs promise check runs and PR comments; they don't mention GitHub Deployment environment records. Unconfirmed either way — I'd treat the sidebar as gone.
  • forest-landing.pages.dev dies. Preview URLs become version-scoped *.workers.dev URLs.
  • Pages environment variables don't carry over to Workers Builds; reconfigure them there.
  • Workers has no equivalent of Pages' branch deploy controls.
Ngôn ngữ chính
Rust
Star
700
Fork
201
Merge trung bình
1 ngày 17 giờ
Pull request đã merge (30 ngày)
65

Chuẩn bị môi trường

Bắt đầu từ đâu

  1. Đọc hết issue, rồi đọc hướng dẫn đóng góp của dự án.
  2. Bình luận trên issue rằng bạn sẽ nhận — tránh hai người làm cùng một việc.
  3. Fork repository và làm thay đổi trên một nhánh.
  4. Mở pull request có tham chiếu số hiệu của issue.

Issue khác của ChainSafe/forest

Tất cả issue của ChainSafe/forest

Issue tương tự

Thêm issue về Rust

Nhận issue mới trong hộp thư của bạn

Bản tóm tắt ngắn những issue GitHub phù hợp với người mới.