Standardize upstream CLI reference syncing#24739
Open
dvdksn wants to merge 6 commits intodocker:mainfrom
Open
Conversation
Pull-based workflow that runs in docker/docs — no cross-repo auth needed. Runs daily to auto-detect new releases, or manually via workflow_dispatch. For each configured upstream repo, runs the `docs-release` bake target via git context, copies YAML output to data/cli/<folder>/, and opens a PR. Upstream contract: define a `docs-release` bake target that outputs *.yaml CLI reference files. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
✅ Deploy Preview for docsdocker ready!
To edit notification comments on pull requests, go to your Netlify project configuration. |
Pull-based workflow that runs in docker/docs — no cross-repo auth needed. Runs daily to auto-detect new releases, or manually via workflow_dispatch. Uses existing upstream bake targets via git context: - docker/buildx: `update-docs` target - docker/compose: `docs-update` target - docker/model-runner: `update-docs` target (cmd/cli/docker-bake.hcl) Generates YAML, copies to data/cli/<folder>/, and opens a PR. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Move CLI reference YAML for compose and model-runner from Hugo module mounts (_vendor/) to data/cli/, where it will be managed by the sync-upstream-cli workflow alongside buildx and engine. - Copy YAML from _vendor/ to data/cli/compose/ and data/cli/model/ - Remove compose and model-runner imports from hugo.yaml - Remove from go.mod, go.sum, and _vendor/modules.txt Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
dvdksn
changed the title
Replace JavaScript-based dynamic matrix with a static YAML matrix. Version resolution is a simple `gh api` call in the sync job itself. Dispatch filtering uses a job-level `if` condition. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
Replaces manual git commit/push/gh-pr-create with a single action that handles commit, branch, push, and PR create/update. Co-Authored-By: Claude Opus 4.6 (1M context) <noreply@anthropic.com>
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
1 participant
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.
Standardize upstream CLI reference syncing
Supersedes #24736.
What this does
Adds
sync-upstream-cli.yml— a workflow that syncs CLI reference YAML from upstream repos intodata/cli/. Runs daily (auto-detects new releases) or manually viaworkflow_dispatch. Uses bake git context to build upstream repos remotely — no cross-repo auth needed.Moves compose and model-runner CLI YAML out of Hugo modules — from
_vendor/todata/cli/compose/anddata/cli/model/, where the sync workflow manages them. Removes these modules fromgo.mod,go.sum,_vendor/modules.txt, andhugo.yaml.How it works
For each configured upstream repo, the workflow:
data/cli/<folder>/Tested locally against all three repos — output matches current vendored content.
Configured repos
data/cli/folderupdate-docsout/reference/*.yamlbuildxdocs-updateout/reference/*.yamlcomposeupdate-docscmd/cli/docker-bake.hcl*.yamlmodelWhat upstream repos need to do
Nothing for buildx, compose, and model-runner — uses their existing bake targets.
docker/cli: needs a bake target (currently uses
make yamldocs). Tracked separately.Follow-up work
docs-releaseor similar)sync-cli-docs.yml+hack/sync-cli-docs.shdocs-release.ymland the fork dependency