La cartouche OpenShift téléchargeable permet de rendre le serveur Liberty disponible sur OpenShift.
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 la cartouche OpenShift à l'aide de la ligne de commande Linux.
Pourquoi et quand exécuter cette tâche
OpenShift est une plateforme open source qui permet aux développeurs de développer, créer, déployer et gérer rapidement des services et des applications conteneurisés par Linux dans un environnement de cloud. Lorsque vous installez la cartouche OpenShift pour Liberty, les fichiers binaires Liberty et JRE sont téléchargés pour chaque application.
La cartouche OpenShift, accompagnée d'une documentation supplémentaire, est également disponible à l'adresse https://github.com/WASdev/cloud.openshift.cartridge.wlp.
Pour plus d'informations sur OpenShift et les avantages qu'il procure, voir OpenShift.
Remarque : Seule la version 2 d'OpenShift peut être utilisée avec cette cartouche.
Procédure
Installation de la cartouche dans votre environnement OpenShift
- Téléchargez le fichier compressé de la cartouche à partir du site IBM® Fix Central.
- Exécutez la commande unzip pour extraire le contenu du fichier ibm-websphere-liberty-cartridge-v*.zip de la cartouche dans le répertoire de cartouche suivant : cloud.openshift.cartridge.wlp
- La cartouche OpenShift télécharge les fichiers binaires Liberty et IBM JRE par défaut uniquement à des fins de développement. 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.
- Mettez à jour le fichier ibm-websphere-liberty-buildpack/config/ibmjdk.yml pour qu'il pointe vers votre fichier binaire JRE.
- Mettez à jour le fichier ibm-websphere-liberty-buildpack/config/liberty.yml pour qu'il pointe vers votre fichier binaire Liberty.
- Exécutez la commande chmod u+x
ibm-websphere-liberty-buildpack/resources/download_buildpack_cache.rb et ajoutez les fichiers binaires de l'étape 3 au cache de la cartouche. Exécutez la commande ibm-websphere-liberty-buildpack/resources/download_buildpack_cache.rb ibm-websphere-liberty-buildpack/admin_cache
- Si vous possédez la licence requise pour déployer la cartouche dans votre environnement, vous pouvez créer un fichier ibm-websphere-liberty-buildpack/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 installée, la cartouche peut être mise à la disposition de tous les utilisateurs. Si vous êtes un administrateur ou que vous possédez votre installation OpenShift, vous pouvez contrôler davantage le comportement de la cartouche dans ces situations. Une fois que vous avez ajouté la licence au package de la cartouche, les applications individuelles n'ont pas besoin d'accepter les dispositions du contrat de licence avec des variables d'environnement.
- Revenez dans votre répertoire d'origine et copiez le répertoire de la cartouche sur chaque hôte de noeud sur vos machines OpenShift.
- Sur chaque hôte de noeud, exécutez :
oo-admin-cartridge --action install --source cloud.openshift.cartridge.wlp/
service ruby193-mcollective restart
- Sur l'hôte de courtier, exécutez :
oo-admin-broker-cache --clear --console
oo-admin-ctl-cartridge -c import-node --activate
oo-admin-console-cache --clear
- Assurez-vous que la cartouche est installée en exécutant la commande rhc cartridges.
Désinstallation de la cartouche de votre environnement OpenShift
- Sur l'hôte de courtier, exécutez :
oo-admin-ctl-cartridge -c deactivate --name ibm-liberty-8.5.5
- Sur chaque hôte de noeud, exécutez :
oo-admin-cartridge --action erase --name liberty --version 8.5.5 --cartridge_version <Cart_Version_Number>
- Sur l'hôte de courtier, exécutez :
oo-admin-broker-cache --clear --console
oo-admin-console-cache --clear
- Assurez-vous que la cartouche est désinstallée en exécutant la commande rhc cartridges.
Résultats
La cartouche OpenShift est à présent installée.