Skip to content

fix(docs): use v2.3.0 in the installation guide - #4334

Merged
google-oss-prow[bot] merged 1 commit into
kubeflow:masterfrom
fjvbn2003:docs-install-v2.3.0
Oct 27, 2026
Merged

google-oss-prow[bot] merged 1 commit into
kubeflow:masterfrom
fjvbn2003:docs-install-v2.3.0

Conversation

@fjvbn2003

@fjvbn2003 fjvbn2003 commented Oct 27, 2026 •

Copy link
Copy Markdown
Contributor

What this PR does / why we need it:

The installation guide pins VERSION=v2.1.0, but the --set runtimes.* and --set crds.enabled commands on the same page need chart 2.2.0 and 2.3.0. Chart 2.1.0 has neither key and no values.schema.json, so Helm ignores them and following the guide installs no runtimes. As discussed in #4310, this PR moves the guide to v2.3:

  • bumps VERSION to v2.3.0 (the latest release) in docs/operator-guides/installation.md and docs/user-guides/data-cache.md;
  • adds a ?ref=${VERSION} command for the built-in runtimes overlay and keeps the master one under "For the latest changes run", the same way the manager overlay is already shown.

The chart README is not changed (see #3807).

How I tested:

  • Checked that chart 2.3.0 is published at oci://ghcr.io/kubeflow/charts/kubeflow-trainer, that values.yaml at v2.3.0 has the crds and runtimes keys (and at v2.1.0 has neither), and that manifests/overlays/runtimes and manifests/overlays/data-cache exist at v2.3.0.
  • The docs build was run locally in a python:3.12-slim container, matching .readthedocs.yaml (Python 3.12, fail_on_warning: true):
    pip install -r docs/requirements.txt   # Sphinx 7.4.7, furo 2025.12.19, myst-parser 3.0.1
    make -C docs html SPHINXOPTS="-W --keep-going -q"
    
    It finished with exit code 0 and no warnings, both on master (8e07676) and with this change. The rendered installation.html and data-cache.html show export VERSION=v2.3.0 and the new runtimes?ref=${VERSION} command.
  • git diff --check is clean (no trailing whitespace; files end with a newline). There is no markdown linter in .pre-commit-config.yaml.
  • The Helm/kustomize commands themselves were not run against a cluster.

AI assistance: Claude helped find this and draft the change, and the checks above were run with its help. The commit has an Assisted-by trailer.

Which issue(s) this PR fixes (optional, in Fixes #<issue number>, #<issue number>, ... format, will close the issue(s) when PR gets merged):
Fixes #4310

Checklist:

  • Docs included if any changes are user facing

🤖 Generated with Claude Code

The installation guide pinned VERSION=v2.1.0, but the commands below it
pass --set runtimes.* and --set crds.enabled. Chart 2.1.0 has neither
key and no values.schema.json, so Helm ignores them and no
ClusterTrainingRuntimes are installed.

Bump VERSION to v2.3.0 in installation.md and data-cache.md, and add a
?ref=${VERSION} command for the built-in runtimes overlay so the
released-version kustomize path does not mix released CRDs with
runtimes from master.

Fixes kubeflow#4310

Assisted-by: Claude <[email protected]>
Signed-off-by: YoungjuKim <[email protected]>

@andreyvelich andreyvelich left a comment

Copy link
Copy Markdown
Member

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks @fjvbn2003!
/ok-to-test
/lgtm
/approve

@google-oss-prow

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is APPROVED

This pull-request has been approved by: andreyvelich

The full list of commands accepted by this bot can be found here.

The pull request process is described here

Details Needs approval from an approver in each of these files:

Approvers can indicate their approval by writing /approve in a comment
Approvers can cancel approval by writing /approve cancel in a comment

@google-oss-prow
google-oss-prow Bot merged commit 92f88b4 into kubeflow:master Oct 27, 2026
15 of 17 checks passed
@google-oss-prow google-oss-prow Bot added this to the v2.4 milestone Oct 27, 2026
@github-project-automation github-project-automation Bot moved this from Needs Triage to Done in Kubeflow Trainer Oct 27, 2026
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Projects

Archived in project

Development

Successfully merging this pull request may close these issues.

Installation guide pins chart v2.1.0, so the runtimes and crds flags shown below it are silently ignored

2 participants