Una guía práctica de administración de Kubernetes en los tres servicios gestionados más habituales: AKS (Azure), GKE (Google Cloud) y EKS (AWS). Los comandos de kubectl son los mismos en las tres; lo que cambia es cómo te conectas, escalas los nodos y actualizas el clúster, y aquí lo tienes lado a lado. Todos los comandos están también en el README.md de la izquierda.
¿Qué vas a aprender?
- Conectarte a un clúster de AKS, GKE o EKS desde Windows y moverte entre clústeres sin equivocarte.
- Revisar el estado de nodos, pods y servicios, y diagnosticar un pod que falla.
- Desplegar, escalar y deshacer un despliegue con
kubectl. - Escalar nodos, hacer mantenimiento de un nodo y actualizar la versión de Kubernetes en cada nube.
Requisitos previos
- Un clúster de AKS, GKE o EKS, y permisos para administrarlo en esa nube.
- Windows con PowerShell y
winget(los comandos dekubectlson iguales en macOS y Linux). - Para EKS, eksctl (ver su guía de instalación oficial).
- Conocer los objetos básicos de Kubernetes: pod, deployment, service y namespace.
Paso a paso
1. Instala las herramientas
kubectl es la herramienta común; cada nube añade su CLI para crear credenciales y administrar la infraestructura:
# kubectl (común a las tres nubes)
winget install -e --id Kubernetes.kubectl
# El CLI de tu nube
winget install -e --id Microsoft.AzureCLI # Azure (AKS)
winget install -e --id Google.CloudSDK # Google Cloud (GKE)
winget install -e --id Amazon.AWSCLI # AWS (EKS)
Cierra y vuelve a abrir PowerShell, y comprueba con kubectl version --client.
2. Conéctate al clúster
Cada CLI descarga las credenciales del clúster y las añade a tu archivo ~/.kube/config:
# AKS
az login
az aks get-credentials --resource-group rg-produccion --name aks-produccion
# GKE (necesita el complemento de autenticación)
gcloud auth login
gcloud components install gke-gcloud-auth-plugin
gcloud container clusters get-credentials gke-produccion --region europe-southwest1 --project mi-proyecto
# EKS
aws configure
aws eks update-kubeconfig --region eu-south-2 --name eks-produccion
3. Muévete entre clústeres sin equivocarte
Cada clúster es un contexto. Antes de cualquier cambio, comprueba en cuál estás: un comando en el contexto equivocado puede afectar a producción.
kubectl config get-contexts # todos los clústeres configurados
kubectl config current-context # en cuál estás
kubectl config use-context aks-produccion
kubectl config set-context --current --namespace=pedidos # namespace por defecto
4. Revisa el estado del clúster
kubectl get nodes -o wide # nodos, versión, IP y estado
kubectl get pods -A # todos los pods de todos los namespaces
kubectl get pods -n pedidos -o wide # pods de un namespace y en qué nodo están
kubectl get deploy,svc,ingress -n pedidos
kubectl top nodes # consumo de CPU y memoria (necesita metrics-server)
kubectl top pods -n pedidos
5. Diagnostica un pod que falla
El orden habitual: describe para ver los eventos y el motivo, logs (con --previous si se reinició) para ver el error de la aplicación y, si hace falta, entrar en el contenedor:
kubectl describe pod api-tareas-7c9d8 -n pedidos # estado, eventos y motivo de fallo
kubectl logs api-tareas-7c9d8 -n pedidos # logs del contenedor
kubectl logs -f deploy/api-tareas -n pedidos # seguir los logs en vivo
kubectl logs api-tareas-7c9d8 -n pedidos --previous # logs del contenedor anterior (tras un reinicio)
kubectl get events -n pedidos --sort-by=.lastTimestamp
kubectl exec -it api-tareas-7c9d8 -n pedidos -- sh # entrar en el contenedor
kubectl port-forward svc/api-tareas 8080:80 -n pedidos # probar un servicio interno en localhost:8080
6. Despliega, escala y deshaz cambios
Un Deployment básico, con recursos y comprobaciones de salud, que es lo que más estabilidad da:
apiVersion: apps/v1
kind: Deployment
metadata:
name: api-tareas
namespace: pedidos
spec:
replicas: 2
selector:
matchLabels:
app: api-tareas
template:
metadata:
labels:
app: api-tareas
spec:
containers:
- name: api
image: ghcr.io/empresa/api-tareas:1.4.0
ports:
- containerPort: 80
resources:
requests:
cpu: 100m
memory: 128Mi
limits:
memory: 256Mi
readinessProbe:
httpGet:
path: /
port: 80
livenessProbe:
httpGet:
path: /
port: 80
Y los comandos del día a día:
kubectl apply -f deployment.yaml # crear o actualizar desde un archivo
kubectl set image deployment/api-tareas api=ghcr.io/empresa/api-tareas:1.4.0 -n pedidos
kubectl rollout status deployment/api-tareas -n pedidos # esperar a que termine
kubectl rollout history deployment/api-tareas -n pedidos
kubectl rollout undo deployment/api-tareas -n pedidos # volver a la versión anterior
kubectl rollout restart deployment/api-tareas -n pedidos # reiniciar todos los pods ordenadamente
kubectl scale deployment/api-tareas --replicas=4 -n pedidos
7. Escala los nodos
Más réplicas de pods necesitan más nodos. Cada nube escala sus grupos de nodos con su propio CLI (o con el autoescalado del clúster, si lo activas):
# AKS
az aks nodepool scale --resource-group rg-produccion --cluster-name aks-produccion --name nodepool1 --node-count 4
# GKE
gcloud container clusters resize gke-produccion --node-pool default-pool --num-nodes 4 --region europe-southwest1
# EKS (con eksctl)
eksctl scale nodegroup --cluster eks-produccion --name ng-general --nodes 4
8. Haz mantenimiento de un nodo
Antes de reiniciar o sustituir un nodo, vacíalo: cordon impide que reciba pods nuevos y drain mueve los que tiene a otros nodos respetando los PodDisruptionBudget:
kubectl cordon aks-nodepool1-12345678-vmss000002 # no programar pods nuevos en el nodo
kubectl drain aks-nodepool1-12345678-vmss000002 --ignore-daemonsets --delete-emptydir-data
# ... mantenimiento del nodo ...
kubectl uncordon aks-nodepool1-12345678-vmss000002 # vuelve a recibir pods
9. Actualiza la versión de Kubernetes
Las tres nubes actualizan primero el plano de control y después los nodos, de versión menor en versión menor. Revisa antes las notas de la versión por si alguna API que usas se retira:
# AKS: versiones disponibles y actualización
az aks get-upgrades --resource-group rg-produccion --name aks-produccion --output table
az aks upgrade --resource-group rg-produccion --name aks-produccion --kubernetes-version 1.31.2
# GKE: primero el plano de control, después los node pools
gcloud container clusters upgrade gke-produccion --master --cluster-version 1.31 --region europe-southwest1
gcloud container clusters upgrade gke-produccion --node-pool default-pool --region europe-southwest1
# EKS: plano de control y después los node groups
eksctl upgrade cluster --name eks-produccion --approve
eksctl upgrade nodegroup --cluster eks-produccion --name ng-general
10. Ten a mano las equivalencias entre nubes
| Tarea | AKS (Azure) | GKE (Google Cloud) | EKS (AWS) |
|---|---|---|---|
| Conectarse | az aks get-credentials | gcloud container clusters get-credentials | aws eks update-kubeconfig |
| Escalar nodos | az aks nodepool scale | gcloud container clusters resize | eksctl scale nodegroup |
| Actualizar versión | az aks upgrade | gcloud container clusters upgrade | eksctl upgrade cluster |
| Registro de imágenes | Azure Container Registry | Artifact Registry | Amazon ECR |
| Autenticación de usuarios | Microsoft Entra ID | IAM de Google Cloud | IAM y access entries |
Errores habituales
CrashLoopBackOff
El contenedor arranca y se cae una y otra vez. Mira kubectl logs <pod> --previous: suele ser un error de la aplicación, una variable de entorno o un secreto que falta, o una conexión que no se puede establecer.
ImagePullBackOff o ErrImagePull
No puede descargar la imagen: nombre o etiqueta mal escritos, o el clúster no tiene permiso para el registro. En AKS, az aks update --resource-group rg --name aks --attach-acr mi-registro; en el resto, un imagePullSecrets o los permisos de IAM del nodo.
Pod en Pending
Ningún nodo puede alojarlo. kubectl describe pod dice por qué: falta CPU o memoria, un nodeSelector o una toleration que no encaja, o un volumen que no se puede montar. Escala los nodos o ajusta los requests.
OOMKilled
El contenedor superó su límite de memoria y Kubernetes lo mató. Sube limits.memory o revisa el consumo de la aplicación con kubectl top pods.
«You must be logged in to the server (Unauthorized)»
Las credenciales caducaron o tu usuario no tiene acceso. Vuelve a ejecutar el comando de credenciales del paso 2; en EKS, tu usuario o rol de IAM debe tener una access entry en el clúster.
«gke-gcloud-auth-plugin not found»
Desde la versión 1.26, kubectl necesita el complemento de autenticación de Google. Instálalo con gcloud components install gke-gcloud-auth-plugin y vuelve a pedir las credenciales.
«drain» se queda esperando
Un PodDisruptionBudget no permite sacar más pods de esa aplicación. Comprueba con kubectl get pdb -A y aumenta las réplicas antes de vaciar el nodo.
Siguientes pasos
- Automatizar los despliegues con un pipeline (ver la guía de CI/CD con GitHub Actions).
- Activar el autoescalado de pods (Horizontal Pod Autoscaler) y de nodos (cluster autoscaler).
- Describir la infraestructura con Terraform para crear y actualizar los clústeres de forma reproducible.
- Centralizar logs y métricas (por ejemplo, Prometheus y Grafana) y definir alertas.
- Gestionar los despliegues con GitOps (Argo CD o Flux).