Passer au contenu principal
Commencez par :

Contrôles d’intégrité

Chaque composant expose GET /healthz sur le port 8080 en guise de sonde de disponibilité (readiness probe). Un pod prêt renvoie {"status":"ok"}. Un pod non prêt renvoie 503 avec status et le motif dans error, et continue de s’exécuter au lieu de redémarrer.

Installation

Une demande de volume reste à l’état Pending

Pour la PVC in-process : le pilote CSI EFS est absent, son contrôleur ne dispose pas de AmazonEFSCSIDriverPolicy, ou la valeur de fileSystemId est incorrecte. Pour mnesia-fineparser-orchestrator-0 : le cluster n’a pas de StorageClass par défaut, ou le pilote de celle-ci est absent.

Les pods restent bloqués à l’état ContainerCreating

kubectl describe pod en indique la cause.
  • Les montages EFS expirent : aucune cible de montage n’existe dans la zone de disponibilité du nœud, ou le port TCP 2049 est bloqué.
  • Les montages S3 échouent : le compartiment ou la région est incorrect, ou le rôle du pilote Mountpoint ne peut pas accéder au compartiment. No signing credentials available signifie que la stratégie d’approbation du rôle ne correspond pas au fournisseur OIDC du cluster.

Les pods échouent avec l’erreur exec format error

Le pod s’exécute sur un nœud arm64. Voir Exécuter sur amd64.

Unités de traitement

Aucune unité de traitement ne démarre

Si le Deployment requiert des processus de traitement mais que ceux-ci restent à l’état Pending, c’est que le cluster manque de capacité : vérifiez que votre autoscaler de nœuds peut ajouter des nœuds amd64 correspondant à worker.nodeSelector et worker.tolerations. Si worker.prepull est activé, vérifiez également que le DaemonSet de pré-téléchargement s’exécute bien sur les nouveaux nœuds.

Les unités de traitement s’arrêtent au démarrage

La ligne billing refused this worker, exiting: indique le motif. billing: RegisterUsage failed, retrying est une erreur temporaire : le processus de traitement effectue automatiquement une nouvelle tentative.

Les unités de traitement ne sont pas prêtes

FineReader Engine a refusé le profil par défaut. Le journal du processus de traitement et /healthz en indiquent la cause. Corrigez worker.predefinedProfile ou worker.userProfile, effectuez la mise à niveau, puis redémarrez les unités de traitement.

Les unités de traitement redémarrent avec le code de sortie 2

Un processus de traitement qui échoue sur cinq unités consécutives redémarre. Consultez le champ failure.message des tâches en échec. Si tous les documents échouent, vérifiez les volumes ou le profil.

Tâches

Mises à niveau