Déployer App Launchpad

App Launchpad est distribué sous forme de fichiers d'installation RPM et DEB, prenant ainsi en charge différents types de SE.

Le nom et le format du fichier d'installation diffèrent pour les différents types de SE. Tous les noms de fichiers incluent v.v.v, qui est la version du produit et nnnnnnnn, qui est le numéro de build. Par exemple, vmware-vcd-alp-2.1.1-36472856.x86_64.rpm

Système d'exploitation	Nom et format du fichier d'installation
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

Conditions préalables

• Vérifiez que votre environnement cible répond aux exigences de déploiement d'App Launchpad. Pour plus d'informations, reportez-vous à la section Avant de commencer.
• Vérifiez que vous disposez des informations d'identification d'un compte d'administrateur système VMware Cloud Director. Vous avez besoin des informations d'identification d'un administrateur système pour créer le compte App Launchpad - Service.
• Assurez-vous que le module d'installation est chargé dans le répertoire /tmp de la machine cible.

Procédure

1. Ouvrez une connexion SSH avec la machine virtuelle Linux cible d'installation, connectez-vous et utilisez su pour obtenir les privilèges racine.
2. Installez le module RPM ou DEB en exécutant la commande d'installation.

   Pour RPM :

   rpm -ivh  vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm

   Si Java SE JDK 11 est installé sur la machine cible de déploiement, pour éviter tout problème d'installation, ajoutez l'argument --nodeps.

   rpm -ivh --nodeps vmware-vcd-alp-v.v.v-nnnnnnnn.el7.x86_64.rpm

   Pour DEB :

   sudo apt-get install ./vmware-alp_$v.v.v-$nnnnnnnn_amd64.deb

