Skip to content

Commit

Permalink
docs: add docs for server removal/decommissioning
Browse files Browse the repository at this point in the history
This PR adds docs that address removing a server from Sidero altogether.

Signed-off-by: Spencer Smith <[email protected]>
  • Loading branch information
rsmitty authored and talos-bot committed Jun 12, 2021
1 parent c7ae88a commit a5b3e67
Show file tree
Hide file tree
Showing 2 changed files with 44 additions and 0 deletions.
21 changes: 21 additions & 0 deletions website/content/docs/v0.2/Guides/decommissioning.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,21 @@
---
description: "A guide for decommissioning servers"
weight: 1
title: "Decommissioning Servers"
---

This guide will detail the process for removing a server from Sidero.
The process is fairly simple with a few pieces of information.

- For the given server, take note of any serverclasses that are configured to match the server.

- Take note of any clusters that make use of aforementioned serverclasses.

- For each matching cluster, edit the cluster resource with `kubectl edit cluster` and set `.spec.paused` to `true`.
Doing this ensures that no new machines will get created for these servers during the decommissioning process.

- If the server is already part of a cluster (`kubectl get serverbindings` should provide this info), you can now delete the machine that corresponds with this server via `kubectl delete machine <machine_name>`.

- With the machine deleted, Sideo will reboot the machine and wipe its disks.

- Once the disk wiping is complete and the server is turned off, you can finally delete the server from Sidero with `kubectl delete server <server_name>`.
23 changes: 23 additions & 0 deletions website/content/docs/v0.3/Guides/decommissioning.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,23 @@
---
description: "A guide for decommissioning servers"
weight: 1
title: "Decommissioning Servers"
---

This guide will detail the process for removing a server from Sidero.
The process is fairly simple with a few pieces of information.

- For the given server, take note of any serverclasses that are configured to match the server.

- Take note of any clusters that make use of aforementioned serverclasses.

- For each matching cluster, edit the cluster resource with `kubectl edit cluster` and set `.spec.paused` to `true`.
Doing this ensures that no new machines will get created for these servers during the decommissioning process.

- If the server is already part of a cluster (`kubectl get serverbindings` should provide this info), you can now delete the machine that corresponds with this server via `kubectl delete machine <machine_name>`.

- With the machine deleted, Sideo will reboot the machine and wipe its disks.

- Once the disk wiping is complete and the server is turned off, you can finally delete the server from Sidero with `kubectl delete server <server_name>` and repurpose the server for something else.

- Finally, unpause any clusters that were edited in step 3 by setting `.spec.paused` to `false`.

0 comments on commit a5b3e67

Please sign in to comment.