Skip to content

Consolidate KubeV configuration reference and fix stale documentation - #2285

Open
mihiragrawal wants to merge 1 commit into
kubermatic:mainfrom
mihiragrawal:fix/kubev-docs-consolidate-config-reference
Open

Consolidate KubeV configuration reference and fix stale documentation#2285
mihiragrawal wants to merge 1 commit into
kubermatic:mainfrom
mihiragrawal:fix/kubev-docs-consolidate-config-reference

Conversation

@mihiragrawal

Copy link
Copy Markdown
Contributor

configuration-reference.md was published without Hugo frontmatter, was not linked from any page, and duplicated roughly 96% of configuration-guide. Delete it across v1.1.0, v1.2.0 and main, and carry over the content that only existed there.

The Kube-OVN architecture section is migrated with a correction: it described inter-node traffic as travelling through encrypted Geneve tunnels. Kube-OVN's IPsec support is opt-in and KubeV deploys with --enable-ovn-ipsec=false, so a
note now states that tunnel traffic is not encrypted.

The air-gapped preparation steps gain a Helm chart mirroring step. The deleted page referenced a "kubev mirror-charts" command that does not exist; the new step documents helm pull/push against the chart registry instead. Offline installs need the charts mirrored and the guide never said so. The note claiming platform images need separate registry credentials is removed: offline mode configures containerd with a wildcard mirror, so the single containerRegistry covers every image pull.

Document copying the installer binary into PATH as kubev, since the documentation invokes the CLI by that name while the downloader installs it as kubermatic-virtualization.

Fix stale values that were copied forward into the v1.2.0 directory:

  • the install page advertised v1.1.0 as the latest release, passed $USERNAME/$PASSWORD to the downloader instead of the KUBEV_ prefixed variables set earlier on the same page, and dropped the ./ prefix from the downloader invocations
  • the declarative installation sample showed nodes at Kubernetes v1.33.0 where all three releases ship v1.34.7
  • the CRD reference linked to the Kubernetes v1.25 API documentation

Signed-off-by: Mihir Agrawal <mihir@kubermatic.com>
@kubermatic-bot kubermatic-bot added the dco-signoff: yes Denotes that all commits in the pull request have the valid DCO signoff message. label Sep 8, 2026
@mihiragrawal mihiragrawal self-assigned this Sep 8, 2026
@kubermatic-bot kubermatic-bot added the size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files. label Sep 8, 2026
@kubermatic-bot

Copy link
Copy Markdown
Contributor

[APPROVALNOTIFIER] This PR is NOT APPROVED

This pull-request has been approved by:
Once this PR has been reviewed and has the lgtm label, please assign archups for approval. For more information see the Code Review Process.

The full list of commands accepted by this bot can be found 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

Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

dco-signoff: yes Denotes that all commits in the pull request have the valid DCO signoff message. size/XXL Denotes a PR that changes 1000+ lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

2 participants