Vantage をインストールする前に、次の外部コンポーネントを準備および設定しておきます。
- Docker とインターネット接続を備えたマシン（Vantage のインストールに使用するマシン）
- Kubernetes ノードとして使用する仮想マシン（インストール中はインターネット接続が必要）
- Docker イメージを保存するコンテナレジストリ
- Vantage の動作に使用するリレーショナルデータベース管理システム（RDBMS）
- Vantage ユーザーにメールメッセージを送信するための SMTP サーバー
- 暗号化通信を確立するための TLS 証明書
- 2 つの固定 IP アドレス（1 つは Kubernetes の構成／管理用、1 つは Vantage アクセス用）
- Vantage アクセス用の DNS レコード
- 外部ストレージ（高可用性構成を使用しない場合は任意）
Vantage をインストールするマシンは、次の要件を満たしている必要があります。
- Linux OS または Windows Subsystem for Linux (WSL)
- Docker バージョン 19.03 以降
abyvtgonprm27.azurecr.io へのネットワーク アクセスansible ユーザー アカウント用の秘密 SSH キー（パスフレーズなし）を格納したローカル ファイル
すべての仮想マシンは同じ SSH キーを使用する必要があります。
- 静的 IP アドレス
- 次の権限を持つ
ansible という名前のユーザーアカウント:
- 共有された SSH キーによるアクセス
- NOPASSWD オプション付きの sudo アクセス
- 各ワーカーノード上で
/opt/local-path-provisioner にマウントされた、拡張可能な専用ディスク / lvm_volume
- インストール時にコンテナレジストリおよびパッケージリポジトリへアクセス可能なインターネット接続:
共通 (すべてのディストリビューション):
curl, socat, unzip, e2fsprogs, xfsprogs, ebtables, tar
python3-apt, apt-transport-https, software-properties-common,
conntrack, libseccomp2
device-mapper-libs, nss, conntrack, container-selinux, libseccomp
https://licensing-us.abbyy.com- メールサーバー（メールによる招待送信やパスワードのリカバリなどのため）。SMTP 設定は
env_specific.yml ファイルで指定します。
- Vantage の Process skills でメールをインポートする予定のすべてのメールサーバー。これらは、それぞれインポート対象のメールアドレスが登録されているメールサーバーでなければなりません。
必要となる仮想マシン数の最小値を示しています。求めるパフォーマンスによっては、異なる台数の仮想マシンが必要になる場合があります。
| Kubernetes ノード種別 | マスターノード | ワーカーノード（Services） | ワーカーノード（Workers） |
|---|
| オペレーティングシステム | Ubuntu 20.04 または RHEL 8 | Ubuntu 20.04 または RHEL 8 | Ubuntu 20.04 または RHEL 8 |
| VM 数 | 3 | 4 | 1 |
| CPU コア数（VM ごと） | 2 | 12 | 12 |
| RAM（VM ごと、GB） | 4 | 48 | 48 |
| Kubernetes 用ディスクストレージ（VM ごと、GB） | 50 | 80 | 80 |
/opt/local-path-provisioner マウントポイント用ディスク/ボリューム（GB） | 不要 | 最小 40 | 最小 40 |
| ネットワーク帯域幅（VM ごと、Gbps） | 1 | 1 | 1 |
| Kubernetes ノード種別 | マスターノード | ワーカーノード（Services） | ワーカーノード（Workers） |
|---|
| オペレーティングシステム | Ubuntu 20.04 または RHEL 8 | Ubuntu 20.04 または RHEL 8 | Ubuntu 20.04 または RHEL 8 |
| VM の台数 | 1 | 1 | 1 |
| CPU コア数（各 VM あたり） | 2 | 12 | 12 |
| RAM（GB）（各 VM あたり） | 4 | 48 | 48 |
| Kubernetes 用ディスクストレージ（GB）（各 VM あたり） | 50 | 80 | 80 |
/opt/local-path-provisioner マウントポイント用ディスク/ボリューム（GB） | 不要 | 最小 40 | 最小 40 |
| ネットワーク帯域幅（Gbps）（各 VM あたり） | 1 | 1 | 1 |
Vantage のインストール中に Kubernetes バージョン 1.28.4 がインストールされます。
| バージョン | OS | CPU コア数 | RAM, GB | ディスク容量, GB | フルテキスト検索 |
|---|
| Enterprise 2022 | Linux | 4 | 4 | 推奨: 400, 最小: 200 | 有効 |
env_specific.yml で、認証ありまたは認証なしの SMTP を設定します。
認証あり（ログインとパスワード あり）のオプションを使用することを推奨します。
smtp:
host: X.X.X.X
login: email
password: password
port: 587
useSSL: false
secureSocketOptions: null
mailFrom: email
smtp:
host: X.X.X.X
login: null
password: null
port: 25
useSSL: false
secureSocketOptions: None
認証（ログインとパスワード）付きのオプションを使用することを推奨します。
loadbalancer:
external_ip: X.X.X.X
提供された仮想マシンのハードディスク上のローカルストレージを使用する
ローカル永続ボリュームストレージの空き容量が不足すると、一部のデータが失われ、Vantage が動作を停止する可能性があります。お客様側で空き容量を監視し、残り容量が少なくなった際のアラートを設定して、データ損失を防ぐために、時間内にストレージを追加できるようにすることを推奨します。
env_specific.yml ファイル内の該当セクションは次のようになります。
k8s:
storage:
rwx:
external:
enabled: true
type: "nfs"
nfs:
address: <NFSサーバーのIPアドレス>
path: <NFSサーバーのエクスポート共有パス>
drwxr-xr-x 4 65532 65532 4096 Dec 12 09:25 /opt/nfs/
/etc/exports ファイルにおけるディレクトリ設定例です。
/opt/nfs *(rw,sync,all_squash,insecure,no_subtree_check,anonuid=65532,anongid=65532)
- インストール手順の中で、Kubernetes クラスターの作成（インストールスクリプトの実行 のステップ 4）後に、該当する CSI（Container Storage Interface）ドライバーをデプロイし、それに対応するストレージクラスを作成します。
- 次のコードを使用して、
env_specific.yml ファイル内の k8s セクションを設定します。
k8s:
storage:
rwo:
class_name: "<rwo posix compatible storage class>"
rwx:
class_name: "<read_write_many_storage_class>"
- インストールを続行します。
NFS ストレージを使用する場合は、env_specific.yml で設定を行います：
k8s:
storage:
rwx:
external:
enabled: true
type: "nfs"
nfs:
address: <your nfs server IP address>
path: <your nfs server exported share>
ローカル永続ボリュームの空き容量が不足すると、データが失われて Vantage が動作しなくなる可能性があります。空き容量を監視し、アラートを設定してください。
