CI: Add Gerrit RTDv3 merge workflow#48
Open
ModeSevenIndustrialSolutions wants to merge 1 commit into
Open
Conversation
Add an organization-level required merge workflow that publishes Read the Docs (RTDv3) documentation once a Gerrit change merges. The workflow is a thin dispatcher: it posts a start comment to Gerrit, delegates the documentation publish to the centrally-managed reusable gerrit-compose-required-rtdv3-merge.yaml (v0.8.1) in lfreleng-actions' releng-reusable-workflows, then reports the aggregated conclusion back to the change as a comment. Voting steps run comment-only since the change has already merged. All action references are SHA-pinned to their latest releases and the workflow passes zizmor --persona=auditor with zero findings. Co-authored-by: Claude <noreply@anthropic.com> Signed-off-by: Matthew Watkins <mwatkins@linuxfoundation.org>
zxiiro
approved these changes
Jul 20, 2026
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.
Summary
Adds an organization-level required merge workflow that publishes Read
the Docs (RTDv3) documentation once a Gerrit change merges.
Part of the effort to modernise the Linux Foundation Gerrit CI and
standardise on the centrally-managed reusable workflows in
lfit/releng-reusable-workflows.Design
Thin dispatcher (
on: workflow_dispatch, invoked by the Gerrit → GitHubintegration on merge):
the change has already merged).
gerrit-compose-required-rtdv3-merge.yaml@v0.8.1, forwarding the RTDAPI token.
change as a comment.
Notes / follow-ups
uses:references are SHA-pinned to their latest releases.zizmor --persona=auditorwith zero findings. Thesecrets-outside-envallow-list is provided by the companion config PR(CI: Add zizmor auditor configuration #45), which should merge first.
LFIT_GERRIT_SERVER,LFIT_GERRIT_KNOWN_HOSTS,LFIT_GERRIT_SSH_REQUIRED_USER/LFIT_GERRIT_SSH_REQUIRED_PRIVKEY, theRTD_TOKENsecret, and the sharedreusable's
vars.GERRIT_URL. A repository Ruleset must wire thisworkflow to run on merge for the Gerrit-mirrored docs repositories.
bypassable verify workflow in CI: Add Gerrit bypassable RTDv3 verify workflow #47).
Validation
actionlint→ cleanyamllint→ cleanzizmor --persona=auditor --offline→ no findings