Skip to content

fix(mesh): clarify kumactl usage with Konnect global CP - #6614

Open
ashman1984 wants to merge 3 commits into
mainfrom
fix/mesh-konnect-kumactl-docs
Open

fix(mesh): clarify kumactl usage with Konnect global CP#6614
ashman1984 wants to merge 3 commits into
mainfrom
fix/mesh-konnect-kumactl-docs

Conversation

@ashman1984

Copy link
Copy Markdown
Contributor

Description

Clarifies when to use kumactl and kubectl with a Konnect managed global CP and Kubernetes zone CPs.

The current guidance says kumactl is read-only because the mesh is deployed on Kubernetes.
That isn't correct for the setup described here, where the global CP is managed by Konnect and Kubernetes hosts the zone CP.

kumactl is used to manage mesh resources on the Konnect global CP, while kubectl is used to manage Kubernetes resources in the zone cluster.

This updates the shared kumactl guidance to make that distinction clear.

Preview Links

Checklist

  • Tested how-to docs. Not tested end to end.
    This change aligns with the existing zone migration and zone federation guidance, where kumactl is used to apply Mesh resources to the Konnect global CP, and with behaviour we've previously confirmed through Support.
  • All pages contain metadata.
  • Any new docs link to existing docs.
  • All autogenerated instructions render correctly (API, decK, Konnect, Kong Manager).
  • Style guide (capitalized gateway entities, placeholder URLs) implemented correctly.
  • Every page has a description entry in frontmatter.
  • Add new pages to the product documentation index (if applicable).

## Description

Clarifies when to use `kumactl` and `kubectl` with a Konnect managed global CP and Kubernetes zone CPs.

The current guidance says `kumactl` is read-only because the mesh is deployed on Kubernetes.

That isn't correct for the setup described here, where the global CP is managed by Konnect and Kubernetes hosts the zone CP.

`kumactl` is used to manage mesh resources on the Konnect global CP, while `kubectl` is used to manage Kubernetes resources in the zone cluster.

This updates the shared `kumactl` guidance to make that distinction clear.
@ashman1984
ashman1984 requested a review from a team as a code owner August 10, 2026 07:16
@netlify

netlify Bot commented Aug 10, 2026

Copy link
Copy Markdown

Deploy Preview for kongdeveloper ready!

Name Link
🔨 Latest commit 1235a69
🔍 Latest deploy log https://app.netlify.com/projects/kongdeveloper/deploys/6a8262ade095b3000831cbaf
😎 Deploy Preview https://deploy-preview-6614--kongdeveloper.netlify.app
📱 Preview on mobile
Toggle QR Code...

QR Code

Use your smartphone camera to open QR code link.
🤖 Make changes Run an agent on this branch

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

Comment thread app/_includes/faqs/mesh-configure-kumactl.md Outdated
ashman1984 and others added 2 commits August 17, 2026 10:38
@ashman1984
ashman1984 requested a review from lmilan August 17, 2026 01:37
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.

2 participants