Zum Hauptinhalt springen
Beginnen Sie mit:

Health-Checks

Jede Komponente stellt GET /healthz auf Port 8080 als Readiness-Probe bereit. Ein betriebsbereiter pod antwortet mit {"status":"ok"}. Ein nicht betriebsbereiter pod antwortet mit 503, liefert dabei status sowie den Grund in error zurück und läuft weiter, statt neu zu starten.

Installation

Ein Claim bleibt im Status Pending

Beim in-process-Claim: Der EFS-CSI-Treiber fehlt, seinem Controller fehlt AmazonEFSCSIDriverPolicy oder fileSystemId ist falsch. Bei mnesia-fineparser-orchestrator-0: Der Cluster hat keine Standard-StorageClass oder deren Treiber fehlt.

Pods hängen im Status ContainerCreating fest

Die Ursache lässt sich mit kubectl describe pod ermitteln.
  • Zeitüberschreitung bei EFS-Mounts: In der Availability Zone des Knotens gibt es kein Mount-Ziel, oder TCP-Port 2049 ist blockiert.
  • S3-Mounts schlagen fehl: Bucket oder Region ist falsch, oder die Rolle des Mountpoint-Treibers hat keinen Zugriff auf den Bucket. No signing credentials available bedeutet, dass die Vertrauensrichtlinie der Rolle nicht zum OIDC-Provider des Clusters passt.

Pods schlagen mit „exec format error“ fehl

Der Pod befindet sich auf einem arm64-Knoten. Siehe Auf amd64 ausführen.

Worker

Worker starten nicht

Wenn das Deployment Worker anfordert, diese aber im Status Pending verbleiben, ist im Cluster kein Platz mehr: Prüfen Sie, ob Ihr Knoten-Autoscaler amd64-Knoten hinzufügen kann, die zu worker.nodeSelector und worker.tolerations passen. Wenn worker.prepull aktiviert ist, prüfen Sie außerdem, ob das Pre-Pull-DaemonSet auf den neuen Knoten läuft.

Worker werden beim Starten beendet

Die Zeile billing refused this worker, exiting: gibt den Grund an. billing: RegisterUsage failed, retrying ist ein vorübergehender Fehler, bei dem der Worker den Vorgang automatisch wiederholt.

Worker sind nicht bereit

Die FineReader Engine hat das Standardprofil abgelehnt. Den Grund finden Sie im Protokoll des Workers und unter /healthz. Korrigieren Sie worker.predefinedProfile oder worker.userProfile, führen Sie ein Upgrade durch und starten Sie die Worker neu.

Worker starten mit Exit-Code 2 neu

Ein Worker, bei dem fünf Einheiten in Folge fehlschlagen, startet neu. Prüfen Sie das Feld failure.message der fehlgeschlagenen Jobs. Wenn alle Dokumente fehlschlagen, überprüfen Sie die Volumes oder das Profil.

Jobs

Upgrades