Todas las guías
  1. Inicio
  2. Guías técnicas
  3. Cloud

CloudNivel intermedio

Administración de Kubernetes en AKS, GKE y EKS: guía práctica

6 min de lectura

Todas las guías

Administración de Kubernetes en AKS, GKE y EKS: guía práctica

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 de kubectl son 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

TareaAKS (Azure)GKE (Google Cloud)EKS (AWS)
Conectarseaz aks get-credentialsgcloud container clusters get-credentialsaws eks update-kubeconfig
Escalar nodosaz aks nodepool scalegcloud container clusters resizeeksctl scale nodegroup
Actualizar versiónaz aks upgradegcloud container clusters upgradeeksctl upgrade cluster
Registro de imágenesAzure Container RegistryArtifact RegistryAmazon ECR
Autenticación de usuariosMicrosoft Entra IDIAM de Google CloudIAM 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).

Compartir

Más guías sobre

Ver todas las guías

Otras guías técnicas

Ver todas las guías

APIsIntermedio

Estructura básica de una API en IBM API Connect 10

Cómo se estructura una API en IBM API Connect 10: contrato OpenAPI con x-ibm-configuration, Client ID y Client Secret, producto con planes y límites, y validación y publicación con el CLI apic.

Leer la guía 7 min de lectura

IntegraciónIntermedio

Comandos básicos de administración de TIBCO ActiveSpaces 5.2

Los comandos del día a día en TIBCO ActiveSpaces 5.2: servicio de realm sobre servidores FTL, tibdg, definición del grid, tablas, arranque de procesos, estado, escalado con copysets, checkpoints y logs.

Leer la guía 8 min de lectura

DevOpsBásico

Estructura básica de un CI/CD con GitHub Actions

Un pipeline completo con GitHub Actions: pruebas en cada push y pull request, imagen Docker en GitHub Container Registry y despliegue a un entorno protegido, con un workflow listo para copiar.

Leer la guía 6 min de lectura

DesarrolloBásico

Buenas prácticas de desarrollo en Java con Spring Boot

Las prácticas que más se notan en un servicio Spring Boot: estructura, inyección por constructor, DTOs, validación, errores, configuración, transacciones, logs, comentarios, pruebas y calidad automatizada.

Leer la guía 8 min de lectura

Contacto

Construye hoy tu próxima ventaja competitiva

Hablemos sobre cómo podemos ayudarte. Te respondemos con una propuesta técnica clara, sin compromiso.

Solicita información

Los campos marcados con son obligatorios.