Amazon EKS Troubleshooting

Última actualización: July 3, 2026

Al operar clusters de Amazon EKS, pueden surgir varios problemas. Este documento proporciona problemas comunes que pueden ocurrir en clusters de EKS y sus soluciones.

Troubleshooting Basics
Cluster Creation and Management Issues
Networking Issues
Node and Pod Issues
IAM and Authentication Issues
Storage Issues
Logging and Monitoring Issues
Performance Issues
Upgrade Issues
Common Error Messages and Solutions

Troubleshooting Basics

Troubleshooting Approach

Un enfoque sistemático para solucionar eficazmente problemas de clusters de EKS:

Identificar el problema: Identifica claramente los síntomas y el impacto del problema.
Recopilar información: Reúne logs, events y métricas relevantes.
Analizar: Analiza la información recopilada para identificar la causa raíz.
Resolver: Aplica las soluciones adecuadas.
Verificar: Confirma que el problema se haya resuelto.
Documentar: Documenta el problema y la solución para referencia futura.

Essential Tools and Commands

Herramientas y comandos esenciales para troubleshooting de EKS:

AWS CLI

Usa AWS CLI para comprobar la información del cluster de EKS:

bash

# List EKS clusters
aws eks list-clusters

# Check cluster details
aws eks describe-cluster --name my-cluster

# List node groups
aws eks list-nodegroups --cluster-name my-cluster

# Check node group details
aws eks describe-nodegroup --cluster-name my-cluster --nodegroup-name my-nodegroup

kubectl

Usa kubectl para comprobar recursos de Kubernetes:

bash

# Check node status
kubectl get nodes
kubectl describe node <node-name>

# Check pod status
kubectl get pods --all-namespaces
kubectl describe pod <pod-name> -n <namespace>

# Check service status
kubectl get services --all-namespaces
kubectl describe service <service-name> -n <namespace>

# Check events
kubectl get events --all-namespaces --sort-by='.lastTimestamp'

# Check logs
kubectl logs <pod-name> -n <namespace>
kubectl logs <pod-name> -n <namespace> -c <container-name>

eksctl

Usa eksctl para administrar clusters de EKS:

bash

# List clusters
eksctl get clusters

# List node groups
eksctl get nodegroup --cluster my-cluster

# Enable cluster logging
eksctl utils update-cluster-logging --enable-types all --cluster my-cluster --approve

AWS CloudWatch

Usa CloudWatch para comprobar logs y métricas del cluster de EKS:

bash

# Check CloudWatch log groups
aws logs describe-log-groups --log-group-name-prefix /aws/eks/my-cluster

# Check CloudWatch log streams
aws logs describe-log-streams --log-group-name /aws/eks/my-cluster/cluster

# Check CloudWatch log events
aws logs get-log-events --log-group-name /aws/eks/my-cluster/cluster --log-stream-name <log-stream-name>

Log Collection and Analysis

EKS Control Plane Logs

Habilita y comprueba los logs del control plane de EKS:

bash

# Enable control plane logs
aws eks update-cluster-config \
  --name my-cluster \
  --logging '{"clusterLogging":[{"types":["api","audit","authenticator","controllerManager","scheduler"],"enabled":true}]}'

# Check logs in CloudWatch
aws logs get-log-events \
  --log-group-name /aws/eks/my-cluster/cluster \
  --log-stream-name kube-apiserver-<timestamp>

Node Logs

Comprueba los logs de los nodes:

bash

# Connect to node using SSM
aws ssm start-session --target <instance-id>

# Check node logs
sudo journalctl -u kubelet

# Check container runtime logs
sudo journalctl -u docker
sudo journalctl -u containerd

Pod Logs

Comprueba los logs de los pods:

bash

# Check pod logs
kubectl logs <pod-name> -n <namespace>

# Check previous pod logs
kubectl logs <pod-name> -n <namespace> --previous

# Check specific container logs
kubectl logs <pod-name> -n <namespace> -c <container-name>

# Stream logs
kubectl logs -f <pod-name> -n <namespace>

Diagnostic Information Collection

Cluster Diagnostic Information

Recopila información de diagnóstico del cluster:

bash

# Collect cluster info
kubectl cluster-info dump > cluster-info.txt

# Collect node info
kubectl describe nodes > nodes-info.txt

# Collect pod info
kubectl get pods --all-namespaces -o wide > pods-info.txt
kubectl describe pods --all-namespaces > pods-desc-info.txt

# Collect service info
kubectl get services --all-namespaces -o wide > services-info.txt
kubectl describe services --all-namespaces > services-desc-info.txt

System Resource Information

Recopila información de recursos del sistema:

bash

# Check node resource usage
kubectl top nodes

# Check pod resource usage
kubectl top pods --all-namespaces

# Check node disk usage
kubectl debug node/<node-name> -it --image=busybox -- df -h

Network Diagnostics

Recopila información de diagnóstico de red:

bash

# Check network policies
kubectl get networkpolicies --all-namespaces

# Check DNS
kubectl run dnsutils --image=tutum/dnsutils --restart=Never -- sleep 3600
kubectl exec -it dnsutils -- nslookup kubernetes.default

# Check network connectivity
kubectl run netshoot --image=nicolaka/netshoot --restart=Never -- sleep 3600
kubectl exec -it netshoot -- ping <target-ip>
kubectl exec -it netshoot -- traceroute <target-ip>

Cluster Creation and Management Issues

Cluster Creation Failure

Common Causes

Causas comunes de fallos en la creación de clusters de EKS:

Permisos de IAM insuficientes: El usuario o rol de IAM que crea el cluster no tiene los permisos necesarios
Service Quota excedida: Cuota excedida para clusters de EKS o recursos relacionados (por ejemplo, VPC, subnets)
Problemas de configuración de red: Errores de configuración de VPC, subnet o security group
Conflicto de nombres de recursos: Uso de nombres de cluster o de recursos que ya están en uso
Problemas de disponibilidad de servicios de AWS: Problemas de disponibilidad con EKS o servicios relacionados

Troubleshooting Steps

Comprobar permisos de IAM:

bash

# Check IAM permissions
aws sts get-caller-identity

# Check required IAM policies
aws iam list-attached-role-policies --role-name <role-name>

Comprobar Service Quotas:

bash

# Check EKS cluster quota
aws service-quotas get-service-quota --service-code eks --quota-code L-1194D53C

# Check VPC quota
aws service-quotas get-service-quota --service-code vpc --quota-code L-F678F1CE

Comprobar la configuración de red:

bash

# Check VPC
aws ec2 describe-vpcs --vpc-ids <vpc-id>

# Check subnets
aws ec2 describe-subnets --subnet-ids <subnet-id-1> <subnet-id-2>

# Check routing tables
aws ec2 describe-route-tables --filters "Name=vpc-id,Values=<vpc-id>"

# Check security groups
aws ec2 describe-security-groups --group-ids <security-group-id>

Comprobar logs de CloudTrail:

bash

# Check CloudTrail events
aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventName,AttributeValue=CreateCluster

Comprobar el estado de los servicios de AWS:

