Création d'un serveur Liberty de plan de travail dans un conteneur Docker à l'aide des outils de développement

Utilisez WebSphere Developer Tools pour créer dans le plan de travail une référence à un serveur Liberty qui s'exécute dans un conteneur Docker. 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.
  • Installez Docker. Les outils prennent en charge Docker version 1.10.2 ou ultérieure. Pour plus d'informations sur l'installation de Docker, voir Prise en charge de la plateforme Docker dans Liberty.
  • [16.0.0.4 et ultérieur]Utilisez les outils de Docker pour gérer les images et les conteneurs Docker. Pour utiliser la fonction Docker Tooling, installez WebSphere Application Server Liberty Docker Tools, qui inclut Docker Tooling. Pour obtenir plus d'informations sur Docker Tooling, voir Linux Tools Project/Docker Tooling/User Guide.
  • Démarrez un serveur liberty dans un conteneur Docker local et assurez-vous que les ports HTTP et HTTPS sont mappés à l'hôte. Pour plus d'informations sur le démarrage d'un serveur Liberty dans un conteneur Docker local, voir WASdev GitHub.
  • Si vous utilisez Mac OS, par défaut les commandes Docker se trouvent dans le répertoire /usr/local/bin. Si vous modifiez l'emplacement des commandes Docker, effectuez les étapes suivantes pour que les outils puissent trouver les commandes Docker :
    1. Ajoutez la ligne suivante au fichier eclipse.ini :
      -Dcom.ibm.ws.st.envPath=<Docker commands directory>
    2. Redémarrez Eclipse.

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. Ensuite, vous pouvez entrer les données d'identification de sécurité pour votre serveur Liberty dans le but de créer une référence de plan de travail à votre serveur liberty dans votre conteneur Docker.

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 deux fois 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 une valeur pour localhost 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 mêmes fonctions que l'image Docker Liberty sélectionnée. Vérifiez également qu'elles sont configurées pour utiliser le même niveau d'environnement d'exécution Java (JRE). L'environnement d'exécution Liberty est utilisé comme environnement d'exécution cible 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 que vous puissiez créer une référence de plan de travail à un serveur Liberty dans un conteneur Docker.

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

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

    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 combinant ces deux méthodes, lorsque vous installez plusieurs fichiers archive supplémentaires
      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 Serveur Liberty, sélectionnez Serveur dans un conteneur Docker.
  8. Sélectionnez votre conteneur Docker à partir du menu Nom de conteneur.
    Conseil : Si vous ne voyez pas votre conteneur Docker dans le menu Nom du conteneur, cliquez sur Actualiser pour actualiser la liste.
  9. 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 modifier le nom d'utilisateur et le mot de passe saisis.
  10. Entrez la valeur de la zone Port sécurisé avec le port HTTPS spécifié dans la configuration du serveur.
  11. Cliquez sur Terminer.

Résultats

Vous avez créé dans le plan de travail une référence à un serveur qui s'exécute dans un conteneur Docker.

  • 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

  • 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 : 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 arrêter ou démarrer un serveur, ou ajouter ou retirer des applications sur le serveur, cliquez avec le bouton droit de la souris sur votre serveur afin d'utiliser le menu contextuel du serveur ou utilisez les boutons figurant 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 l'entrée de serveur dans la vue Serveurs. Ne sélectionnez pas une configuration de serveur, telle que l'entrée Configuration de serveur ou server.xml.
  • Vous pouvez configurer votre serveur Liberty pour authentifier les utilisateurs avec Tivoli Directory Server.
    1. Cliquez à l'aide du bouton droit de la souris sur Serveurs.
    2. Sélectionnez Utilitaires > Ajouter des fragments de configuration.
    3. Sélectionnez les fragments et acceptez les contrats de licence.
    Les outils téléchargent les fragments de configuration que vous avez sélectionnés et les ajoutent au fichier server.xml.
  • [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



Icône d'horodatage Dernière mise à jour: Tuesday, 6 December 2016
http://www14.software.ibm.com/webapp/wsbroker/redirect?version=cord&product=was-nd-mp&topic=t_creating_server_docker
Nom du fichier : t_creating_server_docker.html