App Launchpad のデプロイ

App Launchpad は RPM および DEB インストールファイルとして配布され、異なる OS タイプに対応しています。

インストールファイルの名前と形式は、OS タイプによって異なります。すべてのファイル名には、製品バージョンである v.v.v と、ビルド番号である nnnnnnnn が含まれます。例： vmware-vcd-alp-2.1.1-36472856.x86_64.rpm


OS	インストールファイルの名前と形式
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
```

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 ブローカを使用して 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	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	VMware Cloud Director 10.2 以降で App Launchpad を構成する場合、App Launchpad と VMware Cloud Director 間の通信に MQTT プロトコルを使用できます。 MQTT プロトコルを使用すると、App Launchpad が必要とするすべての構成情報が VMware Cloud Director から自動的に抽出されます。 alp connect スクリプトを実行するときに、--mqtt と --amqp-exchange の両方の引数を指定すると、MQTT の設定が優先されます。MQTT を使用するように VMware Cloud Director が設定されている場合、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

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' --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 コマンドを実行できます。

システムは、 App Launchpad の VMware Cloud Director 証明書とエンドユーザー使用許諾契約書 (EULA) に関する情報を返します。

EULA に同意します。
VMware Cloud Director の証明書に同意します。

alp show コマンドを実行して、VMware Cloud Director と AMQP ブローカの構成が成功したことを確認します。
システムは、すべての VMware Cloud Director および AMQP ブローカ構成の詳細を返します。
（オプション） サービスアカウントのパスワードを取得するには、alp show コマンドに --show-password 引数を追加します。
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.