Déploiement d’applications Web dans une jetée

Le plugin jetty Maven nous aide à effectuer des tests et itérations rapides lors de la création d'applications Web Java. Pour pouvoir déployer et exécuter des applications avec lui, il suffit d'ajouter le plugin danspom.xml:

La dernière version peut être trouvée en suivantthis Maven link.

Nous devons nous assurer que notre instance de Jetty exécutée sur le port8080 est arrêtée avant de passer à l'étape suivante.

Pour déployer notre application après avoir ajouté le plugin, nous naviguons vers la racine où se trouvepom.xml et exécutons la commande suivante:

Cette commande crée une nouvelle instance de jetée et le plug-in y déploie l'application. On peut y accéder en chargeanthttp://localhost:8080.

Le plugin Jetty Maven analyse en permanence le projet Web pour y rechercher les modifications et continue à le redéployer.

À partir de la sous-section précédente, l'application a été déployée sous le contexte/. Cependant, si nous souhaitons déployer sous un chemin de contexte donné tel que/jetty comme précédemment, nous devrons configurer le plugin différemment.

Nous allons changer notre déclaration de plugin en XML suivant:

Notez comment nous avons ajouté un bloc de configuration pour personnaliser davantage notre déploiement. Plusieurs options de configuration existent pour être placées à l'intérieur de ce bloc en fonction de ce que l'on veut.

Après ces modifications, nous pouvons réexécuter le plugin comme auparavant et accéder à notre application viahttp://localhost:8080/jetty.

Un scénario auquel on peut être confronté est une exception de port en cours d'utilisation. Peut-être avons-nous une instance de jetée fonctionnant sur le port8080 pour la production, mais nous sommes encore en phase de développement et souhaitons bénéficier de la facilité d'itération qui accompagne le déploiement à l'aide du plugin Maven.

Dans ce cas, nous devons exécuter notre serveur de test sur un port différent. Modifions la configuration du plug-in en XML suivant:

Lorsque nous réexécutons notre plugin Maven, nous pourrons accéder à notre application à partir dehttp://localhost:8888/jetty.

Il est à noter qu'avec le plugin Jetty Maven, nous n'avons pas besoin d'avoir une instance de Jetty installée et en cours d'exécution. Au contraire, il crée sa propre instance de jetée.

Pour utiliser jetty-runner dans le déploiement et l'exécution rapides de nos applications Web, nous pouvons télécharger la dernière version en suivant ceMaven link.

Avec jetty-runner, nous n'avons besoin de placer que le fichier téléchargé où bon nous semble et d'être prêt avec le chemin du système de fichiers de nos archives Web.

Nous pouvons passer des paramètres de configuration à partir de la ligne de commande et déployer de nombreuses applications dans différents contextes et liées à différents ports avec une seule commande.

J'ai placé mon pot jetty-runner dans la même hiérarchie que le répertoirejetty-app. C'est le répertoire contenant notre application Web.

Déployons notre WAR à l'aide de jetty-runner:

Cette commande, comme dans le cas du plug-in Maven, crée une instance de jetée et y déploie le fichier WAR fourni. Le chemin WAR peut être un chemin absolu ou relatif.

Nous pouvons charger cette application en utilisanthttp://localhost:8080.

Pour déployer sous le contexte/jetty comme précédemment:

Accessible viahttp://localhost:8080/jetty.

Pour déployer sur un numéro de port donné:

Accessible viahttp://localhost:9090.

Pour déployer plusieurs WAR avec la même commande, nous utilisons l'argument–path pour rendre chaque fichier unique:

On accèderait alors àone.war viahttp://localhost:8080/one ettwo.war viahttp://localhost:8080/two.

Dans cette section, nous verrons commentuse Cargo’s Maven plugin to deploy a WAR to Jetty, dans ce cas nous déploierons un WAR sur une instance Jetty 9.x.

Pour bien maîtriser l’ensemble du processus, nous allons commencer par créer une nouvelle application Web Java à partir de la ligne de commande:

Cela créera une application Web Java complète dans le répertoirecargo-deploy. Si nous construisons, déployons et chargeons cette application telle quelle, elle imprimeraHello World! dans le navigateur.

Puisque notre application Web ne contient pas de servlets, notre fichierweb.xml sera très basique. Naviguez donc vers le dossierWEB-INF de notre projet nouvellement créé et créez unweb.xml s'il n'a pas encore été créé automatiquement avec le contenu suivant:

