Skip to content

fix: repair Cloudflare Pages deploy + make CI mirror the real build - #192

Merged
brianp merged 1 commit into
mainfrom
fix-cloudflare-pages-deploy
Jul 29, 2026
Merged

fix: repair Cloudflare Pages deploy + make CI mirror the real build#192
brianp merged 1 commit into
mainfrom
fix-cloudflare-pages-deploy

Conversation

@brianp

@brianp brianp commented Jul 29, 2026

Copy link
Copy Markdown
Contributor

What

rfc.tari.com is published by the Cloudflare Pages 'rfcs' project, not GitHub Pages. It silently froze from 2026-06-17 to 2026-07-29: PR #175 removed build.js, but the Cloudflare build command still ran node build.js, so every Cloudflare build failed (Cannot find module '.../build.js'). GitHub Actions stayed green because it built a different way — nothing surfaced the failure.

The live site is already fixed (Cloudflare build command repointed + a successful deploy). This PR makes the repo the durable source of truth so it can't drift again.

Changes

  • scripts/build.sh — single build recipe, pins mdBook 0.5.2 + mdbook-mermaid 0.17.0. Cloudflare Pages' build command is now bash scripts/build.sh.
  • rfc_deploy.yml — no longer pushes to the retired gh-pages branch; now runs scripts/build.sh on push+PR so CI goes red when the real build would fail. Bumped checkout@v2.3.1v4.
  • rfc_test.yml — builds via the same script, then mdbook test. Single-sources the mdBook version.
  • DEPLOYMENT.md — documents the real pipeline.

Verify

CI here runs scripts/build.sh on Ubuntu — a green check is the build working exactly as Cloudflare runs it.

The site (rfc.tari.com) is published by the Cloudflare Pages 'rfcs' project,
not GitHub Pages. Between #175 and now it silently froze: #175 removed build.js
while the Cloudflare build command still ran 'node build.js', and CI built a
different way so nothing went red.

- Add scripts/build.sh as the single build recipe (pins mdBook 0.5.2 +
  mdbook-mermaid 0.17.0). Cloudflare Pages build command is now
  'bash scripts/build.sh'.
- Repoint both workflows at the same script so CI fails when the real build
  would fail. rfc_deploy.yml no longer pushes to the dead gh-pages branch; it
  just verifies the build. Bump checkout v2.3.1 -> v4.
- Add DEPLOYMENT.md documenting the real pipeline.
@cloudflare-workers-and-pages

Copy link
Copy Markdown

Deploying rfcs with  Cloudflare Pages  Cloudflare Pages

Latest commit: 1d4a7fd
Status: ✅  Deploy successful!
Preview URL: https://cf6a842a.rfcs-6p3.pages.dev
Branch Preview URL: https://fix-cloudflare-pages-deploy.rfcs-6p3.pages.dev

View logs

@brianp
brianp merged commit 9ce41a3 into main Jul 29, 2026
5 checks passed
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant