チェックリスト
- API には、呼び出し元を認証する仕組みを経由しなければアクセスできない。
/parse、/jobs/、/batch/のみが ingest にルーティングされている。ingest.maxUploadSizeとingest.scratchSizeが、最大サイズのリクエストに対応できる値になっている。scaling.maxWorkersとノードの容量が、ピーク時の負荷に見合っている。- ワーカーが専用のノードで実行され、すべてのコンポーネントが
amd64ノードで実行されている。 orchestrator.workLeaseSecondsが、最も時間のかかる処理単位の所要時間よりも長く設定されている。- 結果を
orchestrator.jobRetentionSeconds以内に回収するか、出力ボリュームから読み取るようになっている。 - 結果を無期限に保持する必要がない場合は、出力ストレージで古い結果が期限切れになるよう設定されている。
APIの公開
このチャートは、ポート8080でClusterIP Service の fineparser-ingest を作成しますが、Ingressは作成しません。クラスター内のクライアントは http://fineparser-ingest.fineparser.svc.cluster.local:8080 を呼び出せます。
クラスター外部に公開するには、独自のIngress、Gateway、またはロードバランサーを前段に配置します。
- 呼び出し元を認証してください。 Ingestには認証機能がありません。Ingestにアクセスできれば、誰でもドキュメントを送信し、結果をダウンロードできます。
- ルーティングは
/parseと、/jobs/および/batch/のプレフィックスのみに限定してください。 - 大きなリクエストボディを許可してください。 上限は
ingest.maxUploadSize以上に設定します。 - 長時間のリクエストを許可してください。 最大サイズのアップロードが完了するまで待てるよう、タイムアウトを十分に長く設定してください。
アップロードのサイジング
リクエストを処理するには、そのサイズの約 2 倍の ingest 用一時領域が必要です。結果と保持期間
完了したジョブのステータスは、orchestrator.jobRetentionSeconds (86400) で指定された秒数の間保持されます。"infinity" を指定すると無期限に保持されます。出力ボリューム上の結果が FineParser によって削除されることはなく、ステータスの保持期間が過ぎた後もダウンロードできます。