App Launchpad 將以 RPM 和 DEB 安裝檔形式散佈,以適應不同的作業系統類型。
作業系統 | 安裝檔案的名稱和格式 |
---|---|
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 的憑證。
- 設定 App Launchpad 與 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 服務的狀態。
- 執行 /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.