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