Vous pouvez utiliser WebSphere Developer Tools pour créer une référence à un serveur Liberty s'exécutant dans un conteneur Docker sur un hôte distant. Vous pouvez utiliser cette référence pour gérer les demandes de votre serveur à partir du plan de travail.
Pourquoi et quand exécuter cette tâche
Vous pouvez installer WebSphere Application Server Liberty et télécharger des modules complémentaires dans le référentiel Liberty à partir
du site de téléchargement de la communauté WASdev. Après avoir installé Liberty, vous pouvez sélectionner votre conteneur Docker. Vous
pouvez ensuite entrer les droits d'accès de sécurité du serveur Liberty pour accéder à votre serveur Liberty distant dans votre conteneur Docker. Si vous n'avez pas de droit d'accès de sécurité
aux serveurs Liberty, les outils peuvent les créer à votre place.
Si une commande Docker expire lorsque vous effectuez ces étapes, vous pouvez contourner ce problème. Définissez la propriété système
com.ibm.ws.st.DockerCommandTimeoutInSeconds sur une durée spécifique, en secondes. Par défaut, la propriété est définie sur 10.
Important : Vous ne pouvez pas sélectionner Nettoyer le serveur au prochain démarrage pour les serveurs Liberty qui s'exécutent dans un conteneur Docker.
- Depuis le plan de travail, ouvrez la vue Serveurs en cliquant sur l'onglet Serveurs.
Conseil : Si la vue Serveurs n'est pas visible, sélectionnez et entrez Serveur dans le texte de filtre. Sélectionnez ensuite Serveurs.
- Cliquez avec le bouton droit de la souris dans
la vue Serveurs
et sélectionnez
.
- Pour sélectionner votre type de serveur, choisissez .
- Entrez le nom de l'hôte distant dans la zone Nom d'hôte du serveur.
- Cliquez
sur Suivant.
Remarque : Vérifiez que l'environnement d'exécution Liberty possède les fonctions que l'image Docker Liberty sélectionnée. Vérifiez également qu'elle sont configurées pour utiliser le même niveau
d'environnement d'exécution Java (JRE). L'environnement d'exécution cible de l'environnement d'exécution Liberty est utilisé dans l'environnement de
développement. Une non-concordance entre l'environnement d'exécution du système local et le JRE utilisé dans l'image Docker Liberty causer des problèmes allant des erreurs de configuration aux
problèmes de publication des applications.
- Si les outils vous invitent à installer WebSphere Application Server Liberty, soit parce que ce produit n'a pas encore été installé, soit parce
que vous devez spécifier le répertoire dans lequel il a été installé, procédez de l'une des façons décrites ci-après. Sinon, ignorez cette étape.
Liberty doit être installé pour pouvoir créer une référence de plan de travail sur un serveur Liberty contenu dans un conteneur Docker sur un hôte distant.
Si vous avez déjà installé Liberty, procédez comme suit pour sélectionner le répertoire dans lequel vous l'avez installé :
- Sélectionnez Choisir une installation
existante.
- Dans la zone Chemin d'accès, tapez le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous avez installé
WebSphere Application Server Liberty.
- Dans la page de l'environnement d'exécution
Liberty, cliquez sur Suivant.
L'environnement de traitement d'application est sélectionné. Ignorez le reste de cette étape.
Si vous voulez installer Liberty depuis un fichier
archive téléchargé précédemment, procédez comme suit :
- Sélectionnez Installer depuis une archive ou un
référentiel, puis cliquez sur
Suivant.
- Dans la zone Destination, tapez
le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous voulez
installer l'environnement d'exécution Liberty.
Si vous entrez un chemin d'accès qui n'existe pas, un dossier pour ce chemin est créé automatiquement à la fin de la procédure lorsque vous cliquez sur Terminer.
- Sélectionnez Installer un nouvel environnement
d'exécution depuis une archive.
- Dans la zone Chemin, tapez le répertoire
(ou naviguez jusqu'au répertoire) dans lequel se trouve le fichier
archive sur le système de fichiers local, puis cliquez sur
Suivant.
- Dans la page d'installation des modules
complémentaires, cliquez sur
Installer ou Installer les éléments
en attente afin d'effectuer votre sélection
de fichiers archive de module complémentaire que vous voulez
installer dans l'environnement d'exécution Liberty.
Vous pouvez installer un fichier archive de module complémentaire depuis votre système de
fichiers local et/ou télécharger un fichier d'archive de module complémentaire lorsque vous installez plusieurs fichiers archive de module complémentaire. Si le plan de travail est connecté
à Internet, la page d'installation des modules complémentaires est renseignée avec des fichiers archive
supplémentaires disponibles au téléchargement à partir du site de
téléchargement de la communauté WASdev.
Ce site de téléchargement inclut des modules complémentaires que
vous pouvez sélectionner depuis le référentiel Liberty, comme des
fonctions d'exécution, des exemples ou une intégration open
source.
Si vous souhaitez installer des fichiers archive de module
complémentaire à partir de votre système de fichiers local, procédez comme suit :
- Cliquez sur Ajouter archive.
- Dans la zone Archive de module, tapez le nom du ou
naviguez jusqu'au fichier archive supplémentaire sur le système de fichiers local.
- Cliquez sur OK.
Si vous voulez installer d'autres fichiers archive de module complémentaire depuis votre système de fichiers local, répétez cette procédure autant de fois que nécessaire.
Si vous souhaitez installer des fichiers archive de module complémentaire à partir d'un référentiel personnalisé, procédez comme suit :
- Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
- Cliquez sur Nouveau....
Les fichiers sont ensuite ajoutés à la liste des fichiers
de module complémentaire.
Une fois que vous avez effectué votre sélection
dans la page d'installation des modules complémentaires, cliquez
sur Suivant.
- Sur la page Acceptation de la licence, sélectionnez J'accepte les dispositions de tous les contrats de licence si vous acceptez les termes de la
licence, puis cliquez sur Suivant.
Si vous voulez télécharger et installer l'édition gratuite de Liberty conçue pour les développeurs, procédez comme suit :
- Sélectionnez Installer depuis une archive ou un
référentiel, puis cliquez sur
Suivant.
- Dans la zone Destination, tapez
le répertoire (ou naviguez jusqu'au répertoire) dans lequel vous voulez
installer l'environnement d'exécution Liberty.
Si vous entrez un chemin d'accès qui n'existe pas, un dossier pour ce chemin est créé automatiquement à la fin de la procédure principale lorsque vous cliquez sur Terminer.
- Sélectionnez Télécharger et installer un nouvel
environnement d'exécution depuis ibm.com, choisissez une
version d'environnement d'exécution, puis cliquez sur
Suivant.
- Dans la page d'installation des modules
complémentaires, cliquez sur
Installer ou Installer les éléments
en attente afin d'effectuer votre sélection
de fichiers archive de module complémentaire que vous voulez
installer dans l'environnement d'exécution Liberty.
Vous pouvez installer les fichiers d'archive de module à l'aide de l'une des méthodes suivantes :
- A partir de votre système de fichiers local
- En téléchargeant les fichiers
- En utilisant une combinaison des deux si vous installez plusieurs fichiers d'archive de module
Si le plan de travail est connecté
à Internet, la page d'
installation des modules complémentaires est renseignée avec des fichiers archive
supplémentaires disponibles au téléchargement à partir du site de
téléchargement de la communauté WASdev.
Ce site de téléchargement inclut des modules complémentaires que
vous pouvez sélectionner depuis le référentiel Liberty, comme des
fonctions d'exécution, des exemples ou une intégration open
source.
Si vous souhaitez installer des fichiers archive de module
complémentaire à partir de votre système de fichiers local, procédez comme suit :
- Cliquez sur Ajouter archive.
- Dans la zone Archive de module, tapez le nom du ou
naviguez jusqu'au fichier archive supplémentaire sur le système de fichiers local.
- Cliquez sur OK.
Si vous voulez installer d'autres fichiers archive de module complémentaire depuis votre système de fichiers local, répétez cette procédure autant de fois que nécessaire.
Si vous souhaitez installer des fichiers archive de module complémentaire à partir d'un référentiel personnalisé, procédez comme suit :
- Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
- Cliquez sur Nouveau....
Les fichiers sont ensuite ajoutés à la liste des fichiers
de module complémentaire.
Une fois que vous avez effectué votre sélection
dans la page d'installation des modules complémentaires, cliquez
sur Suivant.
- Dans la page d'acceptation de la licence, si vous acceptez les dispositions du contrat de licence, sélectionnez l'option indiquant que vous acceptez
les dispositions de tous les contrats de licence, puis cliquez sur Suivant.
- Sur la page Paramètres du serveur distant, sélectionnez Serveur dans un conteneur Docker.
- Sélectionnez le système d'exploitation de votre serveur distant
Restriction : Les outils ne prennent pas en charge l'authentification du système d'exploitation pour les systèmes d'exploitation Windows.
- Sélectionnez une méthode d'accès à l'hôte distant, entrez les informations de connexion et cliquez sur Suivant.
- Sur la page Nouveau serveur dans un conteneur Docker, sélectionnez votre conteneur Docker dans le menu Nom du conteneur.
Conseil : Si vous ne voyez pas votre conteneur Docker dans le menu Nom du conteneur, cliquez sur Actualiser pour actualiser la liste.
- Entrez les données d'identification de sécurité de serveur Liberty.
Vos valeurs pour les zones
Nom d'utilisateur et
Mot de passe doivent correspondre à un utilisateur qui est défini dans un registre d'utilisateurs doté d'un rôle d'administrateur. Si les outils ne trouvent aucun registre d'utilisateurs basique dans lequel l'utilisateur spécifié est défini, ils affichent la fenêtre de
vérification de sécurité. Si les outils affichent la fenêtre de
vérification de sécurité, procédez de l'une des façons suivantes :
- Sélectionnez Créer pour ajouter un registre d'utilisateurs basique qui définit un utilisateur avec vos valeurs et un rôle d'administrateur.
- Sélectionnez Poursuivre pour continuer si l'utilisateur est défini dans un autre type de registre d'utilisateurs.
- Sélectionnez Annuler pour apporter des modifications aux zones Nom d'utilisateur et Mot de passe que vous avez saisies.
- Entrez la valeur de la zone Port sécurisé avec le port HTTPS spécifié dans la configuration du serveur.
Conseil : Le numéro de port HTTPS par défaut est 9443.
- Cliquez sur Terminer.
Que faire ensuite
Restriction : Pour les serveurs distants du Docker Liberty, les outils ne prennent pas en charge les utilitaires des serveurs.
- Vous pouvez éditer la configuration du serveur. Pour plus d'informations, voir Edition de la configuration Liberty à l'aide des outils de développement.
Restriction : Dans le cas de serveurs distants, les outils ne permettent pas de spécifier des fichiers d'inclusion en utilisant des chemins d'accès absolus dans la
configuration du
serveur. Pour contourner ce problème, vous pouvez spécifier des chemins d'inclusion en utilisant les variables serveur prédéfinies telles que
server.config.dir et shared.config.dir au lieu de chemins absolus.
- Pour démarrer ou arrêter un serveur, ou pour ajouter ou supprimer des applications sur un serveur, cliquez sur votre serveur avec le bouton droit de la souris pour utiliser le menu
contextuel du serveur ou utilisez les boutons de la barre d'état dans la vue Serveurs. Pour plus d'informations, voir Démarrage et arrêt d'un serveur avec les outils de développement.
Conseil : Pour
accéder à ces options, sélectionnez votre serveur Liberty dans la vue Serveurs. Si vous sélectionnez d'autres entrées dans la vue Serveurs, le menu
contextuel du serveur n'est pas disponible.
Vous pouvez créer et éditer les fichiers d'environnement de votre serveur. Pour plus d'informations, voir Création et édition de vos fichiers d'environnement de serveur
dans la documentation du produit.