~kris/dots

srice

srice/doc/files/cdn/migration/README.md -rw-r--r-- 1.7 KiB
e98f3b03 — Kris Yotam chore: sync local state after restore (push updates, no pull) a month ago

#CDN migration workspace

This directory holds reproducible tooling and notes for rebuilding the cloned CDN route at /mnt/storage/new-cdn.

The live route at /mnt/storage/cdn is the source of truth for the initial clone and must stay untouched until the new route, URL updates, and dependent databases are verified.

#Current decisions

  • video/ becomes vids/.
  • images/ and photos/ collapse into pics/.
  • Current referenced images win canonical slots by default.
  • Existing public basename conventions override newer draft slug ideas.
  • Fictional characters all move to pics/people/characters/.
  • Books move to pics/media/books/{slug}/, without Library of Congress classification subdirectories.
  • photos.krisyotam.com is a rebuild target after the final tree and manifest are stable.

#First-pass outputs

The first manifest pass should produce:

  • an inventory of every file in /mnt/storage/new-cdn;
  • a URL reference index from src/krisyotam.com, lit/content, and src/photos.krisyotam.com;
  • a proposed path map with canonical/variant status;
  • a review list for ambiguous classes, duplicate canonical candidates, and source buckets not yet covered by the docs.

Do not delete old paths from new-cdn during the first pass. Build the map, review it, then move files in a separate step.

#Operational paths

  • Clone target: /mnt/storage/new-cdn
  • Standalone archive route: /mnt/storage/archive
  • Migration workdir on STARGATE: /mnt/storage/cdn-migration
  • Full inventory output: /mnt/storage/cdn-migration/new-cdn-inventory.tsv

The inventory hashes every file. It may appear idle at the beginning because large archive files are hashed before the first TSV row is flushed.