```
**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 | 説明 |
| :---------------------------------------------------------------------------------- | :------------------------------------------------------------------------------------------------- |
| `-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 | 説明 |
| :------------------------------------------------------------------------------------ | :------------------------------------------------------------------------------------------------- |
| `-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 クラスターに接続します。**
仮想マシンへのデプロイでは、この手順はスキップしてください。クラスターの資格情報は、手順 7 の Kubernetes インストール時に自動的に構成されます。
Docker コンテナーの起動後、Azure にサインインして AKS クラスターに接続します。
```bash theme={null}
# Azure にログイン
az login
# サブスクリプションを設定します（ご使用のサブスクリプション ID に置き換えてください）
az account set --subscription
# AKS クラスターの資格情報を取得します（ご使用の Resource Group とクラスター名に置き換えてください）
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
```
Azure AKS のデプロイでは、手順 6 と 7 は不要です。Kubernetes クラスターは Azure インフラストラクチャの作成ガイドですでにプロビジョニングされています。手順 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
```
プレイブックでは次の処理が行われます。
* プレイブックの `env_specific.yml` ファイルでパラメーターが指定されているリソース (データベースや SMTP 接続など) について、事前チェックを実行します。
* システム管理者に、EULA および ABBYY プライバシーポリシーの条件への同意を求めます。
**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
```
プレイブックは、メトリックおよびログ収集システムと ABBYY Vantage をデプロイします。インストール処理の完了にかかる時間は、選択したマシンの性能によって異なります。平均すると、処理には約 10 分かかります。Kubernetes 用の任意のツール (たとえば Lens ユーティリティ) を使用して、クラスター内の pod と job の実行を監視できます。そのためには、仮想マシンに Kubernetes をインストールした後に `kube` フォルダー内に作成される `kubeconfig` ファイルを使用します。以下の手順に従って、Ansible のインストールログファイルをローカルマシンにダウンロードすることもできます。
1. Docker コンテナーからログアウトします。
2. 次のコマンドを実行して、コンテナーの一覧を取得します。
```bash theme={null}
docker ps -a
```
installer が含まれるコンテナーの名前を確認します。
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` パラメーターの値が **false** だった場合) でも、Vantageのインストール後に有効化できます。そのためには、`env_specific.yml` ファイルの `logging.enabled` パラメーターの値を **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` パラメーターの値が **true** に設定されている場合、Business Processing Reporting Warehouse もインストールされます。`reporting.enabled` パラメーターの値が **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 の pod を再起動する必要があります。
### 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` パラメーターの値が **true** に設定されている場合は、Identity Documents アドオンもインストールされます。`id_reading.enabled` パラメーターの値が 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)