modificada estructura de la documentacion

This commit is contained in:
2025-07-24 18:23:13 +02:00
parent b934759ceb
commit 7fef3ea20b
9 changed files with 248 additions and 236 deletions

View File

@@ -1,12 +1,19 @@
# **Comprobaciones y diagnóstico habitual**
### Estado de pods y despliegues
### Estado de nodos, pods y despliegues
```bash
kubectl get nodes -o wide # Estado y detalles de los nodos
kubectl describe node <nombre-nodo> # Info detallada, condiciones, taints, eventos
kubectl get pods -A # Todos los pods de todos los namespaces
kubectl get pods -n traefik # Sólo los pods de Traefik
kubectl get pods -n cert-manager # Sólo cert-manager
kubectl get deployments -A # Todos los deployments
kubectl get events -A | tail -20 # Últimos eventos del clúster (errores recientes)
```
*Todos los pods deben estar en estado `Running` o `Completed`. Si alguno está en `CrashLoopBackOff` o `Error`, inspecciona con:*
@@ -14,6 +21,13 @@ kubectl get deployments -A # Todos los deployments
```bash
kubectl describe pod <nombre-pod> -n <namespace>
kubectl logs <nombre-pod> -n <namespace>
kubectl logs -f <nombre-pod> -n <namespace> # Logs en streaming (útil en troubleshooting)
```
### Estado de los control-plane y componentes críticos
```bash
kubectl get pods -n kube-system -o wide # Componentes internos: etcd, coredns, apiserver, controller, etc.
kubectl logs -n kube-system <nombre-pod> # Logs de cualquier pod de kube-system
```
### Servicios, IPs y estado MetalLB
@@ -21,6 +35,7 @@ kubectl logs <nombre-pod> -n <namespace>
```bash
kubectl get svc -A # Todos los servicios, revisa columna EXTERNAL-IP
kubectl get svc -n traefik # Servicio LoadBalancer de Traefik debe tener IP de MetalLB
kubectl describe svc <nombre-svc> -n <ns> # Ver detalles de servicio, endpoints, ports, etc.
```
### Certificados, secrets y recursos cert-manager
@@ -28,9 +43,12 @@ kubectl get svc -n traefik # Servicio LoadBalancer de Traefik
```bash
kubectl get secrets -n traefik # Verifica el Secret TLS (ej: wildcard-cert)
kubectl describe secret wildcard-cert -n traefik
kubectl get certificate -A # (cert-manager) lista los recursos Certificate gestionados
kubectl describe certificate <name> -n <ns> # Ver detalle y posibles errores
kubectl get clusterissuer,issuer -A # Ver emisores de cert-manager (staging, prod, etc.)
kubectl describe clusterissuer <name> # Detalles y eventos del issuer global
```
### Ingress, dominios y rutas