Skip to content

docs: serve impulso.quantclimate.com from Cloudflare - #374

Merged
thomaspinder merged 1 commit into
mainfrom
docs/cloudflare-cutover
Sep 30, 2026
Merged

thomaspinder merged 1 commit into
mainfrom
docs/cloudflare-cutover

Conversation

@thomaspinder

Copy link
Copy Markdown
Collaborator

Important

Draft until page views for impulso-next.quantclimate.com show up in Cloudflare Web Analytics. Merging moves impulso.quantclimate.com to Cloudflare on the next deploy.

Motivation

#373 staged the docs on Cloudflare at impulso-next.quantclimate.com. The first deploy (run 36777474354) succeeded. The staging host was then checked directly:

  • Every URL shape returns the same status as before. /, /index.html, the section directories, /genindex.html, /search.html?q=var, /objects.inv, /sitemap.xml, /render-mode.txt and /_static/basic.css return 200. /nope.html and /_redirects return 404.
  • Cloudflare injects the Web Analytics beacon at the edge with the quantclimate.com site token, with no code in the repo.
  • TLS is served by the zone's *.quantclimate.com certificate.

Solution

  • docs/wrangler.jsonc: the custom domain becomes impulso.quantclimate.com. On the first deploy, Wrangler replaces the DNS-only CNAME to quantclimate.github.io with the Worker's custom domain.
  • main.yml: the GitHub Pages deploy-docs job is removed. The Cloudflare job takes its name. The build job uploads a plain docs-html artifact instead of a Pages artifact, and the workflow no longer requests pages: write or id-token: write.

GitHub Pages stays enabled in the repo settings. It gets no new deploys, but quantclimate.github.io/Impulso/… links keep redirecting to the custom domain, and the last Pages deploy is available for a rollback.

Verification

actionlint passes. After the merge, check that impulso.quantclimate.com answers with server: cloudflare, and that the URL matrix above behaves the same on it.

Rollback

Revert this PR, delete the impulso.quantclimate.com custom domain from the impulso-docs Worker, and recreate the DNS-only CNAME impulso → quantclimate.github.io.

🤖 Generated with Claude Code

https://claude.ai/code/session_015fagcMeo1LmLG2Dg3NybmQ

Staging on impulso-next.quantclimate.com checked out, so move the real
hostname to the impulso-docs Worker and drop the GitHub Pages deploy.
GitHub Pages stays enabled for the github.io redirects and as a
rollback target.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_015fagcMeo1LmLG2Dg3NybmQ
@codecov

codecov Bot commented Sep 30, 2026

Copy link
Copy Markdown

Codecov Report

✅ All modified and coverable lines are covered by tests.

📢 Thoughts on this report? Let us know!

@thomaspinder
thomaspinder marked this pull request as ready for review September 30, 2026 21:43
@thomaspinder
thomaspinder merged commit 698da1c into main Sep 30, 2026
14 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