# Administración de Kubernetes en AKS, GKE y EKS

Guía de Bitflow Solutions. Versión web: https://bitflow-solutions.com/guias-tecnicas/administracion-kubernetes-aks-gke-eks/

## ¿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

### Instalar herramientas

```powershell
# 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)
```

### Conectarse al clúster

```powershell
# 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
```

### Contextos

```powershell
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
```

### Estado

```powershell
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
```

### Diagnóstico

```powershell
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
```

### Despliegues

```powershell
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
```

### Escalar nodos

```powershell
# 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
```

### Mantenimiento de un nodo

```powershell
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
```

### Actualizar Kubernetes

```powershell
# 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
```

### Deployment básico

```yaml
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
```

### Equivalencias

| Tarea | AKS | GKE | EKS |
|---|---|---|---|
| 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 | az aks upgrade | gcloud container clusters upgrade | eksctl upgrade cluster |
| Registro | Azure Container Registry | Artifact Registry | Amazon ECR |

## 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).
