适用于 Google Cloud Platform 的联合架构：下载并部署 Horizon Edge Gateway

您可以下载 Horizon Edge Gateway 并将其部署到 Google Cloud Platform (GCP) 中的 Horizon 8 联合部署中，以便与 Horizon Cloud 配对。

对于为 Google Cloud GCVE 解决方案使用联合架构的 Edge 部署，下载并部署 Horizon Edge Gateway 设备。在联合架构中，必须将 Horizon Edge Gateway 部署到 Edge 环境内的本机 Google Cloud Platform (GCP) 基础架构中。

下面简要概述了将 Horizon Edge Gateway 部署到 Pod 环境内的本机 GCP 基础架构中时所需执行的步骤：

• 下载 Horizon Edge Gateway TAR 文件。
• 创建 Google Cloud Storage 存储桶并将设备 TAR 上载到该桶。
• 从上载的 TAR 文件创建自定义映像。
• 从自定义映像创建 Horizon Edge Gateway 虚拟机 (VM) 实例。

必备条件

您必须满足以下必备条件，然后才能继续。

• 确认您满足 Horizon 8 Edge 部署入门中所述的与 Horizon Edge Gateway 相关的必备条件。

• 确认您满足使相应的目标 URL 可访问以在 Microsoft Azure 环境中部署 Horizon Edge Gateway 中所述的条件，以便使用 Horizon Edge Gateway 将 Horizon 8 Pod 与 Horizon Cloud 配对。

• 确认您使用的是相应版本的 Horizon Edge Gateway。请参阅 Omnissa 产品互操作性列表。

• Horizon Edge Gateway 虚拟设备必须访问 Internet 才能与 Horizon Control Plane 进行通信。如果您的环境要求对要访问 Internet 的已部署设备使用代理服务器和代理配置，则在对 Horizon Edge Gateway 设备使用代理设置时，请确认您已查看与代理相关的信息、已知限制以及已知问题。

  **注意：**更新 Edge 中的代理配置。

  /opt/horizon/bin/configure-edge-gateway.sh --configure-proxy --proxy-host 127.0.0.1 --proxy-port 3128 --proxy-username 'exampleUsername' --proxy-password 'examplePassword'
  
  

  要了解更多选项，请使用 -h 选项运行该脚本，如下所示：

  /opt/horizon/bin/configure-edge-gateway.sh -h
  

• 要在通过 configure-edge-gateway.sh 脚本配对 Edge 时使用代理，必须先运行以下命令，若 ProxySSL 已启用，则指定为 true，否则指定为 false：

  /opt/horizon/bin/configure-edge-gateway.sh -p 'Pairing_Code' -x -i 'IP_or FQDN_of Proxy' -r 'Proxy_Port' -m 'Proxy_User_Name' -a 'Proxy_Password' -s 'true_or_false'
  

• 您可以使用 Google Cloud 图形用户界面 (Graphical User Interface, GUI) 或 Google Cloud 命令行界面 (CLI) 执行一些部署步骤。要使用 CLI，必须先在本地系统上安装所需的组件：

  • gsutil 工具。有关说明，请参阅 Google Cloud Storage 文档。
  • Google Cloud SDK。有关说明，请参阅 Google Cloud SDK 文档。

步骤

1. 按照添加和部署 Horizon 8 Edge 页面上相应过程中间部分获取 Horizon Edge Gateway 设备二进制文件的步骤，下载 Horizon Edge Gateway 磁盘映像。对屏幕上的所有提示做出响应。

   Horizon Edge Gateway 磁盘映像/设备以 TAR 文件形式提供。按照指定将 TAR 文件下载到本地系统。

   将下载的二进制文件保存到要将二进制文件部署到所需虚拟化平台的位置，然后返回到此步骤序列以继续执行所需的配对过程。

   **注意：**要将设备部署到 GCVE 环境中，请下载最新版本的 Horizon Edge Gateway 磁盘映像。我们建议您使用最新版本的 Edge 网关设备。有关版本信息，请参阅 Omnissa 产品互操作性列表。

   在将磁盘映像文件上载到 GCVE 环境之前，必须先创建 Google Cloud Storage 存储桶。

2. 在 GCVE 环境中创建 Google Cloud Storage 存储桶。有关详细说明，请参阅相应 Google Cloud 文档。