Pour permettre à Maven de reconnaître les commandes de cargo sans saisir le nom complet, nous devons ajouter le plugin cargo Maven dans un groupe de plugins dans lessettings.xml. de Maven

En tant qu'enfant immédiat de l'élément racine<settings></settings>, ajoutez ceci:

Dans cette sous-section, nous modifierons nospom.xml en fonction de nos nouvelles exigences de déploiement.

Ajoutez le plugin comme suit:

Notez que nousexplicitly define the packaging as a WAR, sans cela, notre construction échouera. Dans la section plugins, nous ajoutons ensuite le plugin cargo maven2.

La dernière version au moment de l'écriture est1.5.0. Cependant, la dernière version peut toujours être trouvéehere. De plus, nous ajoutons une section de configuration où nous disons à Maven que nous utilisons le conteneur Jetty ainsi qu'une installation Jetty existante.

En définissant le type de conteneur surinstalled, nous indiquons à Maven que nous avons une instance Jetty installée sur la machine et nous fournissons l'URL absolue de cette installation.

En définissant le type de configuration surexisting, nous disons à Maven que nous avons une configuration existante que nous utilisons et qu'aucune configuration supplémentaire n'est requise.

L’alternative serait de demander à cargo de télécharger et d’installer la version de Jetty spécifiée en fournissant une URL. Cependant, nous nous concentrons surWAR deployment.

Il convient de noter que, que nous utilisions Maven 2.x ou Maven 3.x, le plugin cargo maven2 fonctionne pour les deux.

Nous pouvons maintenant installer notre application en exécutant:

et le déployer en lançant:

Si tout se passe bien dans la console Maven et Jetty, alors nous devrions pouvoir exécuter notre application Web en chargeanthttp://localhost:8080/cargo-deploy.

Si nous vérifions le dossier$JETTY_HOME/webapps, nous trouverons un fichier descripteur de déploiement ou ce que nous avons appelé précédemment un fichier de contexte appelécargo-deploy.xml créé par cargo.

Par défaut, Jetty n'offre aucune possibilité de déploiement à distance. Afin d'ajouter un tel support à Jetty, Cargo utilise l'application WebJetty remote deployer.

Cela signifie que nous devons télécharger un fichier WAR d'application Web pré-créé par les développeurs Cargo et déployer ce fichier WAR dans le conteneur de la jetée cible.

Chaque fois que nous voulons déployer sur ce serveur distant à l'aide du plug-in cargo Maven, il envoie une demande HTTP à l'application de déploiement sur le serveur distant avec notre WAR pour le déploiement.

Ce déployeur distant peut être trouvéhere. Rendez-vous dans la sectiontools et téléchargez le fichier WAR decargo-jetty-7-and-onwards-deployer.

Considérations de sécurité

Nous devons configurer unsecurity realm dans jetty avant que cela puisse fonctionner, à des fins d'authentification. Créez un fichier appelérealm.properties dans le répertoire$JETTY_HOME/etc du serveur de jetée distant. Le contenu du fichier est:

Leadmin est le nom d'utilisateur par lequel le client peut accéder aux applications sécurisées,password est le mot de passe etmanager est le rôle que les clients doivent posséder avant d'obtenir l'accès.

Nous devons également déclarer nos exigences de sécurité dans l'application de déploiement. Nous allons décompresser le fichier WAR que nous avons téléchargé à partir de la page de téléchargements de la jetée, y apporter des modifications et le réintégrer dans un fichier WAR.

Après avoir déballé, rendez-vous surWEB-INF/web.xml et décommentez le code XML avec le commentaireUncomment in order to activate security. Ou placez le code suivant ici:

Déployer le déployeur

Nous pouvons maintenant compresser l'application dans un fichier WAR et la copier dans n'importe quel emplacement du serveur distant. Nous le déploierons ensuite à Jetty.

Lors du déploiement, il est préférable d'utiliser undeployment descriptor file afin de pouvoir créer unsecurityHandler et lui passer unloginService. Toutes les applications sécurisées doivent disposer d'un service de connexion, sinon jetty ne pourra pas les déployer.

Maintenant, créons un fichier de contexte dans$JETTY_HOME/webapps de l'instance de jetée distante, rappelez-vous les règles de dénomination du fichier de contexte. Faites-en le même nom que le WAR:

Démarrez le serveur de jetée distant et si tout se passe bien, nous devrions pouvoir chargerhttp://localhost:8080/cargo-jetty-deployer. Nous devrions alors pouvoir voir quelque chose comme:

Déploiement de WAR sur une jetée distante

