前提条件チェックリスト
- 仮想マシン
- Azure AKS
- Docker とインターネット接続を備えたマシン (Vantage のインストール元)
- Kubernetes ノードとして使用する仮想マシン (インストール中はインターネット接続が必要)
- Docker イメージを保存するための Container Registry
- Vantage の運用に必要なリレーショナル データベース管理システム (RDBMS)
- Vantage ユーザーにメールを送信するための SMTP サーバー
- 暗号化通信を確立するための TLS 証明書
- 2 つの静的 IP アドレス (1 つは Kubernetes の構成/管理用、もう 1 つは Vantage へのアクセス用)
- Vantage へのアクセス用の DNS レコード
- 外部ストレージ (高可用性なし構成では任意)
インストール元マシンの要件
- 仮想マシン
- Azure AKS
- Linux OS または Windows Subsystem for Linux (WSL)
- Docker バージョン 19.03 以降
abyvtgonprm27.azurecr.ioへのネットワークアクセスansibleユーザーアカウント用の秘密 SSH キー (パスフレーズなし) が含まれるローカルファイル
すべての仮想マシンで同じ SSH キーを使用する必要があります。
インフラストラクチャ要件
- 仮想マシン
- Azure AKS
すべての仮想マシンは VMware または Hyper-V 上で実行でき、次の要件を満たしている必要があります。OS 固有のパッケージ:
- 静的 IP アドレス
ansibleという名前のユーザーアカウント。要件は次のとおりです。- 共有 SSH キーによるアクセス
- NOPASSWD オプション付きの sudo アクセス
- 各 worker node で、
/opt/local-path-provisionerにマウントされた専用の拡張可能な disk/lvm_volume - インストール時に、Container Registry およびパッケージリポジトリへのインターネットアクセス:
- Vantage のインストールの前提条件として準備された、同期済みイメージを含む Container Registry。詳しくは、Downloading Container Images を参照してください。
- パッケージリポジトリ: Ubuntu (archive.ubuntu.com)、RHEL (cdn.redhat.com)。パッケージリポジトリへのアクセスの代わりに、以下に示すすべての必須パッケージを含む独自のリポジトリへのアクセスを構成することもできます。
インストール後のネットワークアクセス
クラスターのインストール後、仮想マシンは次へのアクセスが必要です。https://licensing-us.abbyy.comenv_specific.ymlファイルで SMTP settings が指定されているメールサーバー (メール招待の送信、パスワードの再設定などのため) 。- Vantage Process skills でメールをインポートする予定の、すべてのメールサーバー。
高可用性構成
- 仮想マシン
- Azure AKS
必要最小限の仮想マシン数を示しています。必要なパフォーマンスによっては、さらに多くの仮想マシンが必要になる場合があります。
高可用性なしの構成
- 仮想マシン
- Azure AKS
Vantage のインストール時に Kubernetes バージョン 1.33.3 がインストールされます。
Container Registry
- 仮想マシン
- Azure AKS
任意のコンテナー レジストリを使用できます。
データベース要件
- 仮想マシン
- Azure AKS
次の構成を満たす Microsoft SQL Server または PostgreSQL データベースが必要です。オプション 1: Microsoft SQL Server
オプション 2: PostgreSQL
外部データベース サーバーをセットアップし、新しいデータベースを作成および管理するための適切な認証情報を用意する必要があります。インストーラーでは、データベースへの接続に必要な SQL Server の IP アドレス、および Username とパスワードが必要です。
SMTP Server
env_specific.yml で SMTP を設定します。
認証あり (login と password を使用) のオプションを推奨します。
認証あり (ログイン名とパスワードを使用) のオプションを使用することをお勧めします。
TLS 証明書
静的IPアドレス
- 仮想マシン
- Azure AKS
1. Kubernetes APIへのアクセス。 クラスターの構成と管理のために、Kubernetes APIサーバーのエンドポイントへアクセスする際の仮想IPアドレスとして使用する静的IPアドレスです。IPアドレスは、次のように env_specific.yml ファイルで定義する必要があります。詳細については、「設定ファイルの設定」を参照してください。2. Vantage サービスへのアクセス。 HTTPS経由でVantage サービスにアクセスするために使用する静的IPアドレスです。適切な DNS Aレコード を事前に作成しておく必要があります。IPアドレスは、次のように env_specific.yml ファイルで定義する必要があります。詳細については、インストールを参照してください。
Vantageアクセス用DNSレコード
ストレージ要件
- 仮想マシン
- Azure AKS
外部ストレージは、高可用性なし構成でのみオプション要件となります。高可用性構成のディスク サイズ要件については、パフォーマンス ガイドで説明しています。ABBYY Vantage は、提供された仮想マシンのハードドライブ上にローカル ストレージを配置することで、製品のインストールを高速化します。ただし、このオプションも予期しない再起動や仮想マシンのクラッシュの影響を受ける可能性があります。保存されているデータが失われるおそれがあるため、インストール時には外部ストレージの使用をお勧めします。ABBYY Vantage では、以下の方法で特定のストレージ タイプの使用を設定できます。Vantage が正しく動作するよう、NFS サーバーのルートディレクトリ (たとえば /opt/nfs) には、次の権限と所有者を設定することを推奨します。以下は、Linux マシンを NFS サーバーとして使用する場合の 別の種類のストレージを接続する必要がある場合は、以下の独自のストレージクラスの定義セクションを参照してください。
ローカル ストレージを使用する
この場合、ReadWriteOnce の POSIX 互換アクセスを持つボリュームが、各 Kubernetes ノードの /opt/local_path_provisioner ディレクトリにローカルでプロビジョニングされます。ReadWriteMany ボリューム タイプの場合、Vantage は最初の abbyy_services ノードに in-cluster nfs-kernel-server をデプロイします (このノードの IP は、inventory ファイル内の対応するブロックの先頭に記載されたものです) 。NFS サーバーのデータは /opt/local_path_provisioner ディレクトリに保存されるため、最初の abbyy_services ノード (このグループの最初のノードは inventory ファイルで定義されています) では、このパス用に少なくとも 500 GB の専用ボリュームまたはディスクを必ず用意してください。高可用性構成では、最初の abbyy_services ノードがローカルの永続ボリューム ストレージもホストします。これには、処理負荷に応じて追加のハードドライブ容量が必要です。必要な容量の詳細については、パフォーマンス ガイドを参照してください。外部 NFS ストレージを使用する
Vantage インストーラーでは、共有フォルダーへの import と export、monitoring で収集されたデータの保存など、特定のサービスで Vantage ストレージとして使用する NFS ストレージを自動的に構成できます。env_specific.yml ファイル内のセクションは、次のようになります。/etc/exports ファイルにおけるディレクトリ設定例です:独自のストレージクラスの定義
NFS 以外の外部ストレージを使用する場合は、以下の手順に従ってください。- インストール時に、Kubernetes クラスターの作成後 (インストールスクリプトの実行 の手順 4) 、適切な CSI (Container Storage Interface) ドライバーをデプロイし、それらのストレージクラスを作成します。
- 次のコードを使用して、
env_specific.ymlファイルのk8sセクションに入力します。
- インストールを続行します。
Redis クラスター (Azure AKS のみ)
Redis クラスターが必要なのは、Azure AKS の高可用性構成の場合のみです。仮想マシンへのデプロイや、高可用性ではない Azure へのデプロイでは必要ありません。
redis.conf では、次のオプションを設定する必要があります。
maxmemory の値は、各 Redis ノードで使用可能なメモリの半分に設定してください。<password> はクラスターのパスワードに置き換えてください。- Azure インフラストラクチャの作成 - ARM テンプレートを使用した Azure リソース作成の手順
- FIPS コンプライアンス - 政府機関向けデプロイメントにおける FIPS 140-2 コンプライアンス要件
- インストール - 包括的なインストール ガイド
- パフォーマンス ガイド - スケーリングとパフォーマンス チューニング
