Implantar o App Launchpad

O App Launchpad é distribuído como arquivos de instalação RPM e DEB, acomodando diferentes tipos de SO.

O nome e o formato do arquivo de instalação diferem para os vários tipos de SO. Todos os nomes de arquivos incluem v.v.v, que é a versão do produto, e nnnnnnnn, que é o número da compilação. Por exemplo, vmware-vcd-alp-2.1.1-36472856.x86_64.rpm


SO	Nome e formato do arquivo de instalação
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

Pré-requisitos

Verifique se o seu ambiente de destino atende aos requisitos de implantação do App Launchpad. Para obter mais informações, consulte Antes de começar.
Verifique se você tem as credenciais de uma conta de administrador do sistema do VMware Cloud Director. Você precisa das credenciais de um administrador de sistema para criar a conta App-Launchpad-Service.
Verifique se o pacote da instalação foi carregado no diretório /tmp da máquina de destino.

Procedimento

Abra uma conexão SSH com a máquina virtual de destino Linux da instalação, faça login e use su para obter privilégios de raiz.
Instale o pacote RPM ou DEB executando o comando de instalação.
Para RPM:
```
rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
```
Se o Java SE JDK 11 estiver instalado na máquina de destino de implantação, para evitar problemas de instalação, acrescente o argumento --nodeps.
```
rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm
```
Para DEB:
```
sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb
```

Configure o App Launchpad com o VMware Cloud Director.

Para configurar o App Launchpad com o VMware Cloud Director, use o script alp connect. Usando esse script, você estabelece a conexão entre o App Launchpad e o VMware Cloud Director, define ou cria a conta App-Launchpad-Service e instala o plug-in de interface do usuário do App Launchpad para o VMware Cloud Director. O script alp connect também configura o App Launchpad com o seu agente AMQP.

Configure a conexão entre o App Launchpad e o VMware Cloud Director.

Se você estiver se conectando ao VMware Cloud Director 10.2 ou posterior, execute o seguinte comando:

Para CentOS Linux, Red Hat Enterprise Linux e 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

Para Ubuntu e 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

Se você estiver se conectando a uma versão do VMware Cloud Director anterior à 10.2, execute o seguinte comando:

Para CentOS Linux, Red Hat Enterprise Linux e 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

Para Ubuntu e 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

A tabela a seguir descreve os valores de argumento que você deve digitar.


Argumento	Descrição
--sa-user	O nome de usuário da conta de usuário do VMware Cloud Director que se torna a conta App-Launchpad-Service. Mais tarde, durante a configuração inicial dos serviços do App Launchpad, o App Launchpad atribui a função App-Launchpad-Service a ele. Essa conta é dedicada ao App Launchpad e não pode ser a mesma conta de --admin-user. Digite o nome de usuário usando apenas letras minúsculas e não adicione o sufixo de organização do VMware Cloud Director. Se uma conta de usuário para o nome de usuário que você digitou não existir no VMware Cloud Director, o script alp connect a criará.
--sa-password	A senha da conta de usuário do VMware Cloud Director que se torna a conta App-Launchpad-Service.
--url	O endpoint público do VMware Cloud Director. Certifique-se de não inserir uma barra à direita no final da URL. Por exemplo, insira https://cloud.example.comvez de https://cloud.example.com/.
--admin-user	O nome de usuário de um administrador de sistema do VMware Cloud Director.
--admin-pass	A senha da conta de usuário do administrador de sistema do VMware Cloud Director.
--amqp-user	O nome de usuário da conta de usuário dedicada do Agente AMQP que você criou para o App Launchpad. Adicione o sufixo de organização `@system` ao nome de usuário.
--amqp-pass	A senha da conta de usuário dedicada do Agente AMQP que você criou para o App Launchpad.
--amqp-exchange	O nome da troca direta dedicada do agente AMQP que é reservada para o App Launchpad. Certifique-se de que: Você usa um tipo direto de troca AMQP. O VMware Cloud Director e o App Launchpad usam o mesmo host virtual do agente AMQP.
--amqp-queue	Se várias instâncias do VMware Cloud Director usarem um único host virtual RabbitMQ, para evitar falhas de serviços do App Launchpad, especifique a fila AMQP dedicada para a instância atual do App Launchpad. Para garantir que as solicitações sejam roteadas para a fila correta, use esse argumento junto com o argumento --amqp-routingkey. Por padrão, o valor do argumento é alp. Portanto, se não precisar de roteamento específico de solicitações, você poderá ignorar esse argumento.
--amqp-routingkey	A chave de roteamento de suas solicitações. Para garantir que as solicitações sejam roteadas corretamente, use esse argumento junto com o argumento --amqp-queue. Por padrão, o valor do argumento é alpkey. Portanto, se não precisar de roteamento específico de solicitações, você poderá ignorar esse argumento.
--mqtt	Se você configurar o App Launchpad com o VMware Cloud Director 10.2 ou posterior, poderá usar o protocolo MQTT para a comunicação entre o App Launchpad e o VMware Cloud Director. Quando você usa o protocolo MQTT, todos os detalhes de configuração que o App Launchpad exige são automaticamente extraídos do VMware Cloud Director. Ao executar o script alp connect, se você fornecer os argumentos --mqtt e --amqp-exchange, a configuração do MQTT terá precedência. Se o VMware Cloud Director estiver configurado para usar o MQTT, o App Launchpad ignorará a configuração do AMQP.

Para o VMware Cloud Director 10.2 e versões posteriores:

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

Para o VMware Cloud Director anterior à versão 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'

Para obter ajuda sobre o script, você pode executar o comando alp connect -h ou sudo alp connect -h.

O sistema retorna informações sobre o certificado do VMware Cloud Director e o Contrato de Licença de Usuário Final (EULA) do App Launchpad.

Aceite o EULA.
Aceite o certificado do VMware Cloud Director.

Verifique se as configurações do VMware Cloud Director e do agente AMQP são bem-sucedidas executando o comando alp show.
O sistema retorna todos os detalhes de configuração do VMware Cloud Director e do agente AMQP.
(Opcional) Para recuperar a senha para a conta de serviço, acrescente o argumento --show-password ao comando alp show.
Inicie o serviço do App Launchpad executando o comando systemctl start alp.
Verifique o status do serviço do App Launchpad executando o comando systemctl status alp.
Se o sistema não retornar erros, vá para a configuração do App Launchpad. Consulte Configurar o App Launchpad. Se o sistema retornar um erro, vá para a Etapa 8.

Diagnostique os erros de implantação executando o arquivo executável /opt/vmware/alp/bin/diagnose.

A ferramenta de diagnóstico verifica se os serviços estão em execução e se todos os requisitos de configuração foram atendidos. A lista de diagnósticos inclui:

Inicialização do serviço App Launchpad
Atribuição da conta App-Launchpad-Service
Configuração do agente AMQP ou MQTT
Configuração de endpoint de interface de programação de aplicativos do App Launchpad
Porta de escuta do serviço App Launchpad
Testar a conexão do VMware Marketplace do servidor do App Launchpad
Testar a conexão com o Amazon S3 de células do VMware Cloud Director

Se não houver erros de implantação, o sistema retornará a seguinte mensagem:

[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.