Skip to content

docs: add troubleshooting case for kubeconfig NotFound errors#1035

Open
ANAMASGARD wants to merge 1 commit into
karmada-io:mainfrom
ANAMASGARD:docs/troubleshooting-kubeconfig-not-found
Open

docs: add troubleshooting case for kubeconfig NotFound errors#1035
ANAMASGARD wants to merge 1 commit into
karmada-io:mainfrom
ANAMASGARD:docs/troubleshooting-kubeconfig-not-found

Conversation

@ANAMASGARD

Copy link
Copy Markdown

Summary

  • Adds a troubleshooting case for the server could not find the requested resource (get clusters.cluster.karmada.io) to docs/troubleshooting/trouble-shooting.md
  • Explains root cause (host kubeconfig vs Karmada kubeconfig), install-method paths including Helm secret extraction, and --kubeconfig usage

Fixes #654

Test plan

  • typos docs/troubleshooting/trouble-shooting.md --config ./typos.toml — no new findings in added section
  • No CRLF in committed file (git grep --cached -I $'\r' returns nothing)
  • New section visible at /docs/next/troubleshooting/trouble-shooting
  • Cluster Registration relative link works in preview

@karmada-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 rainbowmango 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

@karmada-bot karmada-bot requested review from Poor12 and Tingtal July 1, 2026 07:00
@karmada-bot

Copy link
Copy Markdown
Contributor

Welcome @ANAMASGARD! It looks like this is your first PR to karmada-io/website 🎉

@karmada-bot karmada-bot added the size/M Denotes a PR that changes 30-99 lines, ignoring generated files. label Jul 1, 2026
Document the common "server could not find the requested resource"
error when users point kubectl/karmadactl at the host cluster
instead of the Karmada API server.

Fixes karmada-io#654

Signed-off-by: Gaurav Chaudhary <chaudharygaurav2004@gmail.com>
@ANAMASGARD ANAMASGARD force-pushed the docs/troubleshooting-kubeconfig-not-found branch from 00a9c22 to a838f37 Compare July 1, 2026 07:03
@gemini-code-assist

Copy link
Copy Markdown

Warning

Gemini encountered an error creating the review. You can try again by commenting /gemini review.

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

Labels

size/M Denotes a PR that changes 30-99 lines, ignoring generated files.

Projects

None yet

Development

Successfully merging this pull request may close these issues.

Troubleshooting: the server could not find the requested resource

2 participants