From 218582f0a9dc531156b65dc4a7270bc9b8488b50 Mon Sep 17 00:00:00 2001 From: "Felix Wischke (65278)" Date: Wed, 10 Apr 2024 15:40:33 +0200 Subject: [PATCH] docs/Troubleshooting: document machine deletion deadlocks --- docs/Troubleshooting.md | 12 ++++++++++++ 1 file changed, 12 insertions(+) diff --git a/docs/Troubleshooting.md b/docs/Troubleshooting.md index 1f4fd1cc..15042eb3 100644 --- a/docs/Troubleshooting.md +++ b/docs/Troubleshooting.md @@ -104,3 +104,15 @@ e1000 0000:00:12.0 ens18: renamed from eth0 ``` If you absolutely must mix interface types, make sure that the default network interface is the one that comes up first. + +## Machine deletion deadlock +Sometimes machines do not delete because some resource needs to be reconciled before +deletion can happen, but these resources can not reconcile (for example nodes may not drain). +To fix deletion deadlocks in such cases: + - Remove `ipaddresses` and `ipaddressclaims` for the relevant machines + - Remove the `proxmoxmachine` finalizer by editing `proxmoxmachines ` + - Delete the `proxmoxmachine` + - Remove the `machine` finalizer by editing `machines ` + - Delete the `machine` + +After these steps, VMs may linger in proxmox. Carefully remove those.