Skip to content

Docs DR / offline export

The Bedrock Cybersecurity documentation lives on Cloudflare Pages behind CF Access. During an incident — site down, CF Access misconfigured, network partition — the runbooks you need most can become unreachable. This procedure produces a self-contained offline copy.

When to run

  • Quarterly, alongside the freshness re-validation pass (see Coverage & freshness).
  • Before any planned change to the Pages project, CF Access policy, or DNS.
  • During DR tabletop exercises.

Produce the export

bash
cd bedrock-docs
bun run docs:build          # render the static site
bun scripts/dr-export.ts    # bundle it

Output: dr-export/bedrock-docs-offline.tar.gz, containing:

FolderContents
site/Rendered static HTML — open site/index.html in any browser, no server needed
source/Raw markdown source tree
MANIFEST.txtSource commit, date, and usage notes

Store it

Drop the archive in the offline backup location used by the offline backup procedure so it survives alongside the other break-glass material. Keep the two most recent quarters.

Verify

Extract the archive on a machine with no network and confirm site/index.html opens and internal links resolve:

bash
tar -xzf bedrock-docs-offline.tar.gz -C /tmp/docs-dr
open /tmp/docs-dr/site/index.html   # or xdg-open

The access-model half of this story (single-customer SSO-ready CF Access policy) is a separate infrastructure change owned by Rory.

Internal use only — Cirius Group