> ## 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.

# Vantage 2.7 からの移行

> Vantage 2.7 セルフホスト型から 3.0 への移行を計画します。これはインプレース アップグレードではなく、3.0 の新規インストールとデータ移行で対応します。

<Warning>
  **Vantage 3.0では、2.7とは異なるデプロイメントモデルを採用しています。** 2.7で使用されていたABBYY提供のAnsibleプレイブックとAzure CLIスクリプトは3.0ではサポートされておらず、インストール方式もKubernetes operator + ArgoCDに変わっています。2.7 → 3.0への移行は、インプレース アップグレードではなく、データ移行を伴う3.0の新規インストールとして扱ってください。
</Warning>

<Note>
  **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 がテストしたシナリオです。文書化された例に基づいてインストールを調整できますが、その調整内容の検証はお客様の責任となります。
</Note>

<div id="before-you-start">
  ## 始める前に
</div>

まずは次をお読みください。

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

<div id="vantage-30-migrator">
  ## Vantage 3.0 Migrator
</div>

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

<Card title="Vantage 3.0 のリリースノートと Migrator" href="https://docs.abbyy.com/vantage/release-notes/3.0/release-notes" icon="arrow-up-right-from-square">
  docs.abbyy.com で、Vantage 3.0 Migrator の更新を含む 3.0、3.0.1、3.0.2、3.0.3、3.0.4 の完全なリリースノートをご覧ください。
</Card>

<div id="recommended-approach">
  ## 推奨アプローチ
</div>

このページでは、専用のステップごとの移行ガイドを公開する予定です。現時点での推奨パターンは次のとおりです。

<Steps>
  <Step title="並行する 3.0 環境を立ち上げる">
    [Azure](/ja/vantage/self-hosted/v3.0/providers/azure) または [セルフマネージド Kubernetes](/ja/vantage/self-hosted/v3.0/providers/self-managed) に従って、別の環境をプロビジョニングします。`vantage-operator` Helm チャートは、クラスターごとに 1 インスタンスのみサポートしている点に注意してください。詳しくは、[既知の制限事項](/ja/vantage/self-hosted/v3.0/known-limitations#one-operator-instance-per-cluster) を参照してください。
  </Step>

  <Step title="Vantage 3.0 Migrator でデータを移行する">
    Vantage 3.0 Migrator を使用して、2.7 のインストールから 3.0 環境へデータを移行します。まず、3.0 のインストールが正常な状態であることを確認してください。`Vantage` リソースの `Ready` condition を待ち、Skill installer job が完了するまで待機します。監視コマンドについては、[Lifecycle](/ja/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately) を参照してください。
  </Step>

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

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

<div id="what-to-bring-to-your-account-team">
  ## アカウントチームに共有する内容
</div>

移行期間を計画している場合は、ABBYYアカウントチームに次の情報を共有してください。

* 現在使用している2.7のバージョンと、適用している帯域外パッチ。
* メール設定が Basic 認証以外の SMTP 認証スキームに依存しているかどうか。3.0 の SMTP パスは現在、Basic 認証または認証なしのみをサポートしており、デフォルトのメールプロバイダーは SendGrid です。[既知の制限事項](/ja/vantage/self-hosted/v3.0/known-limitations#smtp-supports-basic-auth-only)を参照してください。
* 想定されるドキュメントのスループットとテナント数。これらは、3.0 環境のサイジングを検証するために使用されます。

<div id="whats-next">
  ## 次のステップ
</div>

<CardGroup cols={2}>
  <Card title="アーキテクチャの概要" icon="book-open" href="/ja/vantage/self-hosted/v3.0/introduction">
    2.7 から 3.0 への移行で、構造的に何が変わるか。
  </Card>

  <Card title="Vantage 2.7 ドキュメント" icon="clock-rotate-left" href="/ja/vantage/self-hosted/v2.7/introduction">
    移行が完了するまで、既存の 2.7 デプロイに関するリファレンス。
  </Card>
</CardGroup>