第 1 世代テナント - Horizon ポッド - VMware Cloud on AWS を使用したフェレデーションアーキテクチャ：Horizon Cloud Connector をダウンロードしてポッドの環境にデプロイする

次の手順に従って、VMware Cloud on AWS を使用したフェレデーションアーキテクチャを使用するポッド環境の Horizon Cloud Connector アプライアンスをダウンロードしてデプロイします。フェレデーションアーキテクチャでは、ポッドの環境内のネイティブの Amazon Elastic Computer Cloud (EC2) インフラストラクチャに Horizon Cloud Connector をデプロイする必要があります。

重要：この情報は、第 1 世代の制御プレーンで第 1 世代のテナント環境にアクセスできる場合にのみ適用されます。 KB-92424 で説明されているように、第 1 世代の制御プレーンは提供終了 (EOA) となりました。詳細については、該当記事を参照してください。

Horizon ポッドのデプロイアーキテクチャの背景情報については、第 1 世代テナント - 第 1 世代 Horizon Cloud を使用した Horizon ポッドのデプロイアーキテクチャを参照してください。

以下は、ポッドの環境内のネイティブの Amazon EC2 インフラストラクチャに Horizon Cloud Connector をデプロイするために必要な手順の概要です。

VMDK 形式の Horizon Cloud Connector ファイルをダウンロードします。
Amazon EC2 に Amazon Simple Storage Service (S3) バケットを作成し、アプライアンスの VMDK ファイルをそのバケットにアップロードします。
アップロードした VMDK ファイルからカスタムイメージを作成します。
カスタムイメージから Horizon Cloud Connector 仮想マシン (VM) インスタンスを作成します。

重要： Horizon Cloud Connector をネイティブの Amazon EC2 インフラストラクチャにデプロイすると、次の Horizon Cloud サービスがデフォルトで無効になります。アプライアンスをデプロイした後、オプションでこれらのサービスを 1 つ以上手動で有効にすることができます。

Cloud Monitoring Service
クラウドブローカクライアントサービス
イメージローカリティサービス

前提条件

第 1 世代テナント - Horizon ポッドと Horizon Cloud Connector - 第 1 世代の制御プレーンサービスにオンボーディングする準備に記載されているコネクタ関連の前提条件を満たしていることを確認します。
Horizon ポッドと Horizon Cloud をペアリングするために Horizon Cloud Connector を使用するためのDNS、ポート、およびプロトコル要件を満たしていることを確認します。
Horizon Cloud Connector 仮想アプライアンスは、インターネットにアクセスして Horizon Cloud 制御プレーンと通信する必要があります。ご使用の環境で、デプロイされたアプライアンスがインターネットにアクセスするためにプロキシサーバとプロキシ構成を使用する必要がある場合、プロキシ設定を Horizon Cloud Connector アプライアンスで使用するときのプロキシ関連の情報、既知の制限、既知の問題を認識していることを確認します。第 1 世代テナント - Horizon ポッドと Horizon Cloud Connector - 第 1 世代の制御プレーンサービスにオンボーディングする準備、Horizon Cloud Connector の既知の考慮事項、およびHorizon Cloud Connector 1.6 以降のプロキシ設定の変更のプロキシ関連情報を参照してください。
多くの手順では、AWS コマンドラインを使用する必要があります。ただし、AWS マネジメントコンソールまたは AWS コマンドラインインターフェイス (CLI) を使用して実行できるデプロイ手順もあります。Amazon EC2 環境の操作の詳細については、https://docs.aws.amazon.com/ec2/index.html にある Amazon Elastic Compute Cloud のドキュメントを参照してください。以下の手順では、特定のタイプの Amazon Elastic Compute Cloud ドキュメントを参照することをお勧めすることがよくあります。

手順

サブスクリプションメールに記載されているリンクを使用して、Horizon Cloud Connector ディスクイメージをダウンロードします。

注：アプライアンスの Amazon EC2 環境へのデプロイをサポートするには、バージョン 2.0 以降の Horizon Cloud Connector ディスクイメージをダウンロードする必要があります。

