Vantage リソースに公開されるステータス条件、再試行を強制する方法、およびリソースを削除したときの動作です。field レベルのスキーマについては、API リファレンスを参照してください。概念的な概要については、アーキテクチャを参照してください。
リコンシルのフェーズ
オペレーターによるリコンシルは、5つの連続したフェーズで構成されています。各フェーズには、オペレーターが次のフェーズに進む前に、すべて正常に完了している必要があるバリデーターまたはステップが含まれます。いずれかのステップで失敗すると、リコンシル全体が致命的な失敗となり、その内容はstatus.degradationReasons[] に表示されます。
ステータス条件
オペレーターは、status.conditions[] の条件の型を通じてインストール状態を公開します。
Progressing: 処理の実行中はstatusがTrueになります。Ready: 成功するとstatusがTrueになります。Degraded: いずれかの時点でエラーが発生するとstatusがTrueになります。この場合、status.degradationReasons[]にエラーの詳細が格納されます。
False に設定され、理由 ValidationFailed と問題の内容を示すメッセージが付与されます。
Progressing および Degraded の reason は、リコンシルがどの段階で停止したかを示します。
condition=Ready になるまで待機します (kubectl wait --for=condition=Ready vantages.vantage.abbyy.com/$release_name) 。ただし、Ready は Skill のインストールを対象としていません。Skill のインストールは別のジョブとして実行されます (後述) 。また、生成された ArgoCD アプリケーションも確認する必要があります。ステータスのスキーマ全体については、Vantage.status リファレンスを参照してください。
Skill のインストールは個別に実行されます
Skill は、ArgoCD アプリケーションではなく、install 名前空間内の別個の Kubernetes ジョブによってインストールされます。このジョブは ArgoCD には表示されず、上記のステータス条件にも反映されないため、Ready は Skill のインストールが完了したことを示すものではありません。ジョブの実行中でも Vantage は使用できます。
ジョブを直接監視します:
再試行を強制する
インストールを再試行するには (たとえば、Key Vault の権限を修正した後) 、Vantage リソースに vantage.abbyy.com/reprocess のアノテーションを追加します (値は任意) :
spec を変更すると、リソースにマッピングされた値を変更する helm upgrade も含め、プレフライト から新しいリコンシルが開始されます。一方、リソース外の変更では新しいリコンシルは開始されません。たとえば、Key Vault の権限、Kubernetes の Secret、データベースの変更や、workloadsConfigMap.additionalMetadata や defaultSkills のように workloads ConfigMap のみを変更するチャートの値の変更などがこれに該当します。このような変更を行った後は、アノテーションを適用してください。
オペレーターはアノテーションを処理する際、Ready と Degraded を False に設定し、移行が再度実行されるよう OCI 移行ジョブを削除し、アノテーションを除去したうえで、プレフライト からリコンシルを再開します。アノテーションは除去されるため、再試行のたびに改めて適用してください。
Vantage リソースの削除
オペレーターは、Vantage リソースに vantage.abbyy.com/cleanup ファイナライザーを追加します。リソースを削除すると (たとえば vantage-selfhosted リリースを helm uninstall でアンインストールした場合) 、オペレーターは ArgoCD の ApplicationSet を削除し、生成された Application とそれらによってインストールされたワークロードが ArgoCD によって削除されるまで待機します。その後、自身が作成した SecretProviderClass リソースを削除し、最後にファイナライザーを削除します。リソースが完全に削除されるまでは、オペレーターと ArgoCD を稼働させたままにしてください。どちらかが先に削除されると、リソースは Terminating 状態のまま残ります。
リソースを削除しても、データベース、Redis、Azure ストレージアカウント、Key Vault、Kubernetes の Secret リソース、および宛先レジストリ内のアーティファクトは削除されません。カスタムストレージ (storage.custom) を使用している場合、ストレージの PVC は削除対象のワークロードに含まれます。PVC のデータが保持されるかどうかは、その StorageClass の reclaimPolicy によって決まります。
次のステップ
API リファレンス
すべての仕様とステータスプロパティを、field ごとに確認できるリファレンスです。
トラブルシューティング
一般的なリコンシル失敗について、症状 → 診断 → 修正の流れで説明します。
