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