fetch-docs: allow REPO/REPO_ID/NAME overrides from the environment - #3
Open
grandixximo wants to merge 1 commit into
Open
fetch-docs: allow REPO/REPO_ID/NAME overrides from the environment#3grandixximo wants to merge 1 commit into
grandixximo wants to merge 1 commit into
Conversation
Defaults are unchanged, so existing cron lines keep publishing the plain linuxcnc-doc artifact. Overriding the three values lets the same script publish a post-processed variant, such as the searchable docs built by LinuxCNC/doc-search, with the same trust checks (head_repository_id pin, sha256, tree sanity).
Contributor
|
Sorry, but I need a bit more help than this.
(it doesn't help that crontab -e uses a unique editor that I don't know, JOE) |
Contributor
Author
|
Thanks, that is exactly what I needed. Here is the line in your crontab's shape, one line, no continuations: It replaces the existing devel line; keep the old one commented above it so rollback is just swapping back. Two things to know:
For JOE: make the edit, then |
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.
Make the three source constants overridable from the environment. Defaults are unchanged, so existing cron lines behave as before.
Reason: LinuxCNC/doc-search CI builds
linuxcnc-doc-search.tar.gz, the plain docs artifact plus an in-browser pagefind search box (via the topbar slot from LinuxCNC/linuxcnc#4184). It rebuilds only when the docs digest changes, so there is no artifact churn. The trust model is unchanged:head_repository_idpin, sha256 check, tree checks. The webserver token needs nothing new; doc-search is a public repo.@andypugh: searchable devel docs go live by editing the existing master cron line (a second line on the same webroot would fight it):
Keep the old line commented for rollback. 2.9 stays on the plain artifact; its pages predate the topbar slot.