メインコンテンツへスキップ
Vantage 3.0では、2.7とは異なるデプロイメントモデルを採用しています。 2.7で使用されていたABBYY提供のAnsibleプレイブックとAzure CLIスクリプトは3.0ではサポートされておらず、インストール方式もKubernetes operator + ArgoCDに変わっています。2.7 → 3.0への移行は、インプレース アップグレードではなく、データ移行を伴う3.0の新規インストールとして扱ってください。
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 がテストしたシナリオです。文書化された例に基づいてインストールを調整できますが、その調整内容の検証はお客様の責任となります。

始める前に

まずは次をお読みください。
  • はじめに: 2.7 と 3.0 のアーキテクチャの違いについて説明しています。これには、ABBYY 提供の Ansible スクリプトおよび Azure CLI スクリプトから、operator + カスタムリソース構成への移行が含まれます。
  • 既知の制限事項: SMTP path が Basic 認証 (または認証なし) のみをサポートするなど、3.0 の現時点での制約を説明しています。移行前に、2.7 の依存関係のいずれにも影響がないことを確認してください。
  • 前提条件: 3.0 では、ArgoCD、サポート対象のサービスメッシュと ingress controller、シークレット統合、さらに Secrets and Key Vault に記載された connection-string alias ごとに 1 つのデータベースなど、新しいインフラストラクチャ要件が導入されています。

Vantage 3.0 Migrator

ABBYY は、Vantage 2.7.x から 3.0 へ移行する顧客向けに Vantage 3.0 Migrator を提供しています。3.0 のリリースノートには Migrator の更新内容が記載されており、2.7 から 3.0 への移行パスに関する正式な参照元となります。

Vantage 3.0 のリリースノートと Migrator

docs.abbyy.com で、Vantage 3.0 Migrator の更新を含む 3.0、3.0.1、3.0.2、3.0.3、3.0.4 の完全なリリースノートをご覧ください。
このページでは、専用のステップごとの移行ガイドを公開する予定です。現時点での推奨パターンは次のとおりです。
1

並行する 3.0 環境を立ち上げる

Azure または セルフマネージド Kubernetes に従って、別の環境をプロビジョニングします。vantage-operator Helm チャートは、クラスターごとに 1 インスタンスのみサポートしている点に注意してください。詳しくは、既知の制限事項 を参照してください。
2

Vantage 3.0 Migrator でデータを移行する

Vantage 3.0 Migrator を使用して、2.7 のインストールから 3.0 環境へデータを移行します。まず、3.0 のインストールが正常な状態であることを確認してください。Vantage リソースの Ready condition を待ち、Skill installer job が完了するまで待機します。監視コマンドについては、Lifecycle を参照してください。
3

トラフィックを切り替える

データの移行と検証が完了したら、DNS / クライアントの向き先を 3.0 クラスターに切り替えます。3.0 上の本番トラフィックを検証し終えるまでは、2.7 環境をロールバック先として利用できる状態にしておいてください。
4

2.7 を廃止する

3.0 が検証期間を通して問題なく稼働したことを確認できたら、通常の変更管理プロセスに従って 2.7 環境を廃止します。

アカウントチームに共有する内容

移行期間を計画している場合は、ABBYYアカウントチームに次の情報を共有してください。
  • 現在使用している2.7のバージョンと、適用している帯域外パッチ。
  • メール設定が Basic 認証以外の SMTP 認証スキームに依存しているかどうか。3.0 の SMTP パスは現在、Basic 認証または認証なしのみをサポートしており、デフォルトのメールプロバイダーは SendGrid です。既知の制限事項を参照してください。
  • 想定されるドキュメントのスループットとテナント数。これらは、3.0 環境のサイジングを検証するために使用されます。

次のステップ

アーキテクチャの概要

2.7 から 3.0 への移行で、構造的に何が変わるか。

Vantage 2.7 ドキュメント

移行が完了するまで、既存の 2.7 デプロイに関するリファレンス。