メインコンテンツへスキップ
このページでは、Vantage オペレーター と利用者の間のランタイム契約について説明します。具体的には、オペレーター が各リコンシルでたどるフェーズ、Vantage リソースに公開されるステータス条件、再試行を強制する方法です。field レベルのスキーマについては、API リファレンスを参照してください。概念的な概要については、アーキテクチャを参照してください。

​
リコンシルのフェーズ

オペレーターによるリコンシルは、5つの連続したフェーズで構成されています。各フェーズには、オペレーターが次のフェーズに進む前に、すべて正常に完了している必要があるバリデーターまたはステップが含まれます。いずれかのステップで失敗すると、リコンシル全体が致命的な失敗となり、その内容は status.degradationReasons[] に表示されます。

​
ステータス条件

オペレーターは、status.conditions[] の condition type を通じてインストール状態を示します。
  • Progressing: プロセスの実行中は status が True になります。
  • Ready: 正常に完了すると status が True になります。
  • Degraded: 途中のいずれかの時点でエラーが発生すると status が True になります。この場合、status.degradationReasons[] にはエラーの詳細が含まれます。
Azure およびセルフマネージド型のインストール手順では、condition=Ready を待機します (kubectl wait --for=condition=Ready vantages.vantage.abbyy.com/$release_name) 。Ready には、別個のジョブとして実行される Skill のインストールは含まれないため (下記を参照) 、生成された ArgoCD アプリケーションについても確認する必要があります。完全なステータススキーマについては、Vantage.status リファレンス を参照してください。

​
Skill のインストールは個別に実行されます

Skill は、ArgoCD アプリケーションではなく、install 名前空間内の別個の Kubernetes ジョブによってインストールされます。このジョブは ArgoCD には表示されず、上記のステータス条件にも反映されないため、Ready は Skill のインストールが完了したことを示すものではありません。ジョブの実行中でも Vantage は使用できます。 ジョブを直接監視します:

​
再試行を強制する

インストールを再試行するには (たとえば、Key Vault の権限を修正した後) 、Vantage リソースに vantage.abbyy.com/reprocess のアノテーションを追加します (値は任意) :
Vantage カスタムリソースは変更可能ですが、Vantage のインストールを再試行するには、対応する Vantage CR に vantage.abbyy.com/reprocess のアノテーション (値は any) を付与する必要があります。spec.* を編集しただけでは、失敗したインストールは再試行されません。spec を修正した後、再試行をトリガーするにはこのアノテーションを適用してください。

​
次のステップ

API リファレンス

すべての仕様とステータスプロパティを、field ごとに確認できるリファレンスです。

トラブルシューティング

一般的なリコンシル失敗について、症状 → 診断 → 修正の流れで説明します。