En este documento, se enumeran los documentos de solución de problemas para problemas comunes que puedes encontrar cuando usas Google Kubernetes Engine (GKE). Ya sea que estés diagnosticando errores de cargas de trabajo como ImagePullBackOff y CrashLoopBackOff, depurando el comportamiento del ajuste de escala automático del clúster, resolviendo problemas de PersistentVolume o solucionando problemas de registro de nodos, los documentos que se enumeran aquí pueden ayudarte.
Este documento está destinado a administradores y arquitectos, especialistas en seguridad, especialistas en redes o especialistas en almacenamiento que solucionan problemas de configuraciones de GKE. Para obtener más información sobre los roles de GKE,
consulta
Roles y tareas comunes del usuario de GKE.
Diagnostica y soluciona problemas de los clústeres de Autopilot de GKE, incluidos los problemas de creación de clústeres, eliminación de espacios de nombres, ajuste de escala y cargas de trabajo.
Soluciona problemas de la herramienta de línea de comandos de kubectl en
GKE, incluidos los problemas de autenticación y autorización.
Esta página también incluye sugerencias para solucionar problemas del proxy de Konnectivity y verificar si está causando que los comandos kubectl logs, attach, exec o port-forward dejen de responder.
Soluciona problemas de grupos de nodos de GKE Standard,
incluidos los problemas relacionados con la creación de grupos de nodos, el aprovisionamiento de mejor esfuerzo,
los metadatos de instancias dañados y la migración de cargas de trabajo a grupos de nodos nuevos.
Aprende a diagnosticar y resolver el estado NotReady
del nodo en GKE solucionando problemas de causas comunes, como
la escasez de recursos, los problemas de red y las fallas de componentes.
Soluciona problemas que ocurren cuando agregas nodos a tu
clúster de GKE Standard, como fallas en el registro de nodos
y la falta de requisitos previos para el registro correcto de nodos.
Soluciona problemas de entornos de ejecución de contenedores en GKE, incluidos
problemas relacionados con containerd y dockershim, y
registros privados.
Soluciona problemas de grupos de nodos de Windows Server en GKE,
incluidas las fallas de inicio de Pods, los errores de extracción de imágenes, los problemas de conectividad de red
y los problemas de estado de los nodos.
Diagnostica y resuelve los motivos comunes por los que tu clúster no quita los nodos subutilizados. Aprende a verificar problemas como
PodDisruptionBudgets restrictivos, Pods con almacenamiento local o anotaciones específicas
(por ejemplo, "cluster-autoscaler.kubernetes.io/safe-to-evict": "false")
que impiden el desalojo de nodos.
Descubre por qué el escalador automático de clústeres no agrega nodos nuevos para satisfacer la demanda.
Verifica si hay Pods no programables, verifica que no hayas alcanzado los límites de tamaño del clúster o del grupo de nodos
y, luego, identifica posibles problemas de cuota de recursos o disponibilidad de VM regionales.
Soluciona problemas relacionados con el Horizontal Pod Autoscaler que no ajusta la escala de las réplicas de Pod de tu aplicación. Resuelve problemas comunes, como
recursos HorizontalPodAutoscaler mal configurados o problemas con la canalización de métricas.
Soluciona problemas relacionados con el VerticalPodAutoscaler que no ajusta la escala de los recursos de Pod de tu aplicación. Resuelve problemas comunes, como
recursos VerticalPodAutoscaler mal configurados o problemas con la canalización de métricas.
Soluciona problemas de almacenamiento, incluidos los problemas relacionados con los discos persistentes regionales,
el rendimiento del disco y la expansión del volumen.
Soluciona problemas de autenticación en GKE, incluidos los problemas relacionados con RBAC, Workload Identity Federation for GKE y el servidor de metadatos de GKE.
Soluciona problemas de cuentas de servicio, incluida la restauración de la cuenta de servicio predeterminada
y la habilitación de la cuenta de servicio predeterminada de Compute Engine.
Si la autoridad de certificación raíz (CA) de tu clúster vencerá pronto, aprende
a realizar una rotación de credenciales
para evitar que se interrumpan las operaciones normales del clúster.
Soluciona problemas de extracción de imágenes. Descubre qué causa estados como
ImagePullBackOff y ErrImagePull
y cómo resolverlos corrigiendo problemas comunes como la
autenticación y la conectividad de red.
Soluciona problemas relacionados con eventos de CrashLoopBackOff en
GKE. Diagnostica problemas como el agotamiento de recursos, las configuraciones incorrectas de la app
y las fallas de la sonda de actividad.
Soluciona problemas relacionados con eventos de memoria insuficiente (OOM) de Kubernetes. Identifica las causas,
distingue los tipos de eventos y aplica soluciones eficaces para los cierres por OOM a nivel del contenedor
y del nodo.
Soluciona problemas de TPUs, incluidos los problemas relacionados con la cuota, el aprovisionamiento automático de nodos
, la configuración de cargas de trabajo y la programación.
Soluciona problemas de GPUs, incluidos los problemas relacionados con la instalación de controladores de GPU,
errores de complementos de dispositivos y las imágenes de contenedores.
Soluciona problemas de actualización de clústeres y nodos
de GKE, incluidos los problemas relacionados con actualizaciones largas o incompletas, actualizaciones automáticas inesperadas
, fallas y problemas posteriores a la actualización.
Soluciona problemas relacionados con espacios de nombres atascados en el
Terminating estado identificando y quitando los componentes en mal estado que bloquean la eliminación.
Soluciona problemas relacionados con operaciones simultáneas aprendiendo a identificar
estos errores y resolviéndolos esperando que se completen las operaciones.
Soluciona problemas relacionados con los paneles de Monitoring, incluidos los problemas relacionados con la habilitación de
la supervisión, la falta de recursos de Kubernetes y los permisos.
Soluciona problemas relacionados con la falta de registros de GKE. Aprende a verificar el estado de la API
el estado, la configuración del clúster, los permisos, las cuotas, los filtros y el comportamiento de la aplicación
el comportamiento.
Soluciona problemas relacionados con algunos de los errores 400, 401, 403 y 404 que puedes encontrar cuando usas GKE. Esta página también incluye
información para solucionar problemas relacionados conla falta de permisos de edición en errores de cuenta.
Identifica y resuelve problemas conocidos que podrían afectar tu uso de GKE.
¿Qué sigue?
Si no encuentras una solución a tu problema en la documentación, consulta
Obtener asistencia para obtener más ayuda,
como asesoramiento en los siguientes temas:
[[["Fácil de comprender","easyToUnderstand","thumb-up"],["Resolvió mi problema","solvedMyProblem","thumb-up"],["Otro","otherUp","thumb-up"]],[["Difícil de entender","hardToUnderstand","thumb-down"],["Información o código de muestra incorrectos","incorrectInformationOrSampleCode","thumb-down"],["Faltan la información o los ejemplos que necesito","missingTheInformationSamplesINeed","thumb-down"],["Problema de traducción","translationIssue","thumb-down"],["Otro","otherDown","thumb-down"]],["Última actualización: 2026-09-10 (UTC)"],[],[]]
