radius-project / radius-project/docs

Docs update needed: Deleting radius-system namespace may hang

Open
#1,524 0 comments 0 reactions 0 assignees View on GitHub

Nobody has claimed this yet.

triaged
Dominant language
Bicep
Stars
26
Forks
52
Avg merge
3d 2h
Merged PRs (30d)
3

Description

What content needs to be created or modified?

The documentation should be updated to include troubleshooting steps and expected behavior when deleting the radius-system namespace. According to this issue in the radius repo, users may experience indefinite hangs due to resource deletion failures and remaining pods. Documentation should address:

  • What happens during deletion
  • Why the namespace may hang (e.g., remaining pods, API discovery failures)
  • How to resolve or troubleshoot the problem

Describe the solution you'd like

A new troubleshooting section should be added for the radius-system namespace deletion scenario, including:

  • Step-by-step guidance for users facing this problem
  • How to check for remaining resources
  • How to force delete stuck resources
  • How to interpret error messages such as "Discovery failed for some groups" and "Failed to delete all resource types"

Difference between rad uninstall kubernetes --purge and without --purge

Add a section explaining:

  • What happens when running rad uninstall kubernetes --purge vs. without --purge
  • What data and resources are left behind when not running with --purge (e.g., some CRDs, persistent data, configmaps, or other resources)
  • Best practices for users who want a complete clean-up

Where should the new material be placed?

Suggest placement in the Kubernetes installation and management docs, under troubleshooting or FAQ sections.

The associated pull request from the Radius code repo, if applicable

Reference issue: https://github.com/radius-project/radius/issues/10255

Additional context

See the linked issue for details, example output, and observed behavior. This update will help users avoid confusion and successfully clean up resources when uninstalling Radius.

AB#17132

Contributor guide

Open the contributing guide

First steps

  1. Read the whole issue, then the project's contributing guide.
  2. Comment on the issue to say you are picking it up — it saves two people doing the same work.
  3. Fork the repository and make your change on a branch.
  4. Open a pull request that references the issue number.

Research direction

Start by reading the linked Radius issue 10255 and the existing Kubernetes installation and management documentation to confirm the deletion behavior and current uninstall guidance. Add a troubleshooting section covering stuck resources, remaining pods, discovery errors, force deletion, and a comparison of rad uninstall kubernetes --purge with the default command; done means users can follow the steps to diagnose and complete cleanup.

Written by the indexing model from the issue text.

Assessment

Tech stack
kubernetes
Domain
devops, documentation
Issue type
Documentation
Difficulty
3/5
Estimated time
1-2 days
Activity status
Stale
Clarity
Mostly clear
Newbie friendliness
55/100

Get new issues in your inbox

A short digest of beginner-friendly GitHub issues.