authoravatarclover caruso<git@paperclover.net>2026-10-17 02:20:50-07:00
committeravatarclover caruso<git@paperclover.net>2026-10-21 02:52:29-07:00
log8b177d2982cee8727b59b7ea06cd3154c80f54de
tree02830ddc51089f079e17243a3fe6771de1df5fd6
parent248649cf074333f5aec822a0616f916ccab97dac
signature Signed by SSH key SHA256:52mNGHRsVFBDED9IAX5pe+LRWUefqTbxEReunq21QvU

Document the personal IPv4 Zig mirror rollout


1 files changed, 22 insertions(+), 23 deletions(-)

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