```
**3. まだインストーラーを実行していない場合は、Docker イメージからインストーラーを実行します。**
```bash theme={null}
docker run -it \
-v $PWD/kube:/home/ansible/.kube \
-v $PWD/ssh/ansible:/home/ansible/.ssh/ansible \
-v "//var/run/docker.sock:/var/run/docker.sock" \
-v $PWD/inventory:/ansible/inventories/k8s/inventory \
-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
--privileged \
abyvtgonprm27.azurecr.io/vantage-installer:2.7.1
```
| Parameter | Description |
| :---------------------------------------------------------------------------------- | :--------------------------------------------------------------------------- |
| `-v $PWD/kube:/home/ansible/.kube` | kube/config ファイルが保存されている Kubernetes ディレクトリへのパス。 |
| `-v $PWD/ssh/ansible:/home/ansible/.ssh/ansible` | Kubernetes クラスターおよび一部の前提条件をインストールおよび構成するために必要な SSH 秘密鍵へのパス。 |
| `-v "//var/run/docker.sock:/var/run/docker.sock"` | コンテナーレジストリへのイメージ同期に必要です。 |
| `-v $PWD/inventory:/ansible/inventories/k8s/inventory` | **inventory** ファイルへのパス。 |
| `-v $PWD/env_specific.yml:/ansible/inventories/k8s/group_vars/all/env_specific.yml` | **env\_specific.yml** ファイルへのパス。 |
| `-v $PWD/ssl:/ansible/files/ssl:ro` | 次のファイルを含める必要がある SSL 証明書フォルダーへのパス: **cert.pem**、**key.pem**、**adfsroot.pem**。 |
```bash theme={null}
docker run -it \
-v $PWD/env_specific.yml:/ansible/inventories/azure/group_vars/all/env_specific.yml \
-v $PWD/ssl:/ansible/files/ssl:ro \
abyvtgonprm27.azurecr.io/vantage-installer:2.7.1
```
| Parameter | Description |
| :------------------------------------------------------------------------------------ | :--------------------------------------------------------------------------- |
| `-v $PWD/env_specific.yml:/ansible/inventories/azure/group_vars/all/env_specific.yml` | **env\_specific.yml** ファイルへのパス。 |
| `-v $PWD/ssl:/ansible/files/ssl:ro` | 次のファイルを含める必要がある SSL 証明書フォルダーへのパス: **cert.pem**、**key.pem**、**adfsroot.pem**。 |
**4. Azure AKS クラスターに接続します。**
Virtual Machine デプロイの場合はこの手順をスキップしてください。クラスター資格情報は、手順 7 の Kubernetes インストール中に自動的に構成されます。
Docker コンテナーの起動後、Azure にサインインして AKS クラスターに接続します。
```bash theme={null}
# Azure にログイン
az login
# サブスクリプションを設定（自分のサブスクリプション ID に置き換えてください）
az account set --subscription
# AKS クラスターの資格情報を取得（リソース グループ名とクラスター名に置き換えてください）
az aks get-credentials --resource-group --name
# クラスター接続を検証
kubectl cluster-info
```
**5. コンテナーイメージをダウンロードします**
マイグレーションスクリプトは `env_specific.yml` 内の次のプロパティに依存します。
```yaml theme={null}
source_container_registry_host: sourcerepo.azurecr.io
source_container_registry_user: user
source_container_registry_password: pass
source_container_registry_name: "{{ source_container_registry_host }}/optional/subpath"
container_registry_host: destinationrepo.azurecr.io
container_registry_user: user
container_registry_password: pass
container_registry_name: "{{ container_registry_host }}/optional/subpath"
```
```bash theme={null}
ansible-playbook -i inventories/k8s playbooks/validate-artifact-manifest.yml
ansible-playbook -i inventories/k8s playbooks/oci-migration.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure playbooks/validate-artifact-manifest.yml
ansible-playbook -i inventories/azure playbooks/oci-migration.yml
```
**6. SSH キーの権限を設定します:**
```bash theme={null}
chmod 600 /home/ansible/.ssh/ansible
```
**7. Kubernetes クラスターのインストールとセットアップ:**
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/4-Kubernetes-k8s.yml
```
手順 6 および 7 は Azure AKS デプロイには不要です。Kubernetes クラスターは Azure Infrastructure Creation ガイドに従ってすでにプロビジョニングされています。手順 8 に進んでください。
**8. 事前デプロイチェックを実行し、法的文書に同意する:**
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/0-PreflightCheck-k8s.yml
ansible-playbook -i inventories/k8s -v playbooks/legal.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure playbooks/0-PreflightCheck-azure.yml
ansible-playbook -i inventories/azure playbooks/legal.yml
```
この playbook は次の処理を行います。
* playbook の `env_specific.yml` ファイルで指定されているパラメーターを持つリソース (データベースや SMTP 接続など) について、事前チェックを実行します。
* システム管理者に対し、EULA および ABBYY Privacy Policy の条件に同意するよう求めます。
**9. 製品をインストールする:**
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/site-k8s-deploy.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure playbooks/site-azure-deploy.yml
```
この playbook はメトリクスおよびログ収集システムをデプロイし、ABBYY Vantage をデプロイします。インストール処理の完了に必要な時間は、選択したマシンのパフォーマンスによって左右されます。平均して、この処理には約 10 分かかります。Kubernetes 用の任意のツール (たとえば Lens ユーティリティ) を使用して、クラスター内の Pod とジョブの実行状況を監視できます。そのためには、仮想マシンに Kubernetes をインストールした後に `kube` フォルダー内に作成される `kubeconfig` ファイルを使用します。以下の手順に従って、Ansible のインストールログファイルをローカルマシンにダウンロードすることもできます。
1. Docker コンテナーからログアウトします。
2. コンテナーの一覧を取得するには、次のコマンドを実行します。
```bash theme={null}
docker ps -a
```
インストーラーが入っているコンテナの名前を確認します。
3. ログを取得するには、次のコマンドを実行します。**container\_name** をコンテナ名に置き換えてください。
```bash theme={null}
docker cp container_name:/ansible/ansible.log ansible.log
```
デプロイが完了すると、次の情報が提供されます。
* 提供されたドメイン名の URL
* ログイン、テナントの作成、およびドキュメントの処理に使用できるシステム管理者用のユーザー名とパスワード
### インストール ログの取得
```bash theme={null}
# Dockerコンテナを終了した後:
docker ps -a
# コンテナ名を確認した後:
docker cp container_name:/ansible/ansible.log ansible.log
```
## 任意のデプロイ
### ログシステムのデプロイ
Vantage のインストール時にログシステムを有効にしていなかった場合 (`env_specific.yml` ファイル内の `logging.enabled` Parameter の値が **false** だった場合) は、Vantage のインストール後に有効化できます。その場合は、`env_specific.yml` ファイル内の `logging.enabled` Parameter の値を **true** に設定し、次のコマンドを実行します。
```bash theme={null}
ansible-playbook -i inventories/k8s playbooks/6-DeployMonitoring-k8s.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure playbooks/6-DeployMonitoring-azure.yml
```
### Business Processing Reporting Warehouse のデプロイ
Business Processing Reporting Warehouse は、ビジネス プロセスを分析し、特定期間のデータを追跡するためのコンポーネントです。Vantage のインストール時に、env\_specific.yml ファイル内の `reporting.enabled` Parameter の値が **true** に設定されている場合は、Business Processing Reporting Warehouse も同時にインストールされます。`reporting.enabled` Parameter の値が **false** に設定されている場合は、Vantage のインストール後に次のコマンドを実行して、Business Processing Reporting Warehouse をインストールできます。
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/deploy-reporting.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure -v playbooks/deploy-reporting.yml
```
インストール後、正しいレポート用 URL が読み込まれるように、Public API ポッドを再起動する必要があります。
### Identity Documents アドオンのデプロイ
Identity Documents アドオンを使用するには、Vantage から `https://lic.regulaforensics.com` および `https://lic2.regulaforensics.com` へのインターネットアクセスが必要です。
Identity Documents アドオンサービスを使用すると、各国で発行された身分証明書からデータを抽出するための Identity Documents Skill を実行できます。
Vantage のインストール時に、`env_specific.yml` ファイル内の `id_reading.enabled` Parameter の値が **true** に設定されている場合は、Identity Documents アドオンもインストールされます。`id_reading.enabled` Parameter の値が false に設定されていた場合は、Vantage のインストール後に次のコマンドを実行して Identity Documents アドオンをインストールできます。
```bash theme={null}
ansible-playbook -i inventories/k8s -v playbooks/12-DeployDocumentReader.yml
```
```bash theme={null}
ansible-playbook -i inventories/azure -v playbooks/12-DeployDocumentReader.yml
```
Vantage がインストールされているクラスターから、次のアドレスにアクセスできるようにしておく必要があります。
[https://lic.regulaforensics.com](https://lic.regulaforensics.com)
[https://lic2.regulaforensics.com](https://lic2.regulaforensics.com)