Skip to content

Add the KB about how to delete a node - #114

Open
w13915984028 wants to merge 2 commits into
harvester:mainfrom
w13915984028:doc11349
Open

Add the KB about how to delete a node#114
w13915984028 wants to merge 2 commits into
harvester:mainfrom
w13915984028:doc11349

Conversation

@w13915984028

Copy link
Copy Markdown
Member

Problem:

https://docs.harvesterhci.io/v1.8/host/#7-remove-the-node has some missing details, and also not the best fit to add everything there.

Solution:

Add a KB.

Related Issue(s):

harvester/harvester#11349

Test plan:

Additional documentation or context

@netlify

netlify Bot commented Aug 5, 2026

Copy link
Copy Markdown

Deploy Preview for harvester-home-preview ready!

Name Link
🔨 Latest commit 7c2e91c
🔍 Latest deploy log https://app.netlify.com/projects/harvester-home-preview/deploys/6a8615135f48e400094d60c2
😎 Deploy Preview https://deploy-preview-114--harvester-home-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.

Copilot AI left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Pull request overview

Adds a new Knowledge Base (KB) article documenting a safe, step-by-step procedure for deleting a single Harvester node, expanding on the existing host documentation by covering CAPI Machine cleanup, RKE2 uninstall, and control-plane/etcd leadership considerations.

Changes:

  • Introduces a new KB guide: “How To Delete One Harvester Node”.
  • Documents control-plane node removal precautions (quorum and etcd leader transfer).
  • Provides an end-to-end removal flow (cordon/drain → rke2 uninstall → delete CAPI Machine → delete Kubernetes Node → disk cleanup), with screenshots.
Suppressed comments (1)

kb/2026-08-05/how_to_delete_one_node.md:275

  • The example command is currently written as a blockquote (> prefixes) inside the warning admonition, which can break copy/paste formatting. Use a normal code block (no > prefixes).
> ```bash
> # Example: Clear filesystem and partition signatures on the primary drive
> wipefs -a /dev/sdX
> ```

💡 Add Copilot custom instructions for smarter, more guided reviews. Learn how to get started.

Comment thread kb/2026-08-05/how_to_delete_one_node.md Outdated
@w13915984028
w13915984028 force-pushed the doc11349 branch 5 times, most recently from 26284ee to 971da63 Compare August 5, 2026 20:09
Signed-off-by: Jian Wang <jian.wang@suse.com>
Comment thread kb/2026-08-05/how_to_delete_one_node.md Outdated
![node-warning](./imgs/node-removal-after-uninstall.png)


## Remove the Machine Object

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

deleting the node should clean up the machine object.
do we want to change the doc to ask users to delete node first and then clean up machine object if one still exists after node deletion?

Copy link
Copy Markdown
Member Author

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

Thanks.

After multi tests via harvester/harvester#11349 (comment), the machine object is effectively removed by node deletion automatically, but fleet-agent deployment could cause issues on some cases.

Both #114 and harvester/docs#1108 are updated accordingly. Please take a new look.

@w13915984028
w13915984028 force-pushed the doc11349 branch 4 times, most recently from fd716b9 to 3c41bea Compare August 19, 2026 20:37
Signed-off-by: Jian Wang <jian.wang@suse.com>
@w13915984028

Copy link
Copy Markdown
Member Author

PR is ready for review, thanks.

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.

3 participants