3031023-xyz-public/docs/cutover-runbook.md

3031023.xyz Worker cutover runbook

Scope and safety boundary

This runbook moves only the Happy Tails apex site to the separately deployed static Worker 3031023-xyz. It does not change the sign-up flow, n8n, the onboarding Worker, blog hosting, or any other site.

The Pages project 3031023-xyz remains available as the immediate rollback target until the new apex deployment has been accepted.

Routine preview and candidate jobs never create, delete, or change DNS records, custom domains, routes, or redirect rules. The candidate workflow only deploys static assets to a distinct Worker.

Pre-cutover record

• Existing rollback project: Cloudflare Pages 3031023-xyz.
• Existing active custom domain: 3031023.xyz.
• Existing Pages production deployment: 2fb1b659-5928-4470-bb04-ef4c9105b843 from the main branch.
• Preview Worker: 3031023-xyz-www-preview, with no custom domains or routes.
• Production candidate Worker: 3031023-xyz-www, deployed only through the dedicated Deploy primary production Worker candidate workflow. Its push trigger is limited to changes to that workflow file; ordinary site commits cannot update this Worker.

Cutover sequence (requires separate approval)

1. Confirm the candidate Worker deployment completed and record its version ID.
2. Verify its workers.dev URL for status, titles, static 404, mobile navigation, sitemap, robots, and security headers.
3. In Cloudflare, remove 3031023.xyz from the Pages project only after the candidate is verified. Do not delete the Pages project or its deployment.
4. Attach 3031023.xyz as the custom domain for the production Worker.
5. Attach www.3031023.xyz to the same Worker and create a Cloudflare Redirect Rule for www.3031023.xyz/* to the matching https://3031023.xyz/* URL. This preserves the apex canonical policy without adding hostname-routing Worker code.
6. Re-run the production verification checklist and leave the Pages project in place during the acceptance window.

Rollback

1. Remove the custom domains from the production Worker and disable the www redirect rule.
2. Restore 3031023.xyz to the unchanged Pages project 3031023-xyz.
3. Verify the known Pages deployment at its Pages URL and then at the apex.

The cutover operator records the actual Worker version ID, rule ID, time, and verification results in the migration plan after acceptance.