Skip to content

Commit ce34a70

Browse files
committed
docs(mirror): codify the no-delete rule (both hosts); --clobber only ever fires on a non-serving asset
1 parent 70967c7 commit ce34a70

1 file changed

Lines changed: 8 additions & 2 deletions

File tree

.github/tools/mirror_res.sh

Lines changed: 8 additions & 2 deletions
Original file line numberDiff line numberDiff line change
@@ -81,8 +81,14 @@ verify_batch() { # base_url asset... → prints assets still not serving
8181
return 0
8282
}
8383

84-
# One host's mirror: upload everything not yet serving, then batch-verify
85-
# with propagation patience, up to 3 rounds.
84+
# One host's mirror: probe → SKIP whatever already serves → upload only the
85+
# missing, then batch-verify with propagation patience, up to 3 rounds.
86+
#
87+
# HARD RULE: this script issues NO delete operations, on either host.
88+
# (The gh `--clobber` below is an overwrite-upload that can only fire after
89+
# the download probe already said the asset is NOT serving — it can repair a
90+
# phantom record but can never touch a serving asset, which is skipped
91+
# before any upload is attempted.)
8692
#
8793
# Hard-won rules (0.0.86 / 0.0.89 / 0.0.90 postmortems):
8894
# - NEVER delete on a verify timeout — the eager 404→delete loop repeatedly

0 commit comments

Comments
 (0)