ヘルスチェック
すべてのコンポーネントは、レディネスプローブとしてポート 8080 でGET /healthz を提供します。準備が完了した pod は {"status":"ok"} を返します。準備が完了していない pod は 503 を返し、status とともに error に理由を含めます。この場合、pod は再起動されず、そのまま実行され続けます。
インストール
クレームが Pending のままになる
AmazonEFSCSIDriverPolicy が付与されていない、または fileSystemId が正しくないことが考えられます。mnesia-fineparser-orchestrator-0 の場合：クラスターにデフォルトの StorageClass が設定されていない、またはそのドライバーがインストールされていないことが考えられます。
pod が ContainerCreating のまま進まない
原因はkubectl describe pod で確認できます。
- EFS のマウントがタイムアウトする: ノードのアベイラビリティーゾーンにマウントターゲットが存在しないか、TCP 2049 がブロックされています。
- S3 のマウントが失敗する: バケットまたはリージョンの指定が誤っているか、Mountpoint ドライバーのロールにバケットへのアクセス権がありません。
No signing credentials availableと表示される場合は、ロールの信頼ポリシーがクラスターの OIDC プロバイダーと一致していません。
pod が exec format error で失敗する
pod がarm64 ノード上で実行されています。amd64 で実行するを参照してください。
ワーカー
ワーカーが起動しない
worker.nodeSelector および worker.tolerations に一致する amd64 ノードを追加できるかどうかを確認してください。worker.prepull を有効にしている場合は、事前プル用の DaemonSet が新しいノード上で実行されているかどうかも確認してください。
起動時にワーカーが終了する
billing refused this worker, exiting: という行に理由が示されます。
billing: RegisterUsage failed, retrying は一時的なエラーで、ワーカーが自動的に再試行します。
ワーカーが準備完了にならない
FineReader Engine がデフォルトのプロファイルを受け付けませんでした。理由はワーカーのログと/healthz で確認できます。worker.predefinedProfile または worker.userProfile を修正し、アップグレードを実行してからワーカーを再起動してください。
ワーカーが終了コード 2 で再起動する
ワーカーは、5 つのユニットで連続して処理に失敗すると再起動します。失敗したジョブのfailure.message を確認してください。すべてのドキュメントで処理が失敗する場合は、ボリュームまたはプロファイルを確認してください。