Distribute image archives through direct fabric - #135
Closed
FujitsuPolycom wants to merge 2 commits into
Closed
Conversation
Add a plan-first four-rank archive fan-out utility that seeds one checksum-bound file and forwards it through the direct-link chain derived from the validated site topology. Preserve resumable partial downloads and rsync hops, reject conflicting final files, verify SHA-256 after every hop, support read-only verification and create-only execution, and emit rank/hop evidence before optional image import. Validation: 141 fan-out and site-topology tests passed; Ruff E/F/W checks passed. The broader scripts suite has one pre-existing README assertion failure also reproduced on the stacked base.
This was referenced Aug 30, 2026
Owner
Author
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
Result
Status: implemented, with GPU-free command and state-machine coverage. Direct-fabric throughput and live image import remain unqualified.
Add
scripts/fanout_image_archive.pyto download one checksum-bound image archive on a configured seed rank and forward it through the four-rank direct-link chain derived from the validated site topology. Management SSH starts and inspects work; rsync binds to each source fabric address and connects to the adjacent peer address.The utility provides:
--verifymode;--create-onlyarchive distribution without Docker import;curl --continue-at -seed downloads;rsync --partial --append-verifyfabric hops;No command from this branch was run against live hosts.
Validation
python -m pytest scripts/test_fanout_image_archive.py scripts/test_sparkring_site.py -q: 141 passedruff check --select E,F,W --ignore E501 scripts/fanout_image_archive.py scripts/test_fanout_image_archive.py: passed0→1→2→3fabric chain and no remote operation.python -m pytest scripts -q -rsrun produced 508 passed and 3 skipped, plus one unrelated README assertion failure that reproduces unchanged on the stacked base.This draft is stacked on #131 so its site/profile terminology matches that branch.