部署 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 取得根權限。
執行安裝命令以安裝 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
```

使用 VMware Cloud Director 設定 App Launchpad。

若要以 VMware Cloud Director 設定 App Launchpad，請使用 alp connect 指令碼。此指令碼可讓您建立 App Launchpad 與 VMware Cloud Director 之間的連線、定義或建立 App-Launchpad-Service 帳戶，以及安裝適用於 VMware Cloud Director 的 App Launchpad 使用者介面外掛程式。 alp connect 指令碼也會使用您的 AMQP Broker 來設定 App Launchpad。

設定 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	VMware Cloud Director 使用者帳戶的使用者名稱，該帳戶將成為 App-Launchpad-Service 帳戶。後續在 App Launchpad 服務的初始設定期間，App Launchpad 會指派 App-Launchpad-Service 角色給此帳戶。此帳戶專用於 App Launchpad，且不得與 --admin-user 帳戶相同。輸入僅使用小寫字母的使用者名稱，不要加上 VMware Cloud Director 組織尾碼。如果您輸入的使用者名稱的使用者帳戶不存在於 VMware Cloud Director 中，則 alp connect 指令碼會建立該使用者帳戶。
--sa-password	VMware Cloud Director 使用者帳戶的密碼，該帳戶將成為 App-Launchpad-Service 帳戶。
--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 Broker 使用者帳戶的使用者名稱。將 `@system` 組織尾碼新增至使用者名稱。
--amqp-pass	您為 App Launchpad 建立的專用 AMQP Broker 使用者帳戶的密碼。
--amqp-exchange	為 App Launchpad 保留的專用 AMQP Broker 直接交換的名稱。請確定：您使用的是直接類型的 AMQP 交換。 VMware Cloud Director 和 App Launchpad 使用相同的 AMQP Broker 虛擬主機。
--amqp-queue	如果有多個 VMware Cloud Director 執行個體使用單一的 RabbitMQ 虛擬主機，為了防止 App Launchpad 服務失敗，請為 App Launchpad 的目前執行個體指定專用的 AMQP 佇列。若要確定要求會路由傳送至正確的佇列，請將此引數與 --amqp-routingkey 引數搭配使用。依預設，引數值為 alp，因此如果您不需要讓要求的特定路由，則可以略過此引數。
--amqp-routingkey	要求的路由金鑰。若要確定系統會正確地路由傳送要求，請將此引數與 --amqp-queue 引數搭配使用。依預設，引數值為 alpkey，因此如果您不需要讓要求的特定路由，則可以略過此引數。
--mqtt	如果您使用 VMware Cloud Director 10.2 或更新版本來設定 App Launchpad，則可以使用 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 的使用者授權合約 (EULA)。

接受 EULA。
接受 VMware Cloud Director 的憑證。

執行 alp show 命令，以確認 VMware Cloud Director 和 AMQP Broker 設定成功。
系統會傳回 VMware Cloud Director 和 AMQP Broker 的所有組態詳細資料。
(選擇性) 若要擷取服務帳戶的密碼，請將 --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 Broker 組態
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.