vantage-operator (Vantage カスタムリソースを監視するコントローラー) と、vantage-selfhosted (選択したインストール先の名前空間に Vantage リソースと関連マニフェストを作成するチャート) です。このページでは、その両方の値のリファレンスを示します。
field レベルの CRD の詳細については、API リファレンス を参照してください。インストール手順については、Azure または セルフマネージド Kubernetes を選択してください。
vantage-operator と vantage-selfhosted は同じバージョンをインストールしてください。現在のセルフマネージド手順では、両方のチャートにバージョン 0.70.13 を使用します。vantage-operator
Vantage カスタムリソースで定義された Vantage のインストールをリコンサイルします。
トップレベルのスタンザ
nameOverride/fullnameOverride: 生成されるリソース名のプレフィックスを部分的または完全に上書きします。manager: オペレーター の Deployment です。replicas、image、コンテナーのargs(leader election はデフォルトで有効) 、env(downward API 経由の pod 名と名前空間) 、imagePullSecrets、pod とコンテナーの security context (non-root、権限昇格なし、読み取り専用 root filesystem) 、resources、およびスケジューリング (affinity、nodeSelector、tolerations) を指定します。rbacHelpers:vantage.abbyy.comCRD を扱うための任意の admin/editor/viewer ClusterRole です。デフォルトでは無効です。crd: CRD のライフサイクルです。チャートとともに CRD をインストールする (enable) 、またはアンインストール時に保持する (keep) かを指定します。metrics: RBAC で保護された/metricsエンドポイントです。certManager: webhook と metrics エンドポイントの証明書用の cert-manager 統合です。デフォルトでは無効です。prometheus: metrics エンドポイント用の PrometheusServiceMonitorです。クラスター内に prometheus-operator が必要です。デフォルトでは無効です。
主な値
values.yaml を反映しています。正式な定義はチャート自体です。詳しくは、使用可能な値の確認を参照してください。
オペレーター チャートでは、Vantage アプリケーションの設定は 一切 受け付けません。アプリケーション設定はすべて
Vantage カスタムリソースにあり、これは vantage-selfhosted チャートによって作成されます。
vantage-selfhosted
Vantage カスタムリソース、関連する RBAC とともに Vantage の ワークロード データを含む ConfigMap、ならびに ABBYY のアップストリーム infrastructure リポジトリに由来する Vantage 関連の CRD とロールが含まれています。
ほとんどの値は、Vantage カスタムリソース上の field に直接マップされます。field レベルの仕様については、API リファレンスを参照してください。
トップレベルのスタンザ
operator: オペレーター のインストール先 (namespaceとcontrollerManagerServiceAccount) への参照です。チャートはこれらの値を使って、Vantage リリースの名前空間内で オペレーター の Secret-reader ClusterRole をバインドします。ingress: 組み込みの Istio ingress 構成です。別の ingress コントローラーを使用する場合は、enabled: falseに設定します。vantage:Vantage.specのペイロードです:databaseProvider,dnsRecord,mailFrom,platformAdminEmail,secrets,vantageVersion,workloads,idReadingEnabled,keda,ociMigration,reportingEnabled,serviceAccountName,smtp,storage,techcore.observability: チャートによって生成される PrometheusServiceMonitorの設定です。これはトップレベルのスタンザであり、Vantage.specの field ではありません。
必須の値
オプション値
利用可能な値の確認
vantage-operator チャート (values.yaml を含む) は Kubebuilder Helm プラグインによって生成されます。一方、vantage-selfhosted チャートのテンプレートは手動で保守されています。いずれの場合も、特定のバージョンで受け入れられる内容については、公開済みのチャートが正規の参照元です。このページのテーブルは、テスト済みのスナップショットを要約したものです。このページとチャートの内容に相違がある場合は、チャートを正としてください。
$charts_uri、$chart_uri、およびバージョン変数は、インストール変数の規則に従います。
適用する前に、レンダリングされたマニフェストを確認するには、次のようにします。
Operator と Vantage の設定
TechCore workerのデプロイ
vantage-selfhosted チャートは Vantage カスタムリソースを適用し、その後、オペレーター が spec.techcore.* に基づいて TechCore worker チャートの一部をデプロイします。どれが選択されるかは オペレーター 側で決まりますが、以下のマトリクスが基準となります。これを使用すると、特定の構成でどの worker が実行されるかを予測できます。
命名規則
vtc-{version}-worker-{name} です。ここで、{version} は spec.techcore.version に由来し、{previousVersion} は spec.techcore.previousVersion に由来します。バージョン番号はあくまで名前のプレフィックスであり、オペレーターにとって特別な意味はありません。利用可能な worker のセットは、ABBYY が各リリースで公開する ワークロード ConfigMap に含まれています。
2つのデプロイパス
keepPreviousVersion: true を設定すると、以前の TechCore バージョンのワーカーが新しいワーカーと並行して稼働し続けるため、段階的な TechCore アップグレードに役立ちます。このフラグが true の場合、CRD では previousVersion の設定が必須です。
インクルージョンマトリクス: 現行バージョンのパス
インクルージョンマトリクス: 前バージョンのパス
spec.techcore.keepPreviousVersion: true の場合にのみ実行されます。
ID reading は TechCore の対象ではなく、プラットフォーム レベルの機能です。これを制御するフラグは
spec.idReadingEnabled で、spec.techcore の外側にあります。Vantage.spec リファレンスを参照してください。worker-ocr-join は現時点では vtc-2 の workload セットにのみ含まれているため、keepPreviousVersion: true と previousVersion: 2 を指定していても、vtc-2-worker-ocr-join としてのみデプロイされます。
次へ
API リファレンス
Vantage カスタムリソースの各 field のリファレンス。Azure へのインストール
これらのチャートを使用したインストール手順です。
セルフマネージド Kubernetes
ingress、mesh、シークレット、ストレージ、データサービスをお客様側で管理する構成でインストールします。