Pour effectuer un déploiement à distance, il suffit de modifier notre section de configuration depom.xml. Le déploiement à distance signifie que nous n'avons pas d'installation locale de Jetty mais que nous avons un accès authentifié à l'application de déploiement s'exécutant sur le serveur distant.

Modifions donc lespom.xml pour que la section de configuration ressemble à ceci:

Cette fois, nous changeons le type de conteneur deinstalled àremote et le type de configuration deexisting àruntime. Enfin, nous ajoutons des propriétés de nom d’hôte, de port et d’authentification à la configuration.

nettoyer le projet:

Installez-le:

enfin, déployez-le:

C'est ça.

Nous pouvons intégrer une installation Jetty dans eclipse en sélectionnant l'élémentwindow dans la barre des tâches, puispreferences dans le menu déroulant.

Nous trouverons une grille d'arborescence d'éléments de préférence dans le panneau de gauche de la fenêtre qui apparaît. Nous pouvons ensuite naviguer vers eclipse → serveurs ou simplement taper des serveurs dans la barre de recherche.

Nous sélectionnons ensuite le répertoire Jetty s'il n'est pas déjà ouvert pour nous et choisissons la version de Jetty que nous avons téléchargée.

Sur le côté droit du panneau apparaîtra une page de configuration où nous sélectionnons l’option Activer pour activer cette version de Jetty et accéder au dossier d’installation.

À partir des captures d’écran, jetty 7.x sera remplacé par la version de jetty que nous avons configurée.

Nous appliquons les modifications et la prochaine fois que nous ouvrirons la vue des serveurs à partir des fenêtres d’éclipse → afficher le sous-menu de la vue, le serveur nouvellement configuré sera présent et nous pourrons y démarrer, arrêter et déployer des applications.

Pour déployer une application Web sur l'instance Jetty intégrée, celle-ci doit exister dans notre espace de travail.

Ouvrez la vue deserversdepuis la fenêtre → afficher la vue et recherchez les serveurs. Lorsqu'il est ouvert, nous pouvons simplement faire un clic droit sur le serveur que nous avons configuré et sélectionneradd deployment dans le menu contextuel qui apparaît.

Dans la boîte de dialogueNew Deployment qui apparaît, ouvrez le menu déroulantproject et sélectionnez le projet Web.

Il y a une sectionDeploy Type sous la liste déroulanteProject lorsque nous sélectionnonsExploded Archive(development mode),our changes in the application will be synced live without having to redeploy, c'est la meilleure option pendant le développement car elle est très efficace.

La sélection dePackaged Archive(production mode) nous obligera à redéployer chaque fois que nous apportons des modifications et les visualisons dans le navigateur. Ceci n’est préférable que pour la production, mais Eclipse le rend tout aussi facile.

Nous choisissons généralement de déployer un fichier WAR via Eclipse pour faciliter le débogage. Il peut arriver un moment où nous souhaitons le déployer vers un emplacement autre que ceux utilisés par les serveurs embarqués d’Eclipse.

L'instance la plus courante est celle où notre serveur de production est en ligne et nous souhaitons mettre à jour l'application Web.

Nous pouvons contourner cette procédure en déployant en mode production et en notant lesDeploy Location dans la boîte de dialogueNew Deployment et en choisissant le WAR à partir de là.

Lors du déploiement, au lieu de sélectionner un serveur intégré, nous pouvons sélectionner l'option<Externally Launched> dans la vueservers à côté de la liste des serveurs embarqués. Nous naviguons vers le répertoire$JETTY_HOME /webapps d'une installation externe Jetty.

Ouvrez le menuRun et cliquez sur les optionsEdit Configurations.

Dans le panneau de gauche, recherchezJetty Server, s'il ne s'y trouve pas, cliquez sur le signe + dans le menu, recherchezJetty et sélectionnezLocal. Dans le champname, mettezJetty 9.

Cliquez sur le boutonConfigure… et dans le champJetty Home, accédez à l'emplacement d'origine de votre installation et sélectionnez-le.

Si vous le souhaitez, définissez la pageStartup surhttp://localhost:8080/ etHTTP port: 8080, modifiez le port le cas échéant.

Allez dans l'ongletDeployment et cliquez sur le symbole +, sélectionnez l'artefact que vous souhaitez ajouter au serveur et cliquez sur OK

Suivez les mêmes instructions que pour les configurations locales de Jetty, mais dans l'onglet Serveur, vous devez entrer l'emplacement distant de l'installation.