> ## Documentation Index
> Fetch the complete documentation index at: https://docs.abbyy.com/llms.txt
> Use this file to discover all available pages before exploring further.
# 概要
> ABBYY Vantage 3.0 セルフホスト型のアーキテクチャ概要: Kubernetes オペレーターによって管理され、宣言型で構成される Vantage プラットフォームのデプロイメント。
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 がテストしたシナリオです。文書化された例に基づいてインストールを調整できますが、その調整内容の検証はお客様の責任となります。
## アーキテクチャの概要
| Component | Role |
| ----------------------------- | ------------------------------------------------------------------------------------------------------------ |
| **Vantage operator** | Helm でデプロイされる Kubernetes オペレーター。`Vantage` カスタムリソースを監視し、インストールの状態をリコンサイルします。 |
| **`Vantage` custom resource** | インストール用の宣言的な仕様 (`vantage.abbyy.com/v1alpha1`) 。DNS、シークレット、SMTP、ワークロードを定義します。 |
| **ArgoCD** | Vantage を構成する各コンポーネントの Helm リリースを適用し、リコンサイルします。 |
| **OCI migration job** | インストール前に、ABBYY が提供するソースレジストリから、使用先のレジストリへ Vantage のアーティファクトをコピーします。 |
| **Skill installer job** | 別個の Kubernetes job として Vantage Skill をインストールします。ArgoCD では追跡されません。 |
| **Secrets provider** | Azure Key Vault と Secrets Store CSI driver、またはネイティブの Kubernetes Secrets を通じて、アプリケーションの値を提供します。 |
| **サービスメッシュ** | Vantage のアプリケーショントラフィックに対して mTLS を提供します。サポート対象のデプロイガイドでは、AKS では Istio、セルフマネージド Kubernetes では Linkerd を使用します。 |
| **Ingress controller** | 公開 HTTPS を終端し、Vantage のパスルーティングおよびリライトの契約を実装します。 |
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](/ja/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately) を参照してください。
## Vantage 2.7 からの変更点
| 項目 | 2.7 セルフホスト型 | 3.0 セルフホスト型 |
| ------------------- | ---------------------------------------------------------------- | ------------------------------------------------------------------------------ |
| インストーラー | Docker コンテナー内の Ansible プレイブック | Kubernetes operator + ArgoCD |
| インフラストラクチャのプロビジョニング | ABBYY 指定のインフラストラクチャに対して、ABBYY 提供の Ansible および Azure CLI スクリプトを使用 | お客様がプロビジョニング。ABBYY 提供の自動化はありません |
| 構成 | `env_specific.yaml` ファイル | 宣言型の `Vantage` カスタムリソース |
| デプロイ先 | Azure またはオンプレミスの VM | AKS またはセルフマネージド Kubernetes |
| サービスメッシュ | インストールに含まれません | AKS では Istio、セルフマネージド Kubernetes では Linkerd。アプリケーショントラフィックには mTLS を使用 |
| シークレット | YAML ファイル / 環境変数 | Secrets Store CSI driver 経由のクラウド Key Vault、または既存の Kubernetes `Secret` リソース |
| 更新 | ABBYY 提供のインストールスクリプトと Ansible プレイブックを再実行 | 対応するバージョンの operator と Vantage チャートをアップグレード。operator が Vantage Core リリースをリコンサイル |
## 次のステップ
インストール前に準備しておく必要があるクラスター、services、secrets、証明書。
operator が `Vantage` カスタムリソースをどのように処理するか。
Azure Key Vault を使用して AKS にインストールする手順。
顧客管理の ingress、mesh、secrets、ストレージ、データサービスを使用したインストール。
`Vantage` カスタムリソースの field レベルのリファレンス。