Comprueba el estado de EKS y los servicios relacionados en el AWS Service Status Dashboard (https://status.aws.amazon.com/).

Common Solutions

Agregar permisos de IAM:

bash

# Add IAM policy for EKS cluster management
aws iam attach-role-policy \
  --role-name <role-name> \
  --policy-arn arn:aws:iam::aws:policy/AmazonEKSClusterPolicy

Solicitar aumento de Service Quota:

bash

# Request service quota increase
aws service-quotas request-service-quota-increase \
  --service-code eks \
  --quota-code L-1194D53C \
  --desired-value <new-value>

Modificar la configuración de red:

bash

# Add subnet tags
aws ec2 create-tags \
  --resources <subnet-id> \
  --tags Key=kubernetes.io/cluster/<cluster-name>,Value=shared

# Add security group rules
aws ec2 authorize-security-group-ingress \
  --group-id <security-group-id> \
  --protocol tcp \
  --port 443 \
  --cidr <cidr-block>

Intentar en una región diferente:

bash

# Create cluster in different region
aws eks create-cluster \
  --region <different-region> \
  --name my-cluster \
  --role-arn <role-arn> \
  --resources-vpc-config subnetIds=<subnet-id-1>,<subnet-id-2>,securityGroupIds=<security-group-id>

Cluster Endpoint Access Issues

Common Causes

Causas comunes de problemas de acceso al endpoint del cluster de EKS:

Restricción de acceso de red: Restricciones de acceso de red al endpoint del cluster
Problemas de autenticación: Problemas de autenticación con el cluster
Error de configuración de kubeconfig: Configuración incorrecta de kubeconfig
Problemas de disponibilidad del API Server: Problemas de disponibilidad del API Server

Troubleshooting Steps

Comprobar el endpoint del cluster:

bash

# Check cluster endpoint
aws eks describe-cluster --name my-cluster --query "cluster.endpoint"

# Test endpoint access
curl -k <cluster-endpoint>

Comprobar la política de acceso al endpoint del cluster:

bash

# Check cluster endpoint access policy
aws eks describe-cluster --name my-cluster --query "cluster.resourcesVpcConfig.endpointPublicAccess"
aws eks describe-cluster --name my-cluster --query "cluster.resourcesVpcConfig.endpointPrivateAccess"
aws eks describe-cluster --name my-cluster --query "cluster.resourcesVpcConfig.publicAccessCidrs"

Comprobar la configuración de kubeconfig:

bash

# Check kubeconfig configuration
cat ~/.kube/config

# Update kubeconfig
aws eks update-kubeconfig --name my-cluster --region <region>

Comprobar autenticación:

bash

# Check AWS CLI credentials
aws sts get-caller-identity

# Test kubectl authentication
kubectl auth can-i get pods

Common Solutions

Modificar la política de acceso al endpoint del cluster:

bash

# Enable public endpoint access
aws eks update-cluster-config \
  --name my-cluster \
  --resources-vpc-config endpointPublicAccess=true,publicAccessCidrs=["0.0.0.0/0"]

# Enable private endpoint access
aws eks update-cluster-config \
  --name my-cluster \
  --resources-vpc-config endpointPrivateAccess=true

Regenerar kubeconfig:

bash

# Regenerate kubeconfig
aws eks update-kubeconfig --name my-cluster --region <region>

Configurar autenticación de IAM:

bash

# Check aws-auth ConfigMap
kubectl describe configmap aws-auth -n kube-system

# Update aws-auth ConfigMap
eksctl create iamidentitymapping \
  --cluster my-cluster \
  --arn <iam-role-or-user-arn> \
  --username <username> \
  --group system:masters

Crear un VPC Endpoint:

bash

# Create VPC endpoint for EKS
aws ec2 create-vpc-endpoint \
  --vpc-id <vpc-id> \
  --service-name com.amazonaws.<region>.eks \
  --vpc-endpoint-type Interface \
  --subnet-ids <subnet-id-1> <subnet-id-2> \
  --security-group-ids <security-group-id>

Usar acceso al cluster con un clic mediante CloudShell (lanzado el 30 de abril de 2026):

Cuando la configuración local de kubeconfig o los problemas de acceso de red bloquean el acceso al cluster, la consola de EKS ofrece una alternativa directa. Al hacer clic en Connect en la lista de clusters, se inicia automáticamente AWS CloudShell con kubectl preconfigurado para ese cluster, para que puedas comenzar el troubleshooting desde el navegador de inmediato, sin instalar kubectl localmente, configurar credenciales de AWS CLI ni configurar kubeconfig. Admite clusters con endpoints de API públicos o privados, está disponible en todas las regiones y no genera costos adicionales más allá de los cargos existentes de CloudShell/EKS. (Fuente: Amazon EKS one-click cluster access)

Cluster Deletion Issues

Common Causes

Causas comunes de problemas al eliminar clusters de EKS:

Dependencias de recursos: Todavía existen recursos que dependen del cluster
Permisos de IAM insuficientes: El usuario o rol de IAM que elimina el cluster no tiene los permisos necesarios
Fallo al eliminar recursos: Fallo al eliminar recursos del cluster

Troubleshooting Steps

Comprobar el estado del cluster:

bash

# Check cluster status
aws eks describe-cluster --name my-cluster --query "cluster.status"

Comprobar recursos del cluster:

bash

# Check node groups
aws eks list-nodegroups --cluster-name my-cluster

# Check Fargate profiles
aws eks list-fargate-profiles --cluster-name my-cluster

# Check add-ons
aws eks list-addons --cluster-name my-cluster

Comprobar logs de CloudTrail:

bash

# Check CloudTrail events
aws cloudtrail lookup-events --lookup-attributes AttributeKey=EventName,AttributeValue=DeleteCluster

Common Solutions

Eliminar recursos dependientes:

bash

# Delete node groups
aws eks delete-nodegroup --cluster-name my-cluster --nodegroup-name <nodegroup-name>

# Delete Fargate profiles
aws eks delete-fargate-profile --cluster-name my-cluster --fargate-profile-name <profile-name>

# Delete add-ons
aws eks delete-addon --cluster-name my-cluster --addon-name <addon-name>

Forzar eliminación:

bash

# Force delete using eksctl
eksctl delete cluster --name my-cluster --force

Limpieza manual de recursos:

bash

# Delete load balancers
kubectl delete services --all --all-namespaces

# Delete PVCs
kubectl delete pvc --all --all-namespaces

# Delete namespaces
kubectl delete namespaces --all --ignore-not-found=true

Limpieza de recursos de AWS:

bash

# Delete ELBs
aws elb describe-load-balancers | jq -r '.LoadBalancerDescriptions[].LoadBalancerName' | xargs -I {} aws elb delete-load-balancer --load-balancer-name {}

# Delete NLB/ALBs
aws elbv2 describe-load-balancers | jq -r '.LoadBalancers[].LoadBalancerArn' | xargs -I {} aws elbv2 delete-load-balancer --load-balancer-arn {}

# Delete security groups
aws ec2 describe-security-groups --filters "Name=tag:kubernetes.io/cluster/<cluster-name>,Values=owned" | jq -r '.SecurityGroups[].GroupId' | xargs -I {} aws ec2 delete-security-group --group-id {}

Networking Issues

Los problemas de red están entre los problemas más comunes en clusters de EKS. Esta sección cubre problemas de red comunes y sus soluciones.

Pod-to-Pod Communication Issues

Common Causes

Causas comunes de problemas de comunicación pod-to-pod:

Network Policies: Network policies restrictivas que bloquean la comunicación pod-to-pod
Reglas de Security Group: Reglas de security group restrictivas que bloquean la comunicación pod-to-pod
Problemas del plugin CNI: Problemas de configuración o versión del plugin CNI
Conflicto de Pod CIDR: Conflictos de rango de Pod CIDR
Desajuste de MTU: Desajuste de MTU entre interfaces de red

Troubleshooting Steps

Comprobar Network Policies:

bash

# Check network policies
kubectl get networkpolicies --all-namespaces
kubectl describe networkpolicy <networkpolicy-name> -n <namespace>

Comprobar reglas de Security Group:

bash

# Check node security groups
aws ec2 describe-instances \
  --filters "Name=tag:eks:cluster-name,Values=my-cluster" \
  --query "Reservations[*].Instances[*].SecurityGroups[*]" \
  --output text

# Check security group rules
aws ec2 describe-security-group-rules \
  --filters "Name=group-id,Values=<security-group-id>"

Comprobar el plugin CNI:

bash

# Check CNI plugin version
kubectl describe daemonset aws-node -n kube-system | grep Image

# Check CNI plugin configuration
kubectl describe configmap aws-node -n kube-system

Comprobar Pod CIDR:

bash

# Check pod CIDR
kubectl get nodes -o jsonpath='{.items[*].spec.podCIDR}'

# Check pod IPs
kubectl get pods -o wide --all-namespaces

Comprobar MTU:

bash

# Check node MTU
kubectl debug node/<node-name> -it --image=busybox -- ifconfig

# Check CNI MTU
kubectl describe configmap aws-node -n kube-system | grep MTU

Common Solutions

Modificar Network Policies:

bash

# Create allow network policy
cat <<EOF | kubectl apply -f -
apiVersion: networking.k8s.io/v1
kind: NetworkPolicy
metadata:
  name: allow-all
  namespace: <namespace>
spec:
  podSelector: {}
  ingress:
  - {}
  egress:
  - {}
  policyTypes:
  - Ingress
  - Egress
EOF

Modificar reglas de Security Group:

bash

# Add node-to-node communication rule
aws ec2 authorize-security-group-ingress \
  --group-id <security-group-id> \
  --protocol all \
  --source-group <security-group-id>

Actualizar el plugin CNI:

bash

# Update CNI plugin
aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name vpc-cni \
  --addon-version <latest-version> \
  --resolve-conflicts PRESERVE

Modificar la configuración de CNI:

bash

# Modify CNI MTU configuration
kubectl set env daemonset aws-node -n kube-system AWS_VPC_ENI_MTU=1500

Reiniciar Pods:

bash

# Restart pods
kubectl delete pod <pod-name> -n <namespace>

Service Access Issues

Common Causes

Causas comunes de problemas de acceso a Services:

Desajuste del selector del Service: El selector del Service no coincide con las labels de los pods
Problemas de Endpoints: No se crean los endpoints del Service
Problemas de estado de Pod: Los pods no están ready
Desajuste de puertos del Service: El puerto del Service no coincide con el puerto del pod
Problemas de kube-proxy: Problemas de configuración o estado de kube-proxy

Troubleshooting Steps

Comprobar Service y Pods:

bash

# Check service
kubectl get services -n <namespace>
kubectl describe service <service-name> -n <namespace>

# Check pods
kubectl get pods -l <service-selector> -n <namespace>
kubectl describe pod <pod-name> -n <namespace>

Comprobar Endpoints:

bash

# Check endpoints
kubectl get endpoints <service-name> -n <namespace>
kubectl describe endpoints <service-name> -n <namespace>

Comprobar estado de Pod:

bash

# Check pod status
kubectl get pods -l <service-selector> -n <namespace> -o wide
kubectl describe pod <pod-name> -n <namespace>

Comprobar puertos del Service:

bash

# Check service ports
kubectl get service <service-name> -n <namespace> -o jsonpath='{.spec.ports[*]}'

# Check pod ports
kubectl get pod <pod-name> -n <namespace> -o jsonpath='{.spec.containers[*].ports[*]}'

Comprobar kube-proxy:

bash

# Check kube-proxy status
kubectl get pods -n kube-system -l k8s-app=kube-proxy
kubectl logs -n kube-system -l k8s-app=kube-proxy

Common Solutions

Modificar el selector del Service:

bash

# Modify service selector
kubectl patch service <service-name> -n <namespace> -p '{"spec":{"selector":{"app":"<app-label>"}}}'

Modificar labels de Pod:

bash

# Modify pod labels
kubectl label pod <pod-name> -n <namespace> app=<app-label> --overwrite

Modificar puertos del Service:

bash

# Modify service ports
kubectl patch service <service-name> -n <namespace> -p '{"spec":{"ports":[{"port":80,"targetPort":8080}]}}'

Reiniciar kube-proxy:

bash

# Restart kube-proxy
kubectl delete pod -n kube-system -l k8s-app=kube-proxy

Recrear Service:

bash

# Delete service
kubectl delete service <service-name> -n <namespace>

# Create service
kubectl expose deployment <deployment-name> -n <namespace> --port=80 --target-port=8080

Load Balancer Issues

Common Causes

Causas comunes de problemas de load balancer:

Faltan tags de subnet: Faltan tags de subnet para el load balancer
Restricciones de reglas de Security Group: Reglas de security group restrictivas
Fallo de Health Check: Fallos de health check del load balancer
Problemas de anotaciones del Service: Anotaciones del Service incorrectas
Cuota excedida: Cuota del load balancer excedida

Troubleshooting Steps

Comprobar estado del Service:

bash

# Check service status
kubectl get service <service-name> -n <namespace>
kubectl describe service <service-name> -n <namespace>

Comprobar estado del Load Balancer:

bash

# Check load balancer ARN
aws elbv2 describe-load-balancers \
  --query "LoadBalancers[?contains(DNSName, '<load-balancer-dns>')].LoadBalancerArn" \
  --output text

# Check load balancer status
aws elbv2 describe-load-balancer-attributes \
  --load-balancer-arn <load-balancer-arn>

# Check target group health
aws elbv2 describe-target-health \
  --target-group-arn <target-group-arn>

Comprobar tags de subnet:

bash

# Check subnet tags
aws ec2 describe-subnets \
  --subnet-ids <subnet-id-1> <subnet-id-2> \
  --query "Subnets[*].{ID:SubnetId,Tags:Tags}"

Comprobar reglas de Security Group:

bash

# Check security group rules
aws ec2 describe-security-group-rules \
  --filters "Name=group-id,Values=<security-group-id>"

Comprobar events del Service:

bash

# Check service events
kubectl get events -n <namespace> --field-selector involvedObject.name=<service-name>

Common Solutions

Agregar tags de subnet:

bash

# Add public subnet tags
aws ec2 create-tags \
  --resources <subnet-id-1> <subnet-id-2> \
  --tags Key=kubernetes.io/role/elb,Value=1

# Add private subnet tags
aws ec2 create-tags \
  --resources <subnet-id-1> <subnet-id-2> \
  --tags Key=kubernetes.io/role/internal-elb,Value=1

Agregar reglas de Security Group:

bash

# Add inbound rule
aws ec2 authorize-security-group-ingress \
  --group-id <security-group-id> \
  --protocol tcp \
  --port 80 \
  --cidr 0.0.0.0/0

# Add outbound rule
aws ec2 authorize-security-group-egress \
  --group-id <security-group-id> \
  --protocol tcp \
  --port 80 \
  --cidr 0.0.0.0/0

Modificar anotaciones del Service:

bash

# Add internal load balancer annotation
kubectl annotate service <service-name> -n <namespace> \
  service.beta.kubernetes.io/aws-load-balancer-internal="true" \
  --overwrite

# Add load balancer type annotation
kubectl annotate service <service-name> -n <namespace> \
  service.beta.kubernetes.io/aws-load-balancer-type="nlb" \
  --overwrite

Recrear Service:

bash

# Backup service
kubectl get service <service-name> -n <namespace> -o yaml > service-backup.yaml

# Delete service
kubectl delete service <service-name> -n <namespace>

# Create service
kubectl apply -f service-backup.yaml

Crear Load Balancer manualmente:

bash

# Create load balancer
aws elbv2 create-load-balancer \
  --name <load-balancer-name> \
  --type application \
  --subnets <subnet-id-1> <subnet-id-2> \
  --security-groups <security-group-id>

DNS Issues

Common Causes

Causas comunes de problemas de DNS:

Problemas de Pods de CoreDNS: Los pods de CoreDNS no se están ejecutando o no están ready
Problemas de Service kube-dns: El service kube-dns no está configurado correctamente
Problemas de política de DNS: La política DNS del Pod no está configurada correctamente
Restricciones de Network Policy: Network policies que bloquean el tráfico DNS
Problemas de configuración de CoreDNS: Errores de configuración de CoreDNS

Troubleshooting Steps

Comprobar Pods de CoreDNS:

bash

# Check CoreDNS pods
kubectl get pods -n kube-system -l k8s-app=kube-dns
kubectl describe pod -n kube-system -l k8s-app=kube-dns

Comprobar Service kube-dns:

bash

# Check kube-dns service
kubectl get service kube-dns -n kube-system
kubectl describe service kube-dns -n kube-system

Comprobar configuración de CoreDNS:

bash

# Check CoreDNS configuration
kubectl get configmap coredns -n kube-system -o yaml

Probar la resolución DNS:

bash

# Create DNS resolution test pod
kubectl run dnsutils --image=tutum/dnsutils --restart=Never -- sleep 3600

# Test DNS resolution
kubectl exec -it dnsutils -- nslookup kubernetes.default
kubectl exec -it dnsutils -- nslookup <service-name>.<namespace>.svc.cluster.local

Depuración de DNS:

bash

# Create DNS debugging pod
cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: Pod
metadata:
  name: dnsutils
  namespace: default
spec:
  containers:
  - name: dnsutils
    image: tutum/dnsutils
    command:
      - sleep
      - "3600"
    imagePullPolicy: IfNotPresent
  restartPolicy: Always
EOF

# DNS debugging
kubectl exec -it dnsutils -- cat /etc/resolv.conf
kubectl exec -it dnsutils -- dig kubernetes.default.svc.cluster.local

Common Solutions

Reiniciar CoreDNS:

bash

# Restart CoreDNS pods
kubectl delete pod -n kube-system -l k8s-app=kube-dns

Modificar configuración de CoreDNS:

bash

# Modify CoreDNS configuration
kubectl edit configmap coredns -n kube-system

Escalar CoreDNS hacia arriba:

bash

# Scale up CoreDNS
kubectl scale deployment coredns -n kube-system --replicas=3

Modificar la política de DNS:

bash

# Modify DNS policy
kubectl patch deployment <deployment-name> -n <namespace> -p '{"spec":{"template":{"spec":{"dnsPolicy":"ClusterFirst"}}}}'

Actualizar CoreDNS:

bash

# Update CoreDNS
aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name coredns \
  --addon-version <latest-version> \
  --resolve-conflicts PRESERVE

VPC CNI Issues

Common Causes

Causas comunes de problemas de VPC CNI:

Agotamiento de direcciones IP: Direcciones IP insuficientes asignadas a los nodes
Límite de ENI alcanzado: Límite de ENI (Elastic Network Interface) del node alcanzado
Problemas de versión de CNI: Versión de CNI obsoleta o incompatible
Errores de configuración de CNI: Configuración de CNI incorrecta
Problemas de permisos: Permisos de IAM insuficientes para CNI

Troubleshooting Steps

Comprobar Pods de VPC CNI:

bash

# Check VPC CNI pods
kubectl get pods -n kube-system -l k8s-app=aws-node
kubectl describe pod -n kube-system -l k8s-app=aws-node

Comprobar logs de VPC CNI:

bash

# Check VPC CNI logs
kubectl logs -n kube-system -l k8s-app=aws-node

Comprobar uso de direcciones IP:

bash

# Check IP address usage
kubectl exec -n kube-system -l k8s-app=aws-node -- curl -s http://localhost:61679/v1/enis | jq

Comprobar configuración de CNI:

bash

# Check CNI configuration
kubectl describe daemonset aws-node -n kube-system | grep -A 10 Environment

Comprobar permisos de IAM:

bash

# Check node IAM role
aws eks describe-nodegroup \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name> \
  --query "nodegroup.nodeRole"

# Check IAM policies
aws iam list-attached-role-policies \
  --role-name <node-role-name>

Common Solutions

Resolver agotamiento de direcciones IP:

bash

# Enable prefix delegation
kubectl set env daemonset aws-node -n kube-system ENABLE_PREFIX_DELEGATION=true

# Enable custom networking
kubectl set env daemonset aws-node -n kube-system AWS_VPC_K8S_CNI_CUSTOM_NETWORK_CFG=true

Aumentar límite de ENI:

bash

# Update node group with larger instance type
aws eks update-nodegroup-config \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name> \
  --scaling-config desiredSize=<desired-size>,minSize=<min-size>,maxSize=<max-size> \
  --update-config maxUnavailable=1

Actualizar VPC CNI:

bash

# Update VPC CNI
aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name vpc-cni \
  --addon-version <latest-version> \
  --resolve-conflicts PRESERVE

Modificar configuración de CNI:

bash

# Modify CNI configuration
kubectl set env daemonset aws-node -n kube-system WARM_IP_TARGET=5
kubectl set env daemonset aws-node -n kube-system MINIMUM_IP_TARGET=2

Agregar permisos de IAM:

bash

# Add CNI IAM policy
aws iam attach-role-policy \
  --role-name <node-role-name> \
  --policy-arn arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy

Node and Pod Issues

Node NotReady Issues

Common Causes

Causas comunes de problemas de node NotReady:

Problemas de kubelet: El servicio kubelet no se está ejecutando o tiene errores
Problemas de red del Node: Problemas de configuración de red del node
Agotamiento de recursos del Node: Agotamiento de recursos del node (CPU, memoria, disco)
Fallo de Health Check del Node: Fallos de health check del node
Presión de disco del Node: Agotamiento del espacio en disco del node

Troubleshooting Steps

Comprobar estado del Node:

bash

# Check node status
kubectl get nodes
kubectl describe node <node-name>

Comprobar condiciones del Node:

bash

# Check node conditions
kubectl get nodes -o jsonpath='{.items[*].status.conditions}' | jq

Comprobar estado de kubelet:

bash

# Connect to node using SSM
aws ssm start-session --target <instance-id>

# Check kubelet status
sudo systemctl status kubelet
sudo journalctl -u kubelet -n 100

Comprobar recursos del Node:

bash

# Check node resources
kubectl top node <node-name>

# Check disk usage
kubectl debug node/<node-name> -it --image=busybox -- df -h

Comprobar events del Node:

bash

# Check node events
kubectl get events --field-selector involvedObject.name=<node-name>

Common Solutions

Reiniciar kubelet:

bash

# Connect to node
aws ssm start-session --target <instance-id>

# Restart kubelet
sudo systemctl restart kubelet

Corregir problemas de red:

bash

# Check network configuration
aws ssm start-session --target <instance-id>
sudo cat /etc/cni/net.d/*
sudo systemctl restart containerd

Liberar espacio en disco:

bash

# Connect to node
aws ssm start-session --target <instance-id>

# Clean up unused images
sudo crictl rmi --prune

# Clean up logs
sudo journalctl --vacuum-time=1d

Reiniciar Node:

bash

# Reboot EC2 instance
aws ec2 reboot-instances --instance-ids <instance-id>

Reemplazar Node:

bash

# Cordon node
kubectl cordon <node-name>

# Drain node
kubectl drain <node-name> --ignore-daemonsets --delete-emptydir-data

# Terminate instance
aws ec2 terminate-instances --instance-ids <instance-id>

Pod Not Running Issues

Common Causes

Causas comunes de problemas de pod que no se ejecuta:

Fallo de descarga de imagen: Fallo al descargar la imagen del container
Problemas de resource requests: Recursos insuficientes para cumplir los resource requests
Error de configuración del Pod: Errores en la especificación del Pod
Fallo de scheduling: Fallo de scheduling del Pod
Fallo de montaje de volume: Fallo de montaje de volume

Troubleshooting Steps

Comprobar estado del Pod:

bash

# Check pod status
kubectl get pod <pod-name> -n <namespace>
kubectl describe pod <pod-name> -n <namespace>

Comprobar events del Pod:

bash

# Check pod events
kubectl get events -n <namespace> --field-selector involvedObject.name=<pod-name>

Comprobar logs del Pod:

bash

# Check pod logs
kubectl logs <pod-name> -n <namespace>
kubectl logs <pod-name> -n <namespace> --previous

Comprobar estado del Container:

bash

# Check container status
kubectl get pod <pod-name> -n <namespace> -o jsonpath='{.status.containerStatuses[*]}'

Comprobar scheduling:

bash

# Check pod scheduling
kubectl get pod <pod-name> -n <namespace> -o jsonpath='{.status.conditions[?(@.type=="PodScheduled")]}'

Common Solutions

Corregir problemas de descarga de imagen:

bash

# Check image availability
docker pull <image-name>

# Create image pull secret
kubectl create secret docker-registry <secret-name> \
  --docker-server=<registry-server> \
  --docker-username=<username> \
  --docker-password=<password> \
  --docker-email=<email> \
  -n <namespace>

# Add image pull secret to pod
kubectl patch serviceaccount default -n <namespace> -p '{"imagePullSecrets":[{"name":"<secret-name>"}]}'

Corregir problemas de recursos:

bash

# Reduce resource requests
kubectl patch deployment <deployment-name> -n <namespace> -p '{"spec":{"template":{"spec":{"containers":[{"name":"<container-name>","resources":{"requests":{"memory":"128Mi","cpu":"100m"}}}]}}}}'

Corregir errores de configuración:

bash

# Check and fix pod specification
kubectl get deployment <deployment-name> -n <namespace> -o yaml > deployment.yaml
# Edit deployment.yaml
kubectl apply -f deployment.yaml

Corregir problemas de scheduling:

bash

# Check schedulable nodes
kubectl get nodes -o jsonpath='{.items[?(@.spec.unschedulable!=true)].metadata.name}'

# Remove node taints
kubectl taint nodes <node-name> <taint-key>-

Corregir problemas de volume:

bash

# Check PVC status
kubectl get pvc -n <namespace>
kubectl describe pvc <pvc-name> -n <namespace>

# Recreate PVC
kubectl delete pvc <pvc-name> -n <namespace>
kubectl apply -f pvc.yaml

Resource Constraint Issues

Common Causes

Causas comunes de problemas de restricciones de recursos:

CPU insuficiente: Recursos de CPU insuficientes
Memoria insuficiente: Recursos de memoria insuficientes
Disco insuficiente: Espacio en disco insuficiente
Resource Quotas: Límites de resource quota alcanzados
Limit Ranges: Limit ranges de container excedidos

Troubleshooting Steps

Comprobar uso de recursos:

bash

# Check node resources
kubectl top nodes

# Check pod resources
kubectl top pods -n <namespace>

Comprobar Resource Quotas:

bash

# Check resource quotas
kubectl get resourcequotas -n <namespace>
kubectl describe resourcequota <quota-name> -n <namespace>

Comprobar Limit Ranges:

bash

# Check limit ranges
kubectl get limitranges -n <namespace>
kubectl describe limitrange <limitrange-name> -n <namespace>

Comprobar recursos del Pod:

bash

# Check pod resource requests and limits
kubectl get pod <pod-name> -n <namespace> -o jsonpath='{.spec.containers[*].resources}'

Common Solutions

Ajustar Resource Requests y Limits:

bash

# Adjust resource requests and limits
kubectl patch deployment <deployment-name> -n <namespace> -p '{"spec":{"template":{"spec":{"containers":[{"name":"<container-name>","resources":{"requests":{"memory":"256Mi","cpu":"200m"},"limits":{"memory":"512Mi","cpu":"500m"}}}]}}}}'

Ajustar Resource Quotas:

bash

# Adjust resource quotas
kubectl patch resourcequota <quota-name> -n <namespace> -p '{"spec":{"hard":{"requests.cpu":"10","requests.memory":"20Gi"}}}'

Expandir Node Group:

bash

# Expand node group
aws eks update-nodegroup-config \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name> \
  --scaling-config desiredSize=<desired-size>,minSize=<min-size>,maxSize=<max-size>

Habilitar Cluster Autoscaler:

bash

# Deploy Cluster Autoscaler
kubectl apply -f https://raw.githubusercontent.com/kubernetes/autoscaler/master/cluster-autoscaler/cloudprovider/aws/examples/cluster-autoscaler-autodiscover.yaml

IAM and Authentication Issues

Cluster Access Denied

Common Causes

Causas comunes de acceso denegado al cluster:

Falta aws-auth ConfigMap: aws-auth ConfigMap falta o está mal configurado
IAM Role no mapeado: El IAM role o usuario no está mapeado en aws-auth ConfigMap
Expiración del token: El token de autenticación de AWS ha expirado
kubeconfig mal configurado: kubeconfig está mal configurado

Troubleshooting Steps

Comprobar identidad de AWS:

bash

# Check AWS identity
aws sts get-caller-identity

Comprobar aws-auth ConfigMap:

bash

# Check aws-auth ConfigMap
kubectl get configmap aws-auth -n kube-system -o yaml

Comprobar kubeconfig:

bash

# Check kubeconfig
cat ~/.kube/config
kubectl config current-context

Comprobar autenticación:

bash

# Check authentication
kubectl auth can-i get pods

Common Solutions

Actualizar kubeconfig:

bash

# Update kubeconfig
aws eks update-kubeconfig --name my-cluster --region <region>

Agregar mapeo de identidad de IAM:

bash

# Add IAM identity mapping using eksctl
eksctl create iamidentitymapping \
  --cluster my-cluster \
  --arn <iam-role-or-user-arn> \
  --username <username> \
  --group system:masters

# Or manually edit aws-auth ConfigMap
kubectl edit configmap aws-auth -n kube-system

Crear aws-auth ConfigMap:

bash

# Create aws-auth ConfigMap
cat <<EOF | kubectl apply -f -
apiVersion: v1
kind: ConfigMap
metadata:
  name: aws-auth
  namespace: kube-system
data:
  mapRoles: |
    - rolearn: <node-role-arn>
      username: system:node:{{EC2PrivateDNSName}}
      groups:
        - system:bootstrappers
        - system:nodes
    - rolearn: <admin-role-arn>
      username: admin
      groups:
        - system:masters
EOF

Actualizar credenciales de AWS:

bash

# Refresh AWS credentials
aws sts get-session-token
aws eks get-token --cluster-name my-cluster

IRSA Issues

Common Causes

Causas comunes de problemas de IRSA:

Proveedor OIDC no configurado: El proveedor OIDC no está configurado para el cluster
Trust Policy mal configurada: La trust policy del IAM role está mal configurada
Falta anotación de Service Account: Falta la anotación del service account
Problemas de permisos del IAM Role: Al IAM role le faltan los permisos necesarios

Troubleshooting Steps

Comprobar proveedor OIDC:

bash

# Check OIDC provider
aws eks describe-cluster --name my-cluster --query "cluster.identity.oidc.issuer"

# List OIDC providers
aws iam list-open-id-connect-providers

Comprobar Service Account:

bash

# Check service account
kubectl get serviceaccount <service-account-name> -n <namespace> -o yaml

Comprobar IAM Role:

bash

# Check IAM role trust policy
aws iam get-role --role-name <role-name> --query "Role.AssumeRolePolicyDocument"

# Check IAM role policies
aws iam list-attached-role-policies --role-name <role-name>

Comprobar variables de entorno del Pod:

bash

# Check pod environment variables
kubectl exec -it <pod-name> -n <namespace> -- env | grep AWS

Common Solutions

Configurar proveedor OIDC:

bash

# Associate OIDC provider
eksctl utils associate-iam-oidc-provider --cluster my-cluster --approve

Corregir Trust Policy:

bash

# Get OIDC provider URL
OIDC_PROVIDER=$(aws eks describe-cluster --name my-cluster --query "cluster.identity.oidc.issuer" --output text | sed -e "s/^https:\/\///")

# Update trust policy
cat > trust-policy.json << EOF
{
  "Version": "2012-10-17",
  "Statement": [
    {
      "Effect": "Allow",
      "Principal": {
        "Federated": "arn:aws:iam::<account-id>:oidc-provider/${OIDC_PROVIDER}"
      },
      "Action": "sts:AssumeRoleWithWebIdentity",
      "Condition": {
        "StringEquals": {
          "${OIDC_PROVIDER}:sub": "system:serviceaccount:<namespace>:<service-account-name>"
        }
      }
    }
  ]
}
EOF

aws iam update-assume-role-policy --role-name <role-name> --policy-document file://trust-policy.json

Agregar anotación de Service Account:

bash

# Add service account annotation
kubectl annotate serviceaccount <service-account-name> -n <namespace> \
  eks.amazonaws.com/role-arn=<role-arn> \
  --overwrite

Agregar permisos de IAM:

bash

# Attach IAM policy
aws iam attach-role-policy \
  --role-name <role-name> \
  --policy-arn <policy-arn>

Node Join Failure

Common Causes

Causas comunes de fallo de unión de nodes:

Permisos del Node Role: Al IAM role del node le faltan los permisos necesarios
Restricciones de Security Group: Las reglas de security group impiden la comunicación del node con el control plane
Fallo de bootstrap: Fallo del script de bootstrap del node

Troubleshooting Steps

Comprobar estado del Node Group:

bash

# Check node group status
aws eks describe-nodegroup --cluster-name my-cluster --nodegroup-name <nodegroup-name>

Comprobar IAM Role del Node:

bash

# Check node IAM role
aws iam get-role --role-name <node-role-name>
aws iam list-attached-role-policies --role-name <node-role-name>

Comprobar Security Groups:

bash

# Check security groups
aws ec2 describe-security-groups --group-ids <security-group-id>

Comprobar logs del Node:

bash

# Connect to node using SSM
aws ssm start-session --target <instance-id>

# Check kubelet logs
sudo journalctl -u kubelet

Common Solutions

Agregar permisos de IAM del Node:

bash

# Attach required policies
aws iam attach-role-policy \
  --role-name <node-role-name> \
  --policy-arn arn:aws:iam::aws:policy/AmazonEKSWorkerNodePolicy

aws iam attach-role-policy \
  --role-name <node-role-name> \
  --policy-arn arn:aws:iam::aws:policy/AmazonEC2ContainerRegistryReadOnly

aws iam attach-role-policy \
  --role-name <node-role-name> \
  --policy-arn arn:aws:iam::aws:policy/AmazonEKS_CNI_Policy

Corregir reglas de Security Group:

bash

# Add required inbound rules
aws ec2 authorize-security-group-ingress \
  --group-id <node-security-group-id> \
  --protocol tcp \
  --port 443 \
  --source-group <cluster-security-group-id>

aws ec2 authorize-security-group-ingress \
  --group-id <node-security-group-id> \
  --protocol tcp \
  --port 10250 \
  --source-group <cluster-security-group-id>

Corregir script de bootstrap:

bash

# Connect to node
aws ssm start-session --target <instance-id>

# Re-run bootstrap script
sudo /etc/eks/bootstrap.sh my-cluster

Storage Issues

EBS Volume Issues

Common Causes

Causas comunes de problemas de EBS volume:

CSI Driver no instalado: El EBS CSI driver no está instalado
Problemas de permisos de IAM: Al IAM role del node le faltan permisos de EBS
Fallo de asociación del Volume: Falla la asociación del volume
StorageClass mal configurado: StorageClass está mal configurado

Troubleshooting Steps

Comprobar CSI Driver:

bash

# Check EBS CSI driver
kubectl get pods -n kube-system -l app=ebs-csi-controller
kubectl describe deployment ebs-csi-controller -n kube-system

Comprobar PVC y PV:

bash

# Check PVC status
kubectl get pvc -n <namespace>
kubectl describe pvc <pvc-name> -n <namespace>

# Check PV status
kubectl get pv
kubectl describe pv <pv-name>

Comprobar StorageClass:

bash

# Check StorageClass
kubectl get storageclass
kubectl describe storageclass <storageclass-name>

Comprobar permisos de IAM:

bash

# Check node IAM role permissions
aws iam list-attached-role-policies --role-name <node-role-name>

Common Solutions

Instalar EBS CSI Driver:

bash

# Install EBS CSI driver using eksctl
eksctl create addon \
  --cluster my-cluster \
  --name aws-ebs-csi-driver \
  --service-account-role-arn <role-arn>

Agregar permisos de IAM:

bash

# Attach EBS CSI driver policy
aws iam attach-role-policy \
  --role-name <role-name> \
  --policy-arn arn:aws:iam::aws:policy/service-role/AmazonEBSCSIDriverPolicy

Crear StorageClass:

bash

# Create StorageClass
cat <<EOF | kubectl apply -f -
apiVersion: storage.k8s.io/v1
kind: StorageClass
metadata:
  name: ebs-sc
provisioner: ebs.csi.aws.com
parameters:
  type: gp3
  fsType: ext4
volumeBindingMode: WaitForFirstConsumer
EOF

EFS Volume Issues

Common Causes

Causas comunes de problemas de EFS volume:

EFS CSI Driver no instalado: El EFS CSI driver no está instalado
Problemas de Security Group: Las reglas de security group impiden el acceso a EFS
Problemas de Mount Target: Los mount targets de EFS no están configurados
Problemas de permisos de IAM: Al IAM role del node le faltan permisos de EFS

Troubleshooting Steps

Comprobar EFS CSI Driver:

bash

# Check EFS CSI driver
kubectl get pods -n kube-system -l app=efs-csi-controller

Comprobar sistema de archivos EFS:

bash

# Check EFS file system
aws efs describe-file-systems --file-system-id <file-system-id>

# Check mount targets
aws efs describe-mount-targets --file-system-id <file-system-id>

Comprobar Security Groups:

bash

# Check EFS security group
aws ec2 describe-security-groups --group-ids <efs-security-group-id>

Common Solutions

Instalar EFS CSI Driver:

bash

# Install EFS CSI driver
kubectl apply -k "github.com/kubernetes-sigs/aws-efs-csi-driver/deploy/kubernetes/overlays/stable/?ref=release-1.5"

Configurar Security Groups:

bash

# Allow NFS traffic
aws ec2 authorize-security-group-ingress \
  --group-id <efs-security-group-id> \
  --protocol tcp \
  --port 2049 \
  --source-group <node-security-group-id>

Crear Mount Targets:

bash

# Create mount target
aws efs create-mount-target \
  --file-system-id <file-system-id> \
  --subnet-id <subnet-id> \
  --security-groups <security-group-id>

Logging and Monitoring Issues

CloudWatch Issues

Common Causes

Causas comunes de problemas de CloudWatch:

CloudWatch Agent no instalado: El CloudWatch agent no está instalado
Problemas de permisos de IAM: Al IAM role del node le faltan permisos de CloudWatch
Problemas de configuración de Log Group: El log group no está configurado
Problemas de configuración del Agent: El CloudWatch agent está mal configurado

Troubleshooting Steps

Comprobar CloudWatch Agent:

bash

# Check CloudWatch agent pods
kubectl get pods -n amazon-cloudwatch -l name=cloudwatch-agent

Comprobar permisos de IAM:

bash

# Check node IAM role permissions
aws iam list-attached-role-policies --role-name <node-role-name>

Comprobar Log Groups:

bash

# Check log groups
aws logs describe-log-groups --log-group-name-prefix /aws/eks/my-cluster

Common Solutions

Instalar CloudWatch Agent:

bash

# Install CloudWatch Container Insights
kubectl apply -f https://raw.githubusercontent.com/aws-samples/amazon-cloudwatch-container-insights/latest/k8s-deployment-manifest-templates/deployment-mode/daemonset/container-insights-monitoring/quickstart/cwagent-fluentd-quickstart.yaml

Agregar permisos de IAM:

bash

# Attach CloudWatch policy
aws iam attach-role-policy \
  --role-name <node-role-name> \
  --policy-arn arn:aws:iam::aws:policy/CloudWatchAgentServerPolicy

Prometheus and Grafana Issues

Common Causes

Causas comunes de problemas de Prometheus y Grafana:

Prometheus no instalado: Prometheus no está instalado correctamente
Problemas de Scrape Target: Los scrape targets no están configurados
Problemas de Storage: Problemas de storage de Prometheus
Problemas de Data Source de Grafana: El data source de Grafana está mal configurado

Troubleshooting Steps

Comprobar Pods de Prometheus:

bash

# Check Prometheus pods
kubectl get pods -n monitoring -l app=prometheus
kubectl logs -n monitoring -l app=prometheus

Comprobar targets de Prometheus:

bash

# Port forward to Prometheus
kubectl port-forward -n monitoring svc/prometheus-server 9090:80

# Check targets in browser: http://localhost:9090/targets

Comprobar Pods de Grafana:

bash

# Check Grafana pods
kubectl get pods -n monitoring -l app=grafana
kubectl logs -n monitoring -l app=grafana

Common Solutions

Instalar Prometheus usando Helm:

bash

# Install Prometheus
helm repo add prometheus-community https://prometheus-community.github.io/helm-charts
helm install prometheus prometheus-community/prometheus -n monitoring --create-namespace

Configurar ServiceMonitor:

bash

# Create ServiceMonitor
cat <<EOF | kubectl apply -f -
apiVersion: monitoring.coreos.com/v1
kind: ServiceMonitor
metadata:
  name: my-app
  namespace: monitoring
spec:
  selector:
    matchLabels:
      app: my-app
  endpoints:
  - port: metrics
    interval: 30s
EOF

Performance Issues

Node Performance Issues

Common Causes

Causas comunes de problemas de rendimiento de nodes:

Restricciones de recursos: CPU o memoria insuficientes
Cuellos de botella de red: Limitaciones de ancho de banda de red
Problemas de Disk I/O: Cuellos de botella de Disk I/O
Desajuste de tipo de instancia: El tipo de instancia no coincide con los requisitos de la workload

Troubleshooting Steps

Comprobar uso de recursos del Node:

bash

# Check node resources
kubectl top nodes
kubectl describe node <node-name>

Comprobar rendimiento del sistema:

bash

# Connect to node
aws ssm start-session --target <instance-id>

# Check CPU usage
top

# Check memory usage
free -m

# Check disk I/O
iostat -x 1

Common Solutions

Escalar Node Group:

bash

# Scale node group
aws eks update-nodegroup-config \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name> \
  --scaling-config desiredSize=<size>,minSize=<min>,maxSize=<max>

Usar un tipo de instancia más grande:

bash

# Create new node group with larger instance type
eksctl create nodegroup \
  --cluster my-cluster \
  --name <new-nodegroup-name> \
  --node-type <larger-instance-type> \
  --nodes <node-count>

Pod Performance Issues

Common Causes

Causas comunes de problemas de rendimiento de pods:

Resource Limits: Resource limits demasiado restrictivos
Problemas de aplicación: Problemas de rendimiento de la aplicación
Problemas de red: Problemas de latencia o ancho de banda de red
Problemas de Storage: Problemas de rendimiento de storage

Troubleshooting Steps

Comprobar uso de recursos del Pod:

bash

# Check pod resources
kubectl top pods -n <namespace>
kubectl describe pod <pod-name> -n <namespace>

Comprobar logs de la aplicación:

bash

# Check application logs
kubectl logs <pod-name> -n <namespace>

Common Solutions

Ajustar Resource Limits:

bash

# Adjust resource limits
kubectl patch deployment <deployment-name> -n <namespace> -p '{"spec":{"template":{"spec":{"containers":[{"name":"<container-name>","resources":{"limits":{"memory":"1Gi","cpu":"1000m"}}}]}}}}'

Habilitar HPA:

bash

# Create HPA
kubectl autoscale deployment <deployment-name> -n <namespace> --cpu-percent=70 --min=2 --max=10

Upgrade Issues

Cluster Upgrade Issues

Common Causes

Causas comunes de problemas de upgrade del cluster:

Compatibilidad de versiones: Versiones de Kubernetes incompatibles
Compatibilidad de Add-on: Add-ons incompatibles con la nueva versión
Deprecación de API: APIs deprecadas en uso
Problemas de Custom Resource: CRDs incompatibles con la nueva versión

Troubleshooting Steps

Comprobar versión actual:

bash

# Check cluster version
aws eks describe-cluster --name my-cluster --query "cluster.version"

# Check node versions
kubectl get nodes -o wide

Comprobar compatibilidad de Add-on:

bash

# Check add-on versions
aws eks describe-addon-versions --kubernetes-version <target-version>

Comprobar APIs deprecadas:

bash

# Install pluto
brew install fairwindsops/tap/pluto

# Check deprecated APIs
pluto detect-files -d .
pluto detect-helm -A

Common Solutions

Actualizar el Control Plane del Cluster:

bash

# Upgrade cluster
aws eks update-cluster-version \
  --name my-cluster \
  --kubernetes-version <target-version>

Actualizar Add-ons:

bash

# Upgrade add-ons
aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name vpc-cni \
  --addon-version <target-version> \
  --resolve-conflicts PRESERVE

aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name coredns \
  --addon-version <target-version> \
  --resolve-conflicts PRESERVE

aws eks update-addon \
  --cluster-name my-cluster \
  --addon-name kube-proxy \
  --addon-version <target-version> \
  --resolve-conflicts PRESERVE

Node Group Upgrade Issues

Common Causes

Causas comunes de problemas de upgrade de node group:

Compatibilidad de AMI: AMI no compatible con la versión del cluster
PodDisruptionBudget: PDB que impide el desalojo de pods
Fallo de drain de Node: Fallo de drain del node
Restricciones de recursos: Recursos insuficientes para nuevos nodes

Troubleshooting Steps

Comprobar estado del Node Group:

bash

# Check node group status
aws eks describe-nodegroup \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name>

Comprobar PodDisruptionBudgets:

bash

# Check PDBs
kubectl get pdb --all-namespaces
kubectl describe pdb <pdb-name> -n <namespace>

Comprobar estado de drain del Node:

bash

# Check node status
kubectl get nodes
kubectl describe node <node-name>

Common Solutions

Actualizar Node Group:

bash

# Update node group
aws eks update-nodegroup-version \
  --cluster-name my-cluster \
  --nodegroup-name <nodegroup-name>

Ajustar PodDisruptionBudget:

bash

# Temporarily modify PDB
kubectl patch pdb <pdb-name> -n <namespace> -p '{"spec":{"minAvailable":0}}'

Forzar drain del Node:

bash

# Force drain node
kubectl drain <node-name> --ignore-daemonsets --delete-emptydir-data --force

Common Error Messages and Solutions

Cluster Errors

`error: You must be logged in to the server (Unauthorized)`

Causa: Problemas de autenticación con el cluster.

Solución:

Comprueba las credenciales de AWS CLI
Regenera kubeconfig
Comprueba aws-auth ConfigMap

bash

# Check AWS CLI credentials
aws sts get-caller-identity

# Regenerate kubeconfig
aws eks update-kubeconfig --name my-cluster --region <region>

`Unable to connect to the server: dial tcp: lookup xxx: no such host`

Causa: Problema de resolución DNS o problema con el endpoint del cluster.

Solución:

Comprueba el endpoint del cluster
Comprueba la configuración de DNS
Comprueba la conectividad de red

bash

# Check cluster endpoint
aws eks describe-cluster --name my-cluster --query "cluster.endpoint"

# Check DNS resolution
nslookup <cluster-endpoint>

Node and Pod Errors

`Insufficient pods`

Causa: El node ha alcanzado el número máximo de pods.

Solución:

Agrega más nodes
Usa tipos de instancia más grandes
Habilita prefix delegation

bash

# Check node pod capacity
kubectl describe node <node-name> | grep -A 5 "Capacity"

# Reduce pod resource requests
kubectl patch deployment <deployment-name> -n <namespace> -p '{"spec":{"template":{"spec":{"containers":[{"name":"<container-name>","resources":{"requests":{"memory":"128Mi"}}}]}}}}'

`CrashLoopBackOff`

Causa: El container se bloquea repetidamente y se reinicia.

Solución:

Comprueba los logs del container
Comprueba la configuración de la aplicación
Comprueba las restricciones de recursos

bash

# Check container logs
kubectl logs <pod-name> -n <namespace>
kubectl logs <pod-name> -n <namespace> --previous

`ImagePullBackOff`

Causa: No se puede descargar la imagen del container.

Solución:

Comprueba el nombre y tag de la imagen
Comprueba la accesibilidad del registro de imágenes
Configura image pull secrets

bash

# Create image pull secret
kubectl create secret docker-registry <secret-name> \
  --docker-server=<registry-server> \
  --docker-username=<username> \
  --docker-password=<password> \
  --docker-email=<email> \
  -n <namespace>

# Add secret to service account
kubectl patch serviceaccount <service-account-name> -n <namespace> -p '{"imagePullSecrets":[{"name":"<secret-name>"}]}'

`Evicted`

Causa: El Pod fue desalojado debido a presión de recursos del node.

Solución:

Comprueba los recursos del node
Ajusta resource requests y limits del pod
Escala horizontalmente el node group

bash

# Check node resources
kubectl describe node <node-name> | grep -A 10 "Allocated resources"

Networking Errors

`FailedCreateServiceEndpoints`

Causa: No se pueden crear endpoints del service.

Solución:

Comprueba el selector del service
Comprueba las labels de los pods
Comprueba el estado de los pods

bash

# Check service selector
kubectl get service <service-name> -n <namespace> -o jsonpath='{.spec.selector}'

# Check pod labels
kubectl get pods -n <namespace> --show-labels

`EniLimitExceeded`

Causa: Se ha excedido el límite de ENI del node.

Solución:

Actualiza el node group con un tipo de instancia más grande
Habilita prefix delegation
Habilita custom networking

bash

# Enable prefix delegation
kubectl set env daemonset aws-node -n kube-system ENABLE_PREFIX_DELEGATION=true

`FailedLoadBalancerCreation`

Causa: No se puede crear el load balancer.

Solución:

Comprueba los tags de subnet
Comprueba las reglas de security group
Comprueba las anotaciones del service

bash

# Add subnet tags
aws ec2 create-tags \
  --resources <subnet-id-1> <subnet-id-2> \
  --tags Key=kubernetes.io/role/elb,Value=1

IAM and Authentication Errors

`error: You must be logged in to the server (Unauthorized)`

Causa: Problemas de autenticación con el cluster.

Solución:

Comprueba las credenciales de AWS CLI
Regenera kubeconfig
Comprueba aws-auth ConfigMap

bash

# Check AWS CLI credentials
aws sts get-caller-identity

# Regenerate kubeconfig
aws eks update-kubeconfig --name my-cluster --region <region>

`error: You must be logged in to the server (the server has asked for the client to provide credentials)`

Causa: Problemas de autenticación de IAM.

Solución:

Comprueba las credenciales de AWS CLI
Comprueba aws-auth ConfigMap
Agrega mapeo de IAM role o usuario

bash

# Check aws-auth ConfigMap
kubectl get configmap aws-auth -n kube-system -o yaml

# Add IAM role or user mapping
eksctl create iamidentitymapping \
  --cluster my-cluster \
  --arn <iam-role-or-user-arn> \
  --username <username> \
  --group system:masters

`error: error loading config file "/home/user/.kube/config": open /home/user/.kube/config: permission denied`

Causa: Problemas de permisos del archivo kubeconfig.

Solución:

Corrige los permisos del archivo kubeconfig
Regenera el archivo kubeconfig

bash

# Fix kubeconfig file permissions
chmod 600 ~/.kube/config

# Regenerate kubeconfig file
aws eks update-kubeconfig --name my-cluster --region <region>

Storage Errors

`FailedAttachVolume: Multi-Attach error for volume`

Causa: El volume ya está asociado a otro node.

Solución:

Elimina el pod anterior
Desasocia manualmente el volume
Reinicia el node

bash

# Delete previous pod
kubectl delete pod <old-pod-name> -n <namespace>

# Manually detach volume
aws ec2 detach-volume --volume-id <volume-id>

`FailedMount: Unable to mount volumes for pod: timeout expired waiting for volumes to attach or mount`

Causa: No se puede montar el volume.

Solución:

Comprueba el estado del volume
Comprueba el CSI driver
Reinicia el node

bash

# Check volume status
aws ec2 describe-volumes --volume-ids <volume-id>

# Check CSI driver
kubectl get pods -n kube-system -l app=ebs-csi-controller
kubectl logs -n kube-system -l app=ebs-csi-controller -c ebs-plugin

`PersistentVolumeClaim is not bound`

Causa: El PVC no está vinculado a un PV.

Solución:

Comprueba el estado de PVC y PV
Comprueba StorageClass
Comprueba el modo de volume binding

bash

# Check PVC status
kubectl describe pvc <pvc-name> -n <namespace>

# Check PV status
kubectl get pv

# Check StorageClass
kubectl get storageclass

Logging and Monitoring Errors

`Failed to list *v1.Pod: Unauthorized`

Causa: Problemas de autenticación con el metrics server.

Solución:

Comprueba el service account del metrics server
Comprueba la configuración RBAC
Reinicia el metrics server

bash

# Restart metrics server
kubectl delete pod -n kube-system -l k8s-app=metrics-server

`Failed to scrape node`

Causa: Metrics server no puede recopilar métricas del node.

Solución:

Comprueba la configuración de kubelet
Comprueba la configuración del metrics server
Comprueba la conectividad de red

bash

# Check kubelet configuration
aws ssm start-session --target <instance-id>
sudo cat /etc/kubernetes/kubelet/kubelet-config.json

`Failed to list *v1.Pod: the server could not find the requested resource`

Causa: Problemas de configuración del API server.

Solución:

Comprueba la configuración del API server
Comprueba la versión del cluster
Reinstala metrics server

bash

# Reinstall metrics server
kubectl apply -f https://github.com/kubernetes-sigs/metrics-server/releases/latest/download/components.yaml

Quiz

Para probar lo que aprendiste en este capítulo, intenta el quiz del tema.

Laboratorios integrales de observabilidad

Cuestionario de ArgoCD en detalle

Cuestionario de Istio detallado

Cuestionario de Linkerd detallado

Cuestionario de Cilium Service Mesh detallado

Profundización en Cilium

Profundización en Calico

Métricas

Registro

Trazado

Alertas

Laboratorios de observabilidad

ArgoCD

Gestión del tráfico

Seguridad

Observabilidad

Resiliencia

Avanzado

Guía comparativa

Métricas

Registro

Trazado

Alertas

Amazon EKS Troubleshooting ​

Table of Contents ​

Troubleshooting Basics ​

Troubleshooting Approach ​

Essential Tools and Commands ​

AWS CLI ​

kubectl ​

eksctl ​

AWS CloudWatch ​

Log Collection and Analysis ​

EKS Control Plane Logs ​

Node Logs ​

Pod Logs ​

Diagnostic Information Collection ​

Cluster Diagnostic Information ​

System Resource Information ​

Network Diagnostics ​

Cluster Creation and Management Issues ​

Cluster Creation Failure ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Cluster Endpoint Access Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Cluster Deletion Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Networking Issues ​

Pod-to-Pod Communication Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Service Access Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Load Balancer Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

DNS Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

VPC CNI Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Node and Pod Issues ​

Node NotReady Issues ​

Common Causes ​

Troubleshooting Steps ​

Common Solutions ​

Pod Not Running Issues ​

Amazon EKS Troubleshooting

Table of Contents

Troubleshooting Basics

Troubleshooting Approach

Essential Tools and Commands

AWS CLI

kubectl

eksctl

AWS CloudWatch

Log Collection and Analysis

EKS Control Plane Logs

Node Logs

Pod Logs

Diagnostic Information Collection

Cluster Diagnostic Information

System Resource Information

Network Diagnostics

Cluster Creation and Management Issues

Cluster Creation Failure

Common Causes

Troubleshooting Steps

Common Solutions

Cluster Endpoint Access Issues

Common Causes

Troubleshooting Steps

Common Solutions

Cluster Deletion Issues

Common Causes

Troubleshooting Steps

Common Solutions

Networking Issues

Pod-to-Pod Communication Issues

Common Causes

Troubleshooting Steps

Common Solutions

Service Access Issues

Common Causes

Troubleshooting Steps

Common Solutions

Load Balancer Issues

Common Causes

Troubleshooting Steps

Common Solutions

DNS Issues

Common Causes

Troubleshooting Steps

Common Solutions

VPC CNI Issues

Common Causes

Troubleshooting Steps

Common Solutions

Node and Pod Issues

Node NotReady Issues

Common Causes

Troubleshooting Steps

Common Solutions

Pod Not Running Issues

Common Causes

Troubleshooting Steps

Common Solutions

Resource Constraint Issues

Common Causes

Troubleshooting Steps

Common Solutions

IAM and Authentication Issues

Cluster Access Denied

Common Causes

Troubleshooting Steps

Common Solutions

IRSA Issues

Common Causes

Troubleshooting Steps

Common Solutions

Node Join Failure

Common Causes

Troubleshooting Steps

Common Solutions

Storage Issues

EBS Volume Issues

Common Causes