| ... | @@ -7,13 +7,11 @@ The mirror container shares only the Zig subtree. Flat protocol URLs fetch | ... | @@ -7,13 +7,11 @@ The mirror container shares only the Zig subtree. Flat protocol URLs fetch |
| 7 | missing files synchronously, then serve them locally; nested release/dev paths | 7 | missing files synchronously, then serve them locally; nested release/dev paths |
| 8 | remain browsable through Copyparty. | 8 | remain browsable through Copyparty. |
| 9 | | 9 | |
| 10 | [Zig's mirror contract](https://codeberg.org/ziglang/ziglang.org/src/branch/main/MIRRORS.md) | 10 | This is a personal IPv4 mirror at `https://file.paperclover.net/mirrors/zig/`. |
| 11 | requires HTTPS on **both IPv4 and IPv6**. Do not submit this mirror to Zig's list | 11 | Clover explicitly chose to leave it unlisted and omit IPv6 publication. |
| 12 | until both address families work from outside the LAN. On 2026-10-17 the host | 12 | [Zig's public mirror contract](https://codeberg.org/ziglang/ziglang.org/src/branch/main/MIRRORS.md) |
| 13 | had a public IPv6 RA address/default route, but outbound IPv6 to Zig and Google | 13 | requires both address families, so this deployment is not submitted to that list. |
| 14 | failed and `file.paperclover.net` had no AAAA record. DDNS currently updates A | 14 | No AAAA record or DDNS IPv6 change belongs to this rollout. |
| 15 | records only. A working delegated prefix/router firewall and matching AAAA | | |
| 16 | publication must be verified before enabling dual-stack discovery. | | |
| 17 | | 15 | |
| 18 | The worker polls the official index every six hours and caches the latest stable | 16 | The worker polls the official index every six hours and caches the latest stable |
| 19 | release and current development build. A request for any uncached supported name | 17 | release and current development build. A request for any uncached supported name |
| ... | @@ -27,22 +25,21 @@ one-time `verify` operation before first public exposure. | ... | @@ -27,22 +25,21 @@ one-time `verify` operation before first public exposure. |
| 27 | | 25 | |
| 28 | ## Production cutover | 26 | ## Production cutover |
| 29 | | 27 | |
| 30 | This is a reviewable runbook, **not an executed migration**. The 2026-10-17 | 28 | The 2026-10-17 production inventory found 289,931,243,359 bytes / 10,063 files |
| 31 | inventory found 267 GiB / 10,063 files in `/srv/mirrors/zig`, on `globe/mirrors`. | 29 | in `/srv/mirrors/zig`, on unencrypted `globe/mirrors`. The destination existed |
| 32 | The destination Zig directory existed empty on `globe/clover/Media`, with about | 30 | empty on encrypted `globe/clover/Media`, with more than 9 TiB available. |
| 33 | 9.13 TiB available. These are different filesystems: an atomic rename cannot | 31 | These are different filesystems and encryption roots: neither atomic rename |
| 34 | move the tree. Preserve the old tree until copy verification and public checks | 32 | nor block cloning can perform the move. Both roots use group `chloe` (GID 3000). |
| 35 | finish. Both roots use group `chloe` (GID 3000). | | |
| 36 | | 33 | |
| 37 | After production approval, confirm the host machine ID | 34 | Confirm the host machine ID `691734bfb3c24b19ae66e5cacd17f5e2`, mounts, free |
| 38 | `691734bfb3c24b19ae66e5cacd17f5e2`, mounts, free space, and that no writer is | 35 | space, and that no writer is changing the old tree. Copy without deleting the |
| 39 | changing the old tree. Then copy without deleting the source: | 36 | source: |
| 40 | | 37 | |
| 41 | ```sh | 38 | ```sh |
| 42 | findmnt -T /srv/mirrors/zig | 39 | findmnt -T /srv/mirrors/zig |
| 43 | findmnt -T /srv/clover/Media/Software/Public/zig | 40 | findmnt -T /srv/clover/Media/Software/Public/zig |
| 44 | rsync -aH --info=progress2 /srv/mirrors/zig/ /srv/clover/Media/Software/Public/zig/ | 41 | rsync -aHAX --numeric-ids --info=progress2 /srv/mirrors/zig/ /srv/clover/Media/Software/Public/zig/ |
| 45 | rsync -anrc --delete /srv/mirrors/zig/ /srv/clover/Media/Software/Public/zig/ | 42 | rsync -anHAXc --numeric-ids --itemize-changes --delete /srv/mirrors/zig/ /srv/clover/Media/Software/Public/zig/ |
| 46 | ``` | 43 | ``` |
| 47 | | 44 | |
| 48 | The checksum dry run must report no differences. Preserve existing numeric | 45 | The checksum dry run must report no differences. Preserve existing numeric |
| ... | @@ -50,15 +47,17 @@ ownership and ACLs; do not recursively chown the Media dataset. The destination | ... | @@ -50,15 +47,17 @@ ownership and ACLs; do not recursively chown the Media dataset. The destination |
| 50 | root must retain group traversal/write access for the mirror's declared Clover | 47 | root must retain group traversal/write access for the mirror's declared Clover |
| 51 | group. Run the mirror image's `verify` command against the copied destination | 48 | group. Run the mirror image's `verify` command against the copied destination |
| 52 | before publishing it. A disposable container can bind that exact subtree | 49 | before publishing it. A disposable container can bind that exact subtree |
| 53 | read-only. Retain | 50 | read-only. The checksum and authenticity passes may run concurrently with |
| 54 | any old `.hist` metadata privately; anonymous users lack dot-file permission. | 51 | bounded CPU/I/O to reuse the filesystem cache. Both must finish successfully. |
| | 52 | Retain old `.hist` metadata privately; anonymous users lack dot-file permission. |
| 55 | | 53 | |
| 56 | Promote the reviewed configuration through `tools/deploy.py prod`. Do not replace | 54 | Promote the reviewed configuration through `tools/deploy.py prod`. Do not replace |
| 57 | containers by hand. Confirm anonymous GET/HEAD/Range on flat and nested URLs, | 55 | containers by hand. Confirm anonymous GET/HEAD/Range on flat and nested URLs, |
| 58 | anonymous upload/delete denial, authenticated existing shares, and that parent | 56 | anonymous upload/delete denial, authenticated existing shares, and that parent |
| 59 | folders remain inaccessible. The source can be retired separately after the | 57 | folders remain inaccessible. Only after copy verification and positive public |
| 60 | verified copy and service behavior are accepted; it is not an active second | 58 | checks, rename the original tree to `/srv/mirrors/zig-retired-<UTC>` and link |
| 61 | mirror and no alias is required. | 59 | `/srv/mirrors/zig` to the canonical NAS tree. Keep the retired tree as a recovery |
| | 60 | copy; this cutover never deletes it. The NAS tree is the only active mirror. |
| 62 | | 61 | |
| 63 | ## Backfill and manual refresh | 62 | ## Backfill and manual refresh |
| 64 | | 63 | |