メインコンテンツへスキップ
現在、Vantage 3.0 セルフホスト型にはいくつかの制約があります。デプロイのサイジングや実施計画を立てる前に、あらかじめこれらを考慮してください。

アーキテクチャ上の制約

クラスターごとに operator インスタンスは1つまで

vantage-operator Helm チャートは、クラスター スコープのテンプレート化されていない resource 名を使用します。具体的には、manager-role ClusterRole、manager-rolebinding ClusterRoleBinding、controller-manager ServiceAccount です。このチャートを同じクラスターに2回インストールすると (異なる名前空間であっても) 、これらの resource が競合します。このチャートは、クラスターごとに1インスタンスのみインストールしてください。

デプロイのサポート

サポートされているデプロイ対象

Vantage 3.0 セルフホスト型は、AKS と自己管理型 Kubernetes をサポートしています。検証済みの統合構成については、Compatibility に記載されています。その他の Kubernetes バージョン、サービスメッシュ、ingress コントローラー、データベースエンジン、およびコンポーネントの置き換えは検証されていません。記載のない組み合わせを本番環境で使用する前に、ABBYY アカウントチームにご相談ください。

対応データベース

レポート機能には SQL Server が必要です

PostgreSQL は Vantage サービスでサポートされていますが、レポート機能のワークロードは SQL Server 固有の移行処理を使用するため、PostgreSQL では利用できません。PostgreSQL へのデプロイでは、vantage.databaseProvider: PostgreSQL を設定し、vantage.reportingEnabled: false のままにしてください。

メール送信

SMTP は basic auth のみをサポート

SendGrid はデフォルトのメールプロバイダーです。sendgridApiKey シークレットを指定すると、Vantage は追加設定なしでそれを使用します。SMTP が使用されるのは spec.smtp を設定した場合のみで、現在 SMTP では basic auth または認証なしのみがサポートされています。メールリレーで別の認証スキームが必要で、SendGrid を使用できない場合は、basic auth にダウングレードする中継リレーを用意することを検討してください。

運用上の注意事項

別の ingress コントローラーを使用する場合は、Vantage のルート契約への準拠が必要です

検証済みの ingress パスは、AKS 上の組み込み Istio 構成と、自己管理型 Kubernetes 上でドキュメント化されている Traefik 構成です。別の ingress コントローラーを使用する場合は、同じルート、リライト、TLS の動作、内部ステータス保護、および転送される HTTPS スキームを実装する必要があります。別のコントローラーまたはルート実装の検証は、お客様の責任で行ってください。 TLS が HTTP バックエンドの手前で終端される場合、Vantage の認証サービスは X-Forwarded-Proto を尊重する必要があります。ワークロード チャートで必要な環境設定が公開されていない場合は、Self-Managed Kubernetes に記載されている、サポート対象の admission mutation メカニズムを使用してください。

KEDA は 2.17.x に制限されています

現在の Vantage ワークロード チャートでは、KEDA 2.18 で削除された KEDA スケーラーの field を使用しています。KEDA 2.17.3 を使用してください。KEDA 2.18 以降では、影響を受ける ScaledObject リソースは HPA を作成できず、degraded 状態のままになります。KEDA を使用したオートスケーリングを参照してください。

ArgoCD には Skill のインストール状況は表示されません

Skill は Operator 管理の ArgoCD アプリケーションではなく、別個の Kubernetes ジョブによってインストールされるため、現時点では ArgoCD から Skill のインストール進行状況を確認できません。ジョブの実行中でも、Vantage リソースが Ready を報告することがあります。Skill のインストール中でも Vantage は利用できます。ジョブは kubectl wait で直接監視してください。コマンドについては Lifecycle を参照してください。

次のステップ

Vantage 2.7 からの移行

既存の 2.7 セルフホスト型環境からの移行を計画します。

アップグレード

3.0 の各バージョン間を移行するための手動アップグレード手順です。