How to Fix AWS EKS Auto Mode Cluster Node Addition Issue

Select Language:

If you’re experiencing problems with your Amazon EKS Auto Mode nodes not joining the cluster, don’t worry—there are some common areas to check that can usually resolve these issues.

First, make sure your network setup is correct. When you use Auto Mode, Amazon automatically configures your EC2 instances with the right details to connect to your cluster, such as the cluster endpoint and security certificates. However, if your nodes are in private subnets without proper internet access, they won’t be able to reach the EKS API server. This can stop them from joining the cluster and cause multiple node creation attempts, leaving pods stuck in a pending state. To fix this, confirm that your subnet’s route table has a default route pointing to a NAT Gateway. This setup allows your nodes to reach the EKS API and other external services smoothly.

Next, review your DNS and DHCP settings. The VPC where your nodes run should have correct configurations for domain name and DNS servers. Typically, the default setup uses Amazon’s DNS with the domain name set to <region>.compute.internal, and the DNS server points to AmazonProvidedDNS. If you’re using custom DNS servers or have disabled public access to your API endpoint, your nodes might struggle to resolve the necessary addresses. Ensuring proper DNS configuration is key to preventing connection failures.

To check why nodes aren’t joining your cluster, start by listing NodeClaims with the command kubectl get nodeclaim. Look for any that are marked as “Not Ready.” Then, run kubectl describe nodeclaim <name> and review the Status section for errors. You can also examine logs through the Kubernetes NodeDiagnostic resource or use AWS’s EC2 CLI command get-console-output to gather more troubleshooting details.

If you’re unsure about your network architecture or specific configurations, consider reaching out to AWS Support. They can help analyze your setup and advise on supported configurations or possible workarounds. You can open a support case on the AWS Support Center website for personalized assistance.

For more information and detailed troubleshooting steps, review the official AWS documentation on EKS cluster problems and Auto Mode troubleshooting. These resources provide valuable guidance to help you resolve your node registration issues swiftly.