3. Configurez App Launchpad avec VMware Cloud Director.
   Pour configurer App Launchpad avec VMware Cloud Director, utilisez le script alp connect. Ce script vous permet d'établir une connexion entre App Launchpad et VMware Cloud Director, de définir ou de créer le compte de service App Launchpad - Service et d'installer le plug-in de l'interface utilisateur d' App Launchpad pour VMware Cloud Director. Le script alp connect configure également App Launchpad avec votre broker AMQP.
   1. Configurez la connexion entre App Launchpad et VMware Cloud Director.
      Si vous vous connectez à VMware Cloud Director 10.2 ou version ultérieure, exécutez la commande suivante :

      Pour CentOS Linux, Red Hat Enterprise Linux et 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

      Pour Ubuntu et 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

      Si vous vous connectez à une version de VMware Cloud Director antérieure à 10.2, exécutez la commande suivante :

      Pour CentOS Linux, Red Hat Enterprise Linux et 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

      Pour Ubuntu et 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

      Le tableau suivant décrit les valeurs d'arguments que vous devez entrer.

      Argument	Description
      --sa-user	Nom d'utilisateur du compte d'utilisateur VMware Cloud Director qui devient le compte App Launchpad - Service. Ensuite, lors de la configuration initiale des services App Launchpad, App Launchpad lui attribue le rôle App Launchpad - Service. Ce compte est dédié à App Launchpad et doit être différent du compte --admin-user. Entrez le nom d'utilisateur en utilisant uniquement des minuscules et n'ajoutez pas le suffixe d'organisation de VMware Cloud Director. S'il n'existe aucun compte d'utilisateur pour le nom d'utilisateur que vous entrez dans VMware Cloud Director, le script alp connect le crée.
      --sa-password	Mot de passe du compte d'utilisateur VMware Cloud Director qui devient le compte App Launchpad - Service.
      --url	Point de terminaison public de VMware Cloud Director. Veillez à ne pas entrer de barre oblique à la fin de l'URL. Par exemple, entrez https://cloud.example.com plutôt que https://cloud.example.com/.
      --admin-user	Nom d'utilisateur d'un administrateur système VMware Cloud Director.
      --admin-pass	Mot de passe du compte d'utilisateur de l'administrateur système VMware Cloud Director.
      --amqp-user	Nom d'utilisateur du compte d'utilisateur du broker AMQP dédié que vous avez créé pour App Launchpad. Ajoutez le suffixe d'organisation @system au nom d'utilisateur.
      --amqp-pass	Mot de passe du compte d'utilisateur du broker AMQP dédié que vous avez créé pour App Launchpad.
      --amqp-exchange	Nom de l'échange direct du broker AMQP dédié qui est réservé à App Launchpad. Assurez-vous que : vous utilisez un type direct d'échange AMQP. VMware Cloud Director et App Launchpad utilisent le même hôte virtuel du broker AMQP.
      --amqp-queue	Si plusieurs instances de VMware Cloud Director utilisent un seul hôte virtuel RabbitMQ, afin d'éviter les pannes des services App Launchpad, spécifiez la file d'attente AMQP dédiée pour l'instance actuelle d'App Launchpad. Pour vous assurer que les demandes sont acheminées vers la file d'attente appropriée, utilisez cet argument avec l'argument --amqp-routingkey. Par défaut, la valeur de l'argument est alp. Par conséquent, si aucun routage spécifique des demandes n‘est requis, vous pouvez ignorer cet argument.
      --amqp-routingkey	La clé de routage pour vos demandes. Pour vous assurer que les demandes sont acheminées correctement, utilisez cet argument avec l'argument --amqp-queue. Par défaut, la valeur de l'argument est alpkey. Par conséquent, si aucun routage spécifique des demandes n‘est requis, vous pouvez ignorer cet argument.
      --mqtt	Si vous configurez App Launchpad avec VMware Cloud Director 10.2 ou version ultérieure, vous pouvez utiliser le protocole MQTT pour la communication entre App Launchpad et VMware Cloud Director. Lorsque vous utilisez le protocole MQTT, tous les détails de configuration requis par App Launchpad sont automatiquement extraits de VMware Cloud Director. Lors de l'exécution du script alp connect, si vous fournissez les arguments --mqtt et --amqp-exchange, la configuration MQTT est prioritaire. Si VMware Cloud Director est configuré pour utiliser MQTT, App Launchpad ignore la configuration AMQP.

      Pour VMware Cloud Director 10.2 et versions ultérieures :

      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

      Pour les versions de VMware Cloud Director antérieures à 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'

      Pour obtenir de l'aide sur le script, exécutez la commande alp connect -h ou sudo alp connect -h.
      Le système renvoie des informations sur le certificat VMware Cloud Director et le contrat de licence d'utilisateur final (CLUF) d' App Launchpad.
   2. Acceptez le contrat de licence d'utilisateur final.
   3. Acceptez le certificat VMware Cloud Director.
4. Vérifiez que les configurations de VMware Cloud Director et du broker AMQP sont appliquées en exécutant la commande alp show.
   Le système renvoie tous les détails de configuration de VMware Cloud Director et du broker AMQP.
5. (Facultatif) Pour récupérer le mot de passe du compte de service, ajoutez l'argument --show-password à la commande alp show.
6. Démarrez le service App Launchpad en exécutant la commande systemctl start alp.
7. Vérifier l'état du service App Launchpad en exécutant la commande systemctl status alp.
   Si le système ne renvoie pas d'erreurs, poursuivez la configuration d' App Launchpad. Reportez-vous à Configurer App Launchpad. Si le système renvoie une erreur, passez à l' Étape 8.
8. Diagnostiquez les erreurs de déploiement en exécutant le fichier exécutable /opt/vmware/alp/bin/diagnose.
   L'outil de diagnostic vérifie que les services sont en cours d'exécution et que toutes les conditions de configuration sont respectées. La liste de diagnostics comporte les éléments suivants :

   • Initialisation du service App Launchpad
   • Attribution du compte App Launchpad - Service
   • Configuration du broker AMQP ou MQTT
   • Configuration du point de terminaison d'API App Launchpad
   • Port d'écoute du service App Launchpad
   • Test de connexion de VMware Marketplace à partir du serveur App Launchpad
   • Test de connexion Amazon S3 à partir de cellules VMware Cloud Director
   S'il n'y a pas d'erreur de déploiement, le système renvoie le message suivant :

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