> ## 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 Helm チャートをインストールして、Vantage 3.0 セルフホスト型をアップグレードします。

Vantage 3.0 セルフホスト型のアップグレードは オペレーター 主導で行われます。`vantage-operator` と `vantage-selfhosted` の Helm リリースを、同じ新しいバージョンにアップグレードしてください。新しい `vantage-selfhosted` チャートは、バージョン付きのワークロード ConfigMap を参照します。これにより、オペレーター は `Vantage` リソースを再処理し、対応する Vantage リリースをリコンシルします。自動アップグレードはまだ実装されていません。

<div id="upgrade-workflow">
  ## アップグレードのワークフロー
</div>

オペレーター と Vantage のチャートは同時にリリースされるため、両者のバージョンは一致している必要があります。新しい オペレーター をインストールすると、互換性のあるコントローラーと CRD が準備されます。対応する `vantage-selfhosted` チャートをインストールすると、バージョン付きワークロードの ConfigMap 参照が更新され、インプレース更新が開始されます。

アップグレードするには、次の手順に従います。

<Steps>
  <Step title="インストールされているバージョンを確認する">
    `Vantage` リソースの `status.installedVantageVersion` を確認して、現在稼働中のバージョンを確認します。

    ```bash theme={null}
    kubectl -n $install_namespace get vantages.vantage.abbyy.com $release_name -o yaml
    ```
  </Step>

  <Step title="両方のチャートをアップグレードする">
    まず オペレーター をアップグレードし、次に `vantage-selfhosted` リリースを同じバージョンにアップグレードします。

    ```bash theme={null}
    helm upgrade --install vantage-operator $charts_uri/vantage-operator \
      --version $new_version \
      --namespace $operator_namespace \
      --wait

    helm upgrade --install $release_name $chart_uri/vantage-selfhosted \
      --version $new_version \
      --namespace $install_namespace \
      --values <your-values-file> \
      --wait
    ```

    GitOps を使用している場合は、両方のチャートのリビジョンを同じバージョンに更新し、既存の values ソースを使ってコントローラーにレンダリングさせます。
  </Step>

  <Step title="リソースがリコンシルされるまで待機する">
    `Vantage` リソースが `Ready` になるまで監視します。

    ```bash theme={null}
    kubectl -n $install_namespace wait \
      --for=condition=Ready vantages.vantage.abbyy.com/$release_name \
      --timeout=30m
    ```

    より詳細な状況を確認するには、OCI 移行ジョブと ArgoCD アプリケーションの同期ステータスを監視します。Skill のインストールは、ArgoCD では追跡されない別個のジョブとして実行されます。詳しくは [Lifecycle](/ja/vantage/self-hosted/v3.0/lifecycle#skill-installation-runs-separately) を参照してください。チャートのリコンシルに失敗した場合、オペレーター はその原因を `status.degradationReasons[]` に示します。
  </Step>
</Steps>

<div id="whats-different-from-vantage-27">
  ## Vantage 2.7 との違い
</div>

Vantage 2.7 のセルフホスト型では、アップグレードとは、更新済みの values ファイルに対して Ansible のインストーラーコンテナーを実行し、各チャートに `helm upgrade` を順番に適用することを意味していました。これは、インフラとアプリケーション構成の両方に 1 つのステップで変更を加える操作でした。

3.0 では、アプリケーションのアップグレードはインフラ変更から切り離されています。

| Step              | 2.7                                        | 3.0                                                        |
| ----------------- | ------------------------------------------ | ---------------------------------------------------------- |
| アップグレードを開始する      | Ansible のインストーラーコンテナーを再実行する                | オペレーターと Vantage チャートの対応する新しいバージョンをインストールする                 |
| コンポーネントごとの変更を適用する | Ansible が各チャートに対して `helm upgrade` を順番に実行する | オペレーターが ArgoCD の `Application` マニフェストを生成し、ArgoCD がリコンサイルする |

2.7 のインストーラーモデルは 3.0 ではサポートされておらず、2.7 からのインプレースアップグレードもできません。2.7 からの移行はアップグレードではなく移行です。詳しくは [Vantage 2.7 から移行する](/ja/vantage/self-hosted/v3.0/migration-from-2.7) を参照してください。Vantage チャートのアップグレード対象は Vantage Core のみです。監視スタックなど、別途インストールしたソフトウェアは、お客様自身のスケジュールでアップグレードしてください。

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

<CardGroup cols={2}>
  <Card title="アーキテクチャ" icon="diagram-project" href="/ja/vantage/self-hosted/v3.0/architecture">
    リコンシルのたびにオペレーターが行う作業。
  </Card>

  <Card title="既知の制限事項" icon="triangle-exclamation" href="/ja/vantage/self-hosted/v3.0/known-limitations">
    アップグレードの計画を立てる前に把握しておくべき制約事項。
  </Card>
</CardGroup>