Installation du pack de construction IBM WebSphere Application Server Liberty dans un environnement Cloud Foundry

Le pack de construction WebSphere Application Server Liberty met à disposition le serveur Liberty dans Cloud Foundry.

Avant de commencer

  • Vous devez avoir installé la version 1.9.3 de Ruby ou une version ultérieure.
  • Ce document explique en détail comment télécharger le pack de construction WebSphere Application Server Liberty à l'aide de la ligne de commande Linux.

Pourquoi et quand exécuter cette tâche

Utilisez cette tâche pour installer le pack de construction de WebSphere Application Server Liberty dans un environnement Cloud Foundry. Si vous êtes un administrateur Cloud Foundry, vous pouvez installer le pack de construction Liberty en tant que pack de construction d'administration et le mettre ainsi à la disposition de tous les utilisateurs dan l'environnement Cloud Foundry.
Remarque : Les utilisateurs du pack de construction n'ont pas besoin de spécifier l'option -b pour l'utiliser directement à partir du pack de construction d'administration.

Le pack de construction WebSphere Application Server Liberty, accompagné d'une documentation supplémentaire, est également disponible à l'adresse https://github.com/cloudfoundry/ibm-websphere-liberty-buildpack.

Procédure

Installation du installer dans votre environnement Cloud Foundry

  1. Téléchargez le fichier compressé du pack de construction à partir d'IBM® Fix Central.
  2. Exécutez la commande unzip pour extraire le contenu du fichier ibm-websphere-liberty-buildpack-v*.zip du pack de construction dans le répertoire de pack de construction suivant : ibm-websphere-liberty-buildpack
  3. Le pack de construction WebSphere Application Server Liberty télécharge les fichiers binaires par défaut de Liberty et d'IBM JRE dans un but de développement uniquement. Si vous possédez des licences pour d'autres fichiers binaires que vous souhaitez utiliser, ces fichiers doivent être accessibles via HTTP. Pour plus d'informations sur la manière de structurer ce référentiel, voir Structuration d'un référentiel Liberty pour des fichiers binaires personnels.
    1. Mettez à jour le fichier config/ibmjdk.yml pour qu'il pointe vers votre fichier binaire JRE.
    2. Mettez à jour le fichier config/liberty.yml pour qu'il pointe vers votre fichier binaire Liberty.
  4. Si vous possédez la licence requise pour déployer le pack de construction dans votre environnement, vous pouvez créer un fichier config/licenses.yml contenant le nombre de licences acceptées avant de créer le package.
    IBM_JVM_LICENSE: <jvm license code>
    IBM_LIBERTY_LICENSE: <liberty license code>
    Remarque : Une fois que vous avez ajouté la licence au package du pack de construction, les applications individuelles n'ont pas besoin d'accepter les dispositions du contrat de licence avec des variables d'environnement.
  5. Exécutez les commandes gem install bundler et bundle install pour installer les gemmes Ruby nécessaires pour créer le package d'un pack de construction d'administration.
  6. Exécutez la tâche de package bundle exec rake pour créer un pack de construction d'administration.
    rake 'package[zipfile,hosts,version]'

    Le paramètre zipfile représente le nom du pack de construction d'administration généré. Il comprend un emplacement relatif qui NE correspond PAS au répertoire en cours. Par exemple, ../my-admin-buildpack.zip peut être spécifié comme paramètre zipfile afin de générer le fichier my-admin-buildpack.zip dans le répertoire parent à la place du fichier ibm-websphere-liberty-buildpack-480d2de.zip par défaut.

    Par exemple,
    rake 'package[../my-admin-buildpack.zip]'

    Le paramètre hosts est une liste de sites à partir desquels la tâche de package extrait des fichiers binaires pour les inclure dans le pack de construction d'administration. Par défaut, seuls les fichiers binaires provenant du site IBM public sont extraits. Les sites hébergés par IBM n'incluent pas de fichiers binaires tiers. Un paramètre de package doit être spécifié pour indiquer que des fichiers binaires tiers peuvent être inclus dans le pack de construction d'administration lorsque celui-ci est utilisé en mode hors ligne. L'utilisation de * permet d'inclure tous les fichiers binaires dans le pack de construction d'administration si le téléchargement est possible lors de création du package.

    Exemple de syntaxe :
    rake 'package[,*,]'

    Le paramètre version contient les informations de version qui sont affichées lorsqu'une application est déployée sur CloudFoundry à l'aide de l'interface de ligne de commande Cloud Foundry. Par défaut, la version affichée correspond à l'identificateur de validation le plus récent, par exemple, 480d2de.

    L'exemple suivant illustre les valeurs par défaut des informations de version affichées :
    Liberty Buildpack Version: 480d2de | git@github.com:cloudfoundry/ibm-websphere-liberty-buildpack.git#480d2de
  7. Installez le pack de construction d'administration avec le client cf comme suit :
    cf create-buildpack ibm-websphere-liberty-buildpack ibm-websphere-liberty-buildpack-480d2de.zip 1
    • ibm-websphere-liberty-buildpack est le nom qui est attribué au pack de construction d'administration.
    • ibm-websphere-liberty-buildpack-480d2de.zip est le chemin d'accès au fichier compressé qui est créé par la tâche Rake.
    • 1 est le niveau de priorité accordé au pack de construction d'administration. Plus le numéro est bas, plus la priorité est élevée.
    Pour plus d'informations, voir la documentation Cloud Foundry.

Résultats

Le pack de construction de WebSphere Application Server Liberty est maintenant installé.

Icône indiquant le type de rubrique Rubrique Tâche

Nom du fichier : twlp_libbp_ins.html