Horizon Cloud Connector ディスクイメージは、My VMware アカウントの認証情報を使用して my.vmware.com にログインした後、VMDK ファイルとして利用できます。VMDK ファイルをローカルシステムにダウンロードします。

ディスクイメージファイルを Amazon EC2 環境にアップロードする前に、まず Amazon S3 バケットを作成する必要があります。
Amazon EC2 環境で Amazon S3 バケットを作成します。詳細な手順については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
ダウンロードした VMDK ファイルを Amazon S3 バケットにアップロードします。この手順は、AWS マネジメントコンソールまたは AWS コマンドラインインターフェイス (CLI) を使用して実行できます。
- （AWS マネジメントコンソール）Amazon EC2 環境の AWS マネジメントコンソールにログインします。S3 サービスに移動し、以前に作成したバケットを選択し、そのバケットに VMDK ファイルをアップロードします。
- (AWS CLI) AWS CLI にアクセスし、次のコマンドを実行します。
```
aws s3 cp <file-path-to-VMDK-file> <S3URI>
```
  cp コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
AWS マネジメントコンソールでは、VMDK ファイルは [オブジェクト] タブに表示されます。
サービスロールとポリシーを作成し、ポリシーをロールに添付します。
1. この手順に必要な 3 つの新しい JSON ファイルの最初のファイルを作成します。
  この特定の JSON ファイルの目的は、サービスとロールの情報を格納することです。ファイルに任意の名前を付けます。この手順では、このファイルのファイル名の例は trust-policy.json です。
2. 任意の名前でサービスロールを作成し、新しい JSON ファイルにロール情報を保存します。
  たとえば、CLI を使用して、次のようなコマンドを実行します。
  次のコマンドは一般的な例です。
```
aws iam create-role --role-name <role-name> --assume-role-policy-document <file-path>
```
  次のコマンドの例では、プレースホルダ <role-name> を特定の例 vmimport に置き換え、プレースホルダ <file-path> を特定の例 trust-policy.json に置き換えています。
```
aws iam create-role --role-name vmimport --assume-role-policy-document file://trust-policy.json
```
  create-role コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
  次のテキストは、上記のコマンドを実行した後の JSON ファイルの内容の例です。
```
{
    "Version":"2012-10-17",
    "Statement":[
        {
            "Sid":"",
            "Effect":"Allow",
            "Principal":{
                "Service":"vmie.amazonaws.com"
            },
            "Action":"sts:AssumeRole",
            "Condition":{
                "StringEquals":{
                    "sts:ExternalId":"vmimport"
                }
            }
        }
    ]
}
```
3. この手順に必要な 3 つの新しい JSON ファイルの 2 番目のファイルを作成します。
  以下の例で使用する <bucket-name> など、VMDK ファイルをアップロードするバケットの名前を指定します。
  
  この特定の JSON ファイルの目的は、新しいポリシーを新しいロールに添付することです。ファイルに任意の名前を付けます。この手順では、このファイルのファイル名の例は role-policy.json です。
  次のテキストは、サンプルの role-policy.json ファイルの内容の例です。
```
{
    "Version":"2012-10-17",
    "Statement":[
        {
            "Effect":"Allow",
            "Action":[
                "s3:ListBucket",
                "s3:GetBucketLocation"
            ],
            "Resource":[
                "arn:aws:s3:::<bucket-name>"
            ]
        },
        {
            "Effect":"Allow",
            "Action":[
                "s3:GetObject"
            ],
            "Resource":[
                "arn:aws:s3:::<bucket-name>/*"
            ]
        },
        {
            "Effect":"Allow",
            "Action":[
                "ec2:ModifySnapshotAttribute",
                "ec2:CopySnapshot",
                "ec2:RegisterImage",
                "ec2:Describe*"
            ],
            "Resource":"*"
        }
    ]
}
```
4. ポリシーを作成し、新しいロールに添付して、新しく作成した JSON ファイルに保存します。
  
  たとえば、CLI を使用して、次のようなコマンドを実行します。
  次のコマンドは一般的な例です。
