Troubleshooting Kubernetes Installation

This page has instructions for resolving typical problems that can occur when installing Kubernetes with talm, talos-bootstrap, or talosctl.

No Talos nodes in maintenance mode found!

If you encounter issues with the talos-bootstrap script not detecting any nodes, follow these steps to diagnose and resolve the issue:

1. Verify Network Segment

   Ensure that you are running the script within the same network segment as the nodes. This is crucial for the script to be able to communicate with the nodes.

2. Use Nmap to Discover Nodes

   Check if nmap can discover your node by running the following command:

   nmap -Pn -n -p 50000 192.168.0.0/24
   

   This command scans for nodes in the network that are listening on port 50000. The output should list all the nodes in the network segment that are listening on this port, indicating that they are reachable.

3. Verify talosctl Connectivity

   Next, verify that talosctl can connect to a specific node, especially if the node is in maintenance mode:

   talosctl -e "${node}" -n "${node}" get machinestatus -i
   

   Receiving an error like the following usually means your local talosctl binary is outdated:

   rpc error: code = Unimplemented desc = unknown service resource.ResourceService
   

   Updating talosctl to the latest version should resolve this issue.

4. Run talos-bootstrap in debug mode

   If the previous steps don’t help, run talos-bootstrap in debug mode to gain more insight.

   Execute the script with the -x option to enable debug mode:

   bash -x talos-bootstrap
   

   Pay attention to the last command displayed before the error; it often indicates the command that failed and can provide clues for further troubleshooting.