Skip to content

docs: add rpk k8s command reference (26.2)#1801

Closed
JakeSCahill wants to merge 1 commit into
betafrom
doc-2364-rpk-k8s-reference
Closed

docs: add rpk k8s command reference (26.2)#1801
JakeSCahill wants to merge 1 commit into
betafrom
doc-2364-rpk-k8s-reference

Conversation

@JakeSCahill

Copy link
Copy Markdown
Contributor

Adds reference pages for the rpk k8s command family shipped in 26.2 (DOC-2364):

  • rpk k8s (install, uninstall, upgrade, version)
  • rpk k8s multicluster (bootstrap, bundle, status)

How these were generated

Generated with the standard doc-tools rpk generator from rpk v26.2.1-rc3 --print-tree with the k8s plugin 26.2.1-beta.3 installed, plus two gap-fills:

  • Flags: the rpk plugin protocol (--help-autocomplete) exposes no flag data, so the flags tables for the multicluster subcommands are parsed from the plugin's own cobra help (built from the operator source at the v26.2.1-beta.3 tag) and injected into the tree before generation.
  • Examples: the generator's example formatter breaks on multi-line commands with backslash continuations, so the Examples sections for the multicluster commands are supplied through overrides.

Beta install caveat (documented on the install page)

During the beta, rpk k8s install without flags fails with no latest Redpanda Kubernetes plugin release found: the plugin publisher only marks pure X.Y.Z versions as latest, so 26.2.1-beta.3 never becomes latest (confirmed by Rafał Korepta; publish.go stableVersionRe). The install page documents pinning: rpk k8s install --plugin-version {operator-beta-version}.

Release-day follow-ups (GA, July 28)

  • Regenerate from the GA rpk + GA plugin and drop the beta NOTE on the install page.
  • Add k8s to KNOWN_PLUGINS in docs-extensions-and-macros so the automation covers these pages (blocked until a latest plugin release exists, or the pipeline pins the version).
  • Merge the k8s entries into docs-data/rpk-overrides.json on the automation branch.

Validation

  • Full Antora build passes; all 9 pages render and {operator-beta-version} resolves in the install note.
  • Install failure and pinned-version workaround reproduced live with the rc3 rpk binary.

Generated with doc-tools from rpk v26.2.1-rc3 with the k8s plugin
26.2.1-beta.3 installed. Flags for the plugin-provided multicluster
commands are injected from the plugin's cobra help because the rpk
plugin protocol does not expose flag data. Includes a beta note on
the install page: no plugin release is marked latest during the beta,
so installs must pin --plugin-version.
@JakeSCahill
JakeSCahill requested a review from a team as a code owner July 16, 2026 11:05
@netlify

netlify Bot commented Jul 16, 2026

Copy link
Copy Markdown

Deploy Preview for redpanda-docs-preview ready!

Name Link
🔨 Latest commit c65ea75
🔍 Latest deploy log https://app.netlify.com/projects/redpanda-docs-preview/deploys/6a58baf0f725fe000869ed8f
😎 Deploy Preview https://deploy-preview-1801--redpanda-docs-preview.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.

To edit notification comments on pull requests, go to your Netlify project configuration.

@JakeSCahill

Copy link
Copy Markdown
Contributor Author

Folded into #1681 (cherry-picked as 2f74d21) so the stretch guide and the rpk k8s reference land together. The generation details and release-day follow-ups from this PR's description now apply to #1681.

@JakeSCahill
JakeSCahill deleted the doc-2364-rpk-k8s-reference branch July 16, 2026 13:31
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant