App Launchpad 作为 RPM 安装文件分发,其名称格式为 vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm,其中 v.v.v 是产品版本,nnnnnnnn 是内部版本号。例如,vmware-vcd-alp-2.0.0-36472856.el7.x86_64.rpm

前提条件

  • 确认目标环境满足 App Launchpad 的部署要求。有关详细信息,请参见开始之前
  • 确认您拥有 VMware Cloud Director 系统管理员帐户的凭据。您需要拥有系统管理员的凭据才能创建 App-Launchpad-Service 帐户。
  • 确认已将安装 RPM 软件包上载到目标计算机的 /tmp 目录。

过程

  1. 打开与安装目标 Linux 虚拟机的 SSH 连接,登录并使用 su 获取 root 用户特权。
  2. 通过运行以下安装命令来安装 RPM 软件包。
    rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
    如果在部署目标计算机上安装了 Java SE JDK 11,为避免出现安装问题,请附加 --nodeps 参数。
    rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
  3. App Launchpad 配置 VMware Cloud Director
    要为 App Launchpad 配置 VMware Cloud Director,请使用 alp connect 脚本。通过使用此脚本,您可以在 App LaunchpadVMware Cloud Director 之间建立连接,定义或创建 App-Launchpad-Service 帐户,并安装适用于 VMware Cloud DirectorApp Launchpad 用户界面插件。 alp connect 脚本还可为 App Launchpad 配置 AMQP 代理。
    1. 配置 App LaunchpadVMware Cloud Director 之间的连接。
      如果要连接到 VMware Cloud Director 10.2 或更高版本,请运行以下命令:
      alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --mqtt
      如果要连接到版本低于 10.2 的 VMware Cloud Director,请运行以下命令:
      alp connect --sa-user account-to-become-alp-service-account --sa-pass 'service-account-pass' --url Cloud-Director-URL --admin-user Cloud-Director-system-administrator@system --admin-pass 'Cloud-Director-system-administrator-pass' --amqp-exchange dedicated-exchange-name --amqp-user dedicated-amqp-user --amqp-pass 'dedicated-amqp-user-password' --amqp-queue dedicated-amqp-queue --amqp-routingkey dedicated-amqp-routing-key
      下表介绍了必须输入的参数值。
      参数 描述
      --sa-user 将成为 App-Launchpad-Service 帐户的 VMware Cloud Director 用户帐户的用户名。稍后,在 App Launchpad 服务的初始配置期间,App Launchpad 会为其分配 App-Launchpad-Service 角色。

      此帐户专用于 App Launchpad,不能与 --admin-user 帐户相同。

      输入只使用小写字母的用户名,不要添加 VMware Cloud Director 组织后缀。

      如果您输入的用户名的用户帐户在 VMware Cloud Director 中不存在,则 alp connect 脚本会创建该用户帐户。

      --sa-password 将成为 App-Launchpad-Service 帐户的 VMware Cloud Director 用户帐户的密码。
      --url VMware Cloud Director 的公共端点。

      请确保未在 URL 末尾输入斜杠。例如,输入 https://cloud.example.com,而不是 https://cloud.example.com/

      --admin-user VMware Cloud Director 系统管理员的用户名。
      --admin-pass VMware Cloud Director 系统管理员用户帐户的密码。
      --amqp-user App Launchpad 创建的专用 AMQP 代理用户帐户的用户名。将 @system 组织后缀添加到用户名中。
      --amqp-pass App Launchpad 创建的专用 AMQP 代理用户帐户的密码。
      --amqp-exchange App Launchpad 预留的专用 AMQP 代理直连交换机的名称。请确保:
      • 使用直连类型的 AMQP 交换机。
      • VMware Cloud DirectorApp Launchpad 使用 AMQP 代理的同一虚拟主机。
      --amqp-queue 如果 VMware Cloud Director 的多个实例使用单个 RabbitMQ 虚拟主机,为了防止 App Launchpad 服务出现故障,请为当前的 App Launchpad 实例指定专用 AMQP 队列。要确保请求路由到正确的队列,请将此参数与 --amqp-routingkey 参数一起使用。

      默认情况下,该参数值为 alp,因此,如果您不需要特定的请求路由,则可以跳过此参数。

      --amqp-routingkey 请求的路由密钥。要确保正确路由请求,请将此参数与 --amqp-queue 参数一起使用。

      默认情况下,该参数值为 alpkey,因此,如果您不需要特定的请求路由,则可以跳过此参数。

      --mqtt 如果为 App Launchpad 配置 VMware Cloud Director 10.2 或更高版本,您可以使用 MQTT 协议在 App LaunchpadVMware Cloud Director 之间进行通信。

      使用 MQTT 协议时,将会从 VMware Cloud Director 自动提取 App Launchpad 所需的所有配置详细信息。

      运行 alp connect 脚本时,如果同时提供 --mqtt--amqp-exchange 参数,则优先使用 MQTT 配置。如果 VMware Cloud Director 配置为使用 MQTT,App Launchpad 将忽略 AMQP 配置。

      对于 VMware Cloud Director 10.2 及更高版本:
      alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --mqtt
      对于版本低于 10.2 的 VMware Cloud Director
      alp connect --sa-user alpadmin --sa-pass 'Change!7' --url https://cloud.example.com --admin-user administrator@system --admin-pass 'Change!7' --amqp-exchange alpext --amqp-user alp-user --amqp-pass 'Change!7'
      要获取有关脚本的帮助,可运行 alp connect -h 命令。
      系统将返回有关 VMware Cloud Director 证书和 App Launchpad 最终用户许可协议 (End User License Agreement, EULA) 的信息。
    2. 接受 EULA。
    3. 接受 VMware Cloud Director 证书。
  4. 通过运行 alp show 命令,验证 VMware Cloud Director 和 AMQP 代理的配置是否成功。
    系统将返回所有 VMware Cloud Director 和 AMQP 代理配置详细信息。
  5. (可选) 要检索服务帐户的密码,请将 --show-password 参数附加到 alp show 命令。
  6. 通过运行 systemctl start alp 命令,启动 App Launchpad 服务。
  7. 通过运行 systemctl status alp 命令,验证 App Launchpad 服务的状态。
    如果系统未返回错误,请继续配置 App Launchpad。请参见 配置 App Launchpad。如果系统返回错误,请继续执行 步骤 8
  8. 通过运行 /opt/vmware/alp/bin/diagnose 可执行文件,诊断部署错误。
    诊断工具将验证服务是否已启动且正在运行,以及是否满足所有配置要求。诊断列表包括:
    • App Launchpad 服务的初始化
    • App-Launchpad-Service 帐户的分配
    • AMQP 或 MQTT 代理配置
    • App Launchpad API 端点配置
    • App Launchpad 服务侦听端口
    如果没有部署错误,系统将返回以下消息:
    Step 1: System diagnose
    --------------------------------------------------------------------------------
    - App Launchpad service is initialized.
    
    Step 2: Cloud Director diagnose
    --------------------------------------------------------------------------------
    - Service Account for App Launchpad is good.
    - App Launchpad's extension is ready.
    
    Step 3: AMQP diagnose
    --------------------------------------------------------------------------------
    - Cloud Director AMQP for extensibility is ready.
    
    Step 4: Integration diagnose
    --------------------------------------------------------------------------------
    - App Launchpad API is up, and version is 1.0.0-34386167.
    
    Step 5: App Launchpad diagnose
    --------------------------------------------------------------------------------
    - App Launchpad service is listening on port 8086