メインコンテンツへスキップ
ABBYY Vantage 3.0 self-hosted は、Kubernetes オペレーターを基盤とした、Vantage プラットフォームのセルフホスト型デプロイメントです。必要なインストール内容を記述した単一の Vantage カスタムリソースを宣言すると、オペレーターが Vantage Core のインストールを処理します。具体的には、Vantage Core の依存関係一式の取得、構成の検証、アーティファクトのレジストリへのコピー、ArgoCD を介した Helm リリースの調整を行います。

新しいインストーラーが必要な理由

Vantage 2.7 セルフホスト型では、ABBYY が提供する Ansible プレイブックと、Docker コンテナー内で実行される Azure CLI スクリプトによって作成および構成される、ABBYY が厳密に指定したインフラストラクチャが必要でした。このモデルは 3.0 ではサポートされていません。インフラストラクチャはお客様自身でプロビジョニングする必要があり、2.7 からの移行はインプレースアップグレードではなく、新規インストールとデータ移行になります。3.0 のインストーラーでは、operator、宣言型のカスタムリソース、そしてオーケストレーションに ArgoCD を使用するという、最新の Kubernetes パターンを採用しています。 その結果、導入当初の構成要素が減り、長期的なアップグレードも容易になります。お客様は operator とカスタムリソースを管理し、operator がそれに基づいて Vantage Core のリリースをリコンサイルします。
Vantage 3.0 では、2.7 以前とは異なるデプロイ モデルを採用しています。 以前のバージョンでは、ABBYY が提供する Ansible および Azure CLI スクリプトで作成・構成される、ABBYY が厳密に指定したインフラストラクチャが必要でした。このモデルは 3.0 ではサポートされていません。
  • Kubernetes クラスター、データベース、ストレージ アカウント、Key Vault などのインフラストラクチャは、お客様自身でプロビジョニングします。ABBYY は、3.0 向けのプロビジョニング スクリプト、テンプレート、その他のインフラストラクチャ自動化機能を提供しません。
  • インストーラーがデプロイするのは Vantage Core のみです。ArgoCD、お客様のサービス メッシュと Ingress コントローラー、シークレット統合、モニタリング スタックなど、Vantage が依存するサードパーティ ソフトウェアは、通常 Helm を使用して、お客様自身でインストールおよび保守します。
  • 文書化されている構成は、ABBYY がテストしたシナリオです。文書化された例に基づいてインストールを調整できますが、その調整内容の検証はお客様の責任となります。

アーキテクチャの概要

ABBYY は、Vantage operator、OCI migration job、Skill installer job を提供します。ArgoCD、サービスメッシュ、Ingress controller、シークレット統合、監視スタックはサードパーティ製の前提条件であり、Vantage をインストールする前にインストールして保守する必要があります。 operator が Vantage リソースをリコンサイルすると、プロセスは 5 つのフェーズで進行します。
  1. Preflight: 設定を検証します。preflight チェックでは、シークレット設定が検証されます。
  2. Secrets: 構成済みの secrets provider を準備します。Azure Key Vault では、operator が SecretProviderClass リソースをプロビジョニングし、CSI driver が pod の起動時に値を提供します。Kubernetes provider では、operator がインストール用の名前空間に事前作成されたネイティブ Secrets を検証します。
  3. OCI Migration: OCI migration job を実行して、アーティファクトを使用先のレジストリにコピーします。
  4. Installation: 各コンポーネント用の ArgoCD Application マニフェストを生成して適用します。
  5. Sync: ArgoCD Application のステータスを監視し、その結果を Vantage カスタムリソースに報告します。
Skill のインストールは、ArgoCD が追跡しない別個の Kubernetes job として実行されます。job の完了を待っている間も Vantage は使用できます。Lifecycle を参照してください。

Vantage 2.7 からの変更点

次のステップ

前提条件

インストール前に準備しておく必要があるクラスター、services、secrets、証明書。

アーキテクチャ

operator が Vantage カスタムリソースをどのように処理するか。

Azure へのインストール

Azure Key Vault を使用して AKS にインストールする手順。

セルフマネージド Kubernetes

顧客管理の ingress、mesh、secrets、ストレージ、データサービスを使用したインストール。

API リファレンス

Vantage カスタムリソースの field レベルのリファレンス。