Saltar al contenido principal
Empiece por lo siguiente:

Comprobaciones de estado

Cada componente expone GET /healthz en el puerto 8080 como sonda de disponibilidad (readiness probe). Un pod listo responde {"status":"ok"}. Un pod que no está listo responde con 503, con status y el motivo en error, y permanece en ejecución en lugar de reiniciarse.

Instalación

Un claim se queda en estado Pending

Para el claim in-process: no está instalado el controlador CSI de EFS, a su componente controller le falta AmazonEFSCSIDriverPolicy o el valor de fileSystemId es incorrecto. Para mnesia-fineparser-orchestrator-0: el clúster no tiene una StorageClass predeterminada o no está instalado su controlador.

Los pods se quedan bloqueados en ContainerCreating

kubectl describe pod muestra la causa.
  • Se agota el tiempo de espera de los montajes de EFS: no hay ningún destino de montaje en la zona de disponibilidad del nodo o el puerto TCP 2049 está bloqueado.
  • Fallan los montajes de S3: el bucket o la región son incorrectos, o el rol del controlador Mountpoint no tiene acceso al bucket. No signing credentials available indica que la política de confianza del rol no coincide con el proveedor OIDC del clúster.

Los pods fallan con un error de formato de exec

El pod se ejecuta en un nodo arm64. Consulte Ejecutar en amd64.

Trabajadores

No se inicia ningún trabajador

Si el Deployment requiere trabajadores pero estos permanecen en estado Pending, el clúster no tiene capacidad disponible: compruebe que el escalador automático de nodos pueda agregar nodos amd64 que cumplan con worker.nodeSelector y worker.tolerations. Si worker.prepull está habilitado, compruebe también que el DaemonSet de descarga previa se esté ejecutando en los nodos nuevos.

Los trabajadores se cierran al iniciar

La línea billing refused this worker, exiting: indica el motivo. billing: RegisterUsage failed, retrying es un error transitorio y el trabajador vuelve a intentar la operación.

Los trabajadores no están listos

FineReader Engine rechazó el perfil predeterminado. El motivo figura en el registro del trabajador y en /healthz. Corrija worker.predefinedProfile o worker.userProfile, realice la actualización y reinicie los trabajadores.

Los trabajadores se reinician con el código de salida 2

Un trabajador se reinicia cuando fallan cinco unidades seguidas. Revise el valor de failure.message de los trabajos fallidos. Si fallan todos los documentos, compruebe los volúmenes o el perfil.

Trabajos

Actualizaciones