Création d'un serveur Liberty distant dans un conteneur Docker à l'aide de Developer Tools

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.

Avant de commencer

  • Installez WebSphere Developer Tools. Pour plus d'informations sur l'installation de WebSphere Developer Tools, voir Installation des outils de développement Liberty et (facultatif) de Liberty.
    Important : Les outils prennent en charge Docker version 1.10.2 et les versions ultérieures.
  • Démarrez un serveur distant dans un conteneur Docker et vérifiez que les ports HTTP et HTTPS sont mappés à l'hôte. Pour en savoir plus sur le démarrage d'un serveur Liberty distant dans un conteneur Docker, voir WASdev GitHub.

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.

Procédure

  1. 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 Fenêtre > Afficher la vue > Autre... et entrez Serveur dans le texte de filtre. Sélectionnez ensuite Serveurs.
  2. Cliquez avec le bouton droit de la souris dans la vue Serveurs et sélectionnez Nouveau > Serveur.
  3. Pour sélectionner votre type de serveur, choisissez IBM > WebSphere Application Server Liberty.
  4. Entrez le nom de l'hôte distant dans la zone Nom d'hôte du serveur.
  5. 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 peut causer des problèmes allant des erreurs de configuration aux problèmes de publication des applications.
  6. 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é :

    1. Sélectionnez Choisir une installation existante.
    2. 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.
    3. Dans la page de l'environnement d'exécution Liberty, cliquez sur Suivant.

      L'environnement de service d'applications 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 :

    1. Sélectionnez Installer depuis une archive ou un référentiel, puis cliquez sur Suivant.
    2. 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.

    3. Sélectionnez Installer un nouvel environnement d'exécution depuis une archive.
    4. 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.
    5. 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 :
      1. Cliquez sur Ajouter archive.
      2. 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.
      3. 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 :
      1. Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
      2. 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.

    6. 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 :

    1. Sélectionnez Installer depuis une archive ou un référentiel, puis cliquez sur Suivant.
    2. 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.

    3. 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.
    4. 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 :
      1. Cliquez sur Ajouter archive.
      2. 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.
      3. 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 :
      1. Pour ajouter le référentiel, cliquez sur Configurer des référentiels.
      2. 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.

    5. 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.
  7. Sur la page Paramètres du serveur distant, sélectionnez Serveur dans un conteneur Docker.
  8. 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.
  9. Sélectionnez une méthode d'accès à l'hôte distant, entrez les informations de connexion et cliquez sur Suivant.
  10. 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.
  11. 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.
  12. 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.
  13. Cliquez sur Terminer.

Résultats

Vous avez créé une référence à un serveur Liberty s'exécutant dans un conteneur Docker sur un hôte distant.

  • Pour voir le serveur que vous avez créé et la configuration correspondante, ouvrez la vue Serveurs.
  • Pour voir le projet, le dossier du serveur et les fichiers de configuration du serveur, ouvrez la vue Enterprise Explorer.

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 avec les 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.
  • [16.0.0.4 et ultérieur]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.

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

Nom du fichier : t_creating_remote_server_docker.html