```
aws iam put-role-policy --role-name <role-name> --policy-name <policy-name> --policy-document <file-path>
```
  次の具体例では、プレースホルダ <role-name> を、vmimport という名前のポリシーの具体例に置き換え、プレースホルダ <policy-name> を以前に名前を付けたロール、つまり vmimport という名前のロールの具体例に置き換え、プレースホルダ <file-path> を以前に名前を付けた JSON ファイル role-policy.json の具体例に置き換えます。
```
aws iam put-role-policy --role-name vmimport --policy-name vmimport --policy-document file://role-policy.json
```
  put-role-policy コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
インポートされた VMDK ファイルからスナップショットをインポートします。
1. この手順に必要な 3 つの新しい JSON ファイルの 3 番目のファイルを作成します。
  このファイルに次の情報を含めます。
  - バケット名（次の例で使用されている <bucket-name> など）。
  - Amazon S3 バケットにアップロードした VMDK ファイルのファイル名（次の例で使用されている <vmdk-file-name-uploaded-to-S3> など）。
  この特定の JSON ファイルの目的は、インポートされた VMDK ファイルのスナップショットを格納することです。ファイルに任意の名前を付けます。この手順では、このファイルのファイル名の例は container.json です。
  次のテキストは、 container.json ファイルの内容の例です。
```
{
    "Description": "Adapter-VM",
    "Format": "vmdk",
    "UserBucket": {
        "S3Bucket": "<bucket-name>",
        "S3Key": "<vmdk-file-name-uploaded-to-S3>"
    }
}
```
2. コマンドを実行して、インポートした VMDK ファイルから新しく作成した JSON ファイルにスナップショットをインポートします。
  CLI を使用して、次のタイプのコマンドを実行します。
```
aws ec2 import-snapshot --role-name <role-name> --description <description> --disk-container <file-path>
```
  import-snapshot コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
  次のコマンドは、 import-snapshot コマンドの具体例です。ここでは、 role-name パラメータはオプションで使用されておらず、説明は "Adapter-VM" で、コンテナのファイル名は container.json です。
```
aws ec2 import-snapshot --description "Adapter-VM" --disk-container file://container.json
```
  import-snapshot コマンドは完了まで数分かかることがあります。ただし、コマンドを実行すると、コマンドの出力が作成されます。この出力には、タスクの進行状況の追跡に使用できる ImportTaskId 行が含まれています。次の出力に一例を示します。
