部署 App Launchpad

App Launchpad 将以 RPM 和 DEB 安装文件的形式分发，以适应不同的操作系统类型。

安装文件的名称和格式因操作系统类型不同而异。所有文件名都包括产品版本 v.v.v 和内部版本号 nnnnnnnn。例如， vmware-vcd-alp-2.1.1-36472856.x86_64.rpm


操作系统	安装文件名称和格式
CentOS Linux、Red Hat Enterprise Linux	vmware-vcd-alp-`v.v.v`-`nnnnnnnn`.x86_64.rpm
Photon OS	vmware-vcd-alp-`v.v.v`-`nnnnnnnn`.ph3.x86_64.rpm
Ubuntu、Debian	vmware-vcd-alp-`v.v.v`-`nnnnnnnn`_amd64.deb

前提条件

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

过程

打开与安装目标 Linux 虚拟机的 SSH 连接，登录并使用 su 获取 root 用户特权。
通过运行安装命令安装 RPM 或 DEB 软件包。
对于 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
```
对于 DEB：
```
sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb
```

为 App Launchpad 配置 VMware Cloud Director。

要为 App Launchpad 配置 VMware Cloud Director，请使用 alp connect 脚本。通过使用此脚本，您可以在 App Launchpad 和 VMware Cloud Director 之间建立连接，定义或创建 App-Launchpad-Service 帐户，并安装适用于 VMware Cloud Director 的 App Launchpad 用户界面插件。 alp connect 脚本还可为 App Launchpad 配置 AMQP 代理。

配置 App Launchpad 和 VMware Cloud Director 之间的连接。

如果要连接到 VMware Cloud Director 10.2 或更高版本，请运行以下命令：

对于 CentOS Linux、Red Hat Enterprise Linux 和 Photon OS：

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

对于 Ubuntu 和 Debian：

sudo 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，请运行以下命令：

对于 CentOS Linux、Red Hat Enterprise Linux 和 Photon OS：

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

对于 Ubuntu 和 Debian：

sudo 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 Director 和 App 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 Launchpad 与 VMware 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

sudo 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'

sudo 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 或 sudo alp connect -h 命令。

系统将返回有关 VMware Cloud Director 证书和 App Launchpad 最终用户许可协议 (End User License Agreement, EULA) 的信息。

接受 EULA。
接受 VMware Cloud Director 证书。

通过运行 alp show 命令，验证 VMware Cloud Director 和 AMQP 代理的配置是否成功。
系统将返回所有 VMware Cloud Director 和 AMQP 代理配置详细信息。
（可选） 要检索服务帐户的密码，请将 --show-password 参数附加到 alp show 命令。
通过运行 systemctl start alp 命令，启动 App Launchpad 服务。
通过运行 systemctl status alp 命令，验证 App Launchpad 服务的状态。
如果系统未返回错误，请继续配置 App Launchpad。请参见配置 App Launchpad。如果系统返回错误，请继续执行步骤 8。

通过运行 /opt/vmware/alp/bin/diagnose 可执行文件，诊断部署错误。

诊断工具将验证服务是否已启动且正在运行，以及是否满足所有配置要求。诊断列表包括：

App Launchpad 服务的初始化
App-Launchpad-Service 帐户的分配
AMQP 或 MQTT 代理配置
App Launchpad API 端点配置
App Launchpad 服务侦听端口
测试从 App Launchpad 服务器到 VMware Marketplace 的连接
测试从 VMware Cloud Director 单元到 Amazon S3 的连接

如果没有部署错误，系统将返回以下消息：

[root@alp103 bin]# ./diagnose 
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: MQTT diagnose
--------------------------------------------------------------------------------
- Cloud Director MQTT for extensibility is ready.

Step 4: Integration diagnose
--------------------------------------------------------------------------------
- App Launchpad API is up, and version is 2.1.1-19199857.

Step 5: App Launchpad diagnose
--------------------------------------------------------------------------------
- App Launchpad service has started successfully and is listening on port 8086.

Step 6: App Launchpad to Marketplace connection diagnose
--------------------------------------------------------------------------------
- App Launchpad to Marketplace connection succeeds.

Step 7: Cloud Director to AWS S3 connection diagnose
-------------------------------------------------------------------------------- 
- Cloud Director to AWS S3 connection succeeds.