3. 将下载的 TAR 文件上载到 Google Cloud Storage 存储桶。您可以使用 Google Cloud 图形用户界面 (GUI) 或 Google Cloud 命令行界面 (CLI) 执行此步骤。

   • (GUI) 登录到适用于您的 GCVE 环境的 Google Cloud Platform。转到 Cloud Storage 页面，选择之前创建的存储桶，然后将 TAR 文件上载到该桶。

   • (CLI) 打开 gsutil 控制台并运行以下命令。

     gsutil cp <file-path-to-TAR-file> gs://<bucket-name>
     

4. 从上载的 TAR 文件创建自定义映像。

   • (GUI) 在 Google Cloud Platform 中，转到计算引擎 > 映像页面。选择创建映像的选项。在映像创建页面中，将 Cloud Storage 指定为源，然后浏览到已上载到存储桶中的 TAR 文件。根据需要指定其他映像属性，然后继续创建映像。

     确认新映像显示在映像列表中。

   • (CLI) 在 gsutil 控制台中，运行类似于以下示例的映像创建命令。

     gcloud compute --project <project-name> images create <image-name> --description <image-description> --source-uri <TAR-file-uri>
     

     **注意：**您可以根据需要使用相应参数自定义该命令。有关详细信息，请参阅 Google Cloud SDK 参考文档。

5. 要支持创建和配置 Horizon Edge Gateway 虚拟机实例，请准备类似于以下示例的启动脚本。

   #! /bin/bash
   /opt/horizon/bin/configure-adapter.py --sshEnable
   echo -e '<password>\n<password>' | passwd admin
   echo -e '<password>\n<password>' | passwd ccadmin
   echo 'cs_ip cs_fqdn' >> /etc/hosts
   

   在该示例中，启动脚本支持以下配置：

   • 启用对 Horizon Edge Gateway 设备的 SSH 访问。
   • 在设备上创建具有指定密码 (\n) 的 admin 用户帐户。确保您定义了强密码。
   • 在设备上创建具有指定密码 (\n) 的 ccadmin 用户帐户。确保您定义了强密码。
   • 将连接服务器主机名 (cs_fqdn) 解析为连接服务器 IP 地址 (cs_ip)。

6. 从自定义映像创建 Horizon Edge Gateway 虚拟机实例。确保至少为虚拟机大小调整或虚拟机类型配置 n2-standard-8。

   • (GUI) 在 Google Cloud Platform 中，转到映像页面，选择之前创建的自定义映像，然后选择创建虚拟机实例的选项。至少为虚拟机大小调整或虚拟机类型指定 n2-standard-8，将自定义映像指定为引导磁盘，并添加之前准备的启动脚本。指定其他相应的虚拟机属性，然后继续创建虚拟机实例。

     确认 Horizon Edge Gateway 虚拟机显示在虚拟机实例列表中。

   • (CLI) 在 gsutil 控制台中，运行类似于以下示例的实例创建命令。

     gcloud compute --project <project-name> instances create <instance-name> 
     --zone <zone> --machine-type <n2-standard-8-minimum> --network <network> 
     --subnet <subnet> --maintenance-policy <maintenance-policy> --scopes <scope> 
     --image <custom-TAR-image> --metadata startup-script=<startup-script>
     

     **注意：**您可以根据需要使用相应参数自定义该命令。有关详细信息，请参阅 Google Cloud SDK 参考文档。

7. 在 Horizon Edge Gateway 虚拟机启动后，编辑该虚拟机实例的配置并移除启动脚本。

   **重要信息：**您必须从实例中移除启动脚本，以防止在 Horizon Edge Gateway 每次重新引导时都运行该脚本。

8. 通过 SSH 连接到 Horizon Edge Gateway 虚拟机 GCP 实例。

   如需了解相关信息，请参阅为 Horizon Edge 启用 SSH 访问。

   有关连接到您的实例的详细信息，请参阅 Google Cloud 文档。我们建议使用 SSH 以便可以复制粘贴配对密钥。

9. 使用以下命令格式运行配对 Edge 脚本，其中，pairing_code 是从添加和部署 Horizon 8 Edge 中所述过程中间部分的部署并配对 Horizon Edge Gateway 步骤中复制的配对代码。

```

sudo su -
/opt/horizon/bin/configure-edge-gateway.sh -p <pairing_code>
```

11. 为了提高安全性，请考虑在完成这些步骤后停用 SSH。

12. 返回到 Horizon Universal Console 以完成 Horizon Connection Server 详细信息的配置。请参阅添加和部署 Horizon 8 Edge。