```
{
    "ImportTaskId": "import-snap-05b4c84af4xxxxxxx",
    "Description": "Adapter-VM",
    "SnapshotTaskDetail": {
        "StatusMessage": "pending",
        "UserBucket": {
              "S3Bucket": "awsbucket",
             "S3Key": "horizon-cloud-connector-2.0.0.0-18191154_OVF10-disk1.vmdk"
         },
       "Progress": "0",
       "Status": "active",
        "Description": "Adapter-VM",
        "DiskImageSize": 0.0
    }

}
```
3. import-snapshot コマンド出力の ImportTaskId 値を書き留めます。
import-snapshot タスクの進行状況を追跡し、スナップショット ID を取得するには、次のコマンドを実行します。
```
aws ec2 describe-import-snapshot-tasks --import-task-ids <import-task-id>
```
<import-task-id> プレースホルダを import-snapshot コマンド出力にリストされた値に置き換えます。上記の出力例にリストされている値の例は import-snap-05b4c84af4xxxxxxx です。describe-import-snapshot-tasks コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
describe-import-snapshot-tasks コマンドは、 import-snapshot タスクの進行状況を示す出力を提供し、タスクが完了すると、イメージの登録に必要なスナップショット ID を提供します。次に例を示します。
- "Progress": "43"。この行のような出力の行は、import-snapshot タスクの進行状況の割合を示します。この例では、タスクは 43% 完了しています。
- "Status": "completed"。この行のような出力の行は、import-snapshot タスクが完了したことを示します。
- "SnapshotId": "snap-06d42e043bxxxxxxx"。タスクが完了すると、出力にこのような行が含まれます。この例では、スナップショット ID は snap-06d42e043bxxxxxxx です。
describe-import-snapshot-tasks コマンドの出力からスナップショット ID を書き留めます。
スナップショットイメージを登録するには、register-image コマンドを実行します。
```
aws ec2 register-image --region us-west-2 --name <image-name> --architecture x86_64 --root-device-name '/dev/sda1' --virtualization-type hvm --ena-support --block-device-mappings DeviceName=/dev/sda1,Ebs={SnapshotId=<SnapshotId>} 
```
ここでは、 --region、 --architecture など、各オプションのデプロイに固有の応答を提供する必要があります。 register-image コマンドの実行の詳細については、Amazon Elastic Compute Cloud のドキュメントを参照してください。
次の情報は、--name オプションと SnapshotId パラメータに固有です。
- --name - 文字列の制約に従って、イメージの名前を指定します。
- SnapshotId - describe-import-snapshot-tasks コマンド出力からのスナップショット ID を指定します。
register-image コマンドは、Amazon Machine Image (AMI) の ID を含む出力を提供します。次の例は、典型的な register-image 出力です。
```
    {
        "ImageId": "ami-0721ee000321c4685"
    }
```
register-image コマンド出力に示されている AMI は、AWS マネジメントコンソールの AMI のリストの中にも表示されます。
Horizon Cloud Connector AMI インスタンスの作成と構成をサポートするには、次の例のような起動スクリプトを準備します。
```
#! /bin/bash
/usr/bin/python3 /opt/vmware/bin/configure-adapter.py --sshEnable
sudo useradd ccadmin
echo -e 'password\npassword' | passwd ccadmin
echo 'cs_ip cs_fqdn' >> /etc/hosts
```
この例では、スクリプトが次の構成をサポートしています。
- Horizon Cloud Connector アプライアンスへの SSH アクセスの有効化。
- 定義されたパスワード (password) を使用したアプライアンス上での ccadmin ユーザーアカウントの作成。強力なパスワードを定義してください。強力なパスワードは 8 文字以上で、1 つ以上の数字、大文字と小文字、特殊文字を含める必要があります。
- Connection Server のホスト名 (cs_fqdn) から Connection Server の IP アドレス (cs_ip) への解決。
Horizon Cloud Connector AMI インスタンスを起動する次の手順で、このスクリプトをユーザーデータに追加する必要があります。
Horizon Cloud Connector の AMI インスタンスを起動します。

重要：インスタンスで十分な機能が提供されるようにするには、モデル c5.2xlarge 以上を使用します。

インスタンスは、AWS マネジメントコンソールまたは CLI を使用して起動できます。いずれの場合も、register-image コマンドの出力で提供される Amazon Machine Image (AMI) の ID を使用し、前の手順で準備した起動スクリプトをユーザーデータに追加します。

重要：ユーザーデータは AMI インスタンスの最初の起動シーケンスでのみ実行されるため、この時点で起動スクリプトを追加する必要があります。

CLI を使用するには、Amazon Elastic Compute Cloud のドキュメントを参照して、run-instances コマンドの実行の詳細を確認してください。

AWS マネジメントコンソールを使用するには、Amazon Elastic Compute Cloud のドキュメントで詳細（インスタンスの起動ウィザードを使用したインスタンスの起動など）を参照してください。

AWS マネジメントコンソールを使用してインスタンスを起動する場合、イメージ ID で新しい AMI を探して、AMI を選択し、[起動] をクリックします。その後、デプロイの詳細を指定してウィザードを続行できます。
Horizon Cloud Connector AMI が起動したら、AMI インスタンスの構成を編集し、起動スクリプトを削除します。

次のタスク

第 1 世代テナント - Horizon ポッドと仮想アプライアンスの第 1 世代 Horizon 制御プレーンとのペアリングの準備ができていることを確認するの手順に従って、ポッドのオンボーディングワークフローを続行します。第 1 世代テナント - Horizon Cloud Connector 構成ポータルを使用して Horizon ポッドと第 1 世代 Horizon Cloud のペアリングを完了するに進みます。

注：デフォルトで無効になっている 1 つ以上のクラウドプレーンサービスを有効にする場合は、ポッドとクラウドプレーンのペアリングを完了する前にそれらを有効にする必要があります。第 1 世代テナント - ネイティブの Amazon EC2 の Horizon Cloud Connector に対し第 1 世代の Horizon Cloud 制御プレーンサービスを手動で有効にするを参照してください。