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