Bereitstellen von Webanwendungen in Jetty

Das Jetty Maven-Plugin hilft uns, schnelle Tests und Iterationen beim Erstellen von Java-Webanwendungen durchzuführen. Um Anwendungen damit bereitstellen und ausführen zu können, müssen wir nur das Plugin inpom.xml hinzufügen:

Die neueste Version finden Sie unterthis Maven link.

Wir müssen sicherstellen, dass unsere Instanz von Jetty, die auf Port8080 ausgeführt wird, gestoppt wird, bevor wir den nächsten Schritt ausführen.

Um unsere App nach dem Hinzufügen des Plugins bereitzustellen, navigieren wir zum Stammverzeichnis, in dem sichpom.xml befindet, und führen den folgenden Befehl aus:

Dieser Befehl erstellt eine neue Anlegestelleninstanz und das Plugin stellt die App dafür bereit. Wir können darauf zugreifen, indem wirhttp://localhost:8080. laden

Das Jetty Maven-Plug-in durchsucht das Webprojekt kontinuierlich nach Änderungen und stellt es immer wieder neu bereit.

Aus dem vorherigen Unterabschnitt wurde die App im Kontext von/bereitgestellt. Wenn wir jedoch wie zuvor unter einem bestimmten Kontextpfad wie/jetty bereitstellen möchten, müssen wir das Plugin anders konfigurieren.

Wir werden unsere Plugin-Deklaration in folgendes XML ändern:

Beachten Sie, wie wir einen Konfigurationsblock hinzugefügt haben, um unsere Bereitstellung weiter anzupassen. Es gibt verschiedene Konfigurationsoptionen, die in diesen Block eingefügt werden können, je nachdem, was gewünscht wird.

Nach diesen Änderungen können wir das Plugin wie zuvor erneut ausführen und überhttp://localhost:8080/jetty auf unsere App zugreifen.

Ein Szenario, mit dem man möglicherweise konfrontiert wird, ist eine Ausnahmebedingung für den verwendeten Port. Möglicherweise wird auf Port8080 eine Anlegestelleninstanz für die Produktion ausgeführt, aber wir befinden uns noch in der Entwicklungsphase und möchten von der einfachen Iteration profitieren, die mit der Bereitstellung mithilfe des Maven-Plugins einhergeht.

In solchen Fällen müssen wir unseren Testserver an einem anderen Port ausführen. Ändern wir die Plugin-Konfiguration in das folgende XML:

Wenn wir unser Maven-Plugin erneut ausführen, können wir vonhttp://localhost:8888/jetty auf unsere App zugreifen.

Es ist erwähnenswert, dass mit dem Jetty Maven-Plugin keine Instanz von Jetty installiert und ausgeführt werden muss. Es wird vielmehr eine eigene Anlegestelleninstanz erstellt.

Um Jetty-Runner für die schnelle Bereitstellung und Ausführung unserer Web-Apps zu verwenden, können wir die neueste Version herunterladen, indem wir dieseMaven link befolgen.

Mit Jetty-Runner müssen wir nur die heruntergeladene JAR-Datei beliebig platzieren und den Dateisystempfad zu unseren Webarchiven bereithalten.

Wir können Konfigurationsparameter über die Befehlszeile übergeben sowie zahlreiche Anwendungen in verschiedenen Kontexten bereitstellen und mit nur einem Befehl an verschiedene Ports binden.

Ich habe mein Jetty-Runner-Glas in dieselbe Hierarchie wie das Verzeichnisjetty-appgestellt. Dies ist das Verzeichnis, in dem sich unsere Webanwendung befindet.

Lassen Sie uns unser WAR mit Jetty-Runner bereitstellen:

Dieser Befehl erstellt genau wie das Maven-Plugin eine Jetty-Instanz und stellt die bereitgestellte WAR für sie bereit. Der WAR-Pfad kann ein absoluter oder ein relativer Pfad sein.

Wir können diese Anwendung mithttp://localhost:8080 laden.

So stellen Sie den Kontext wie zuvor unter/jettybereit:

Zugänglich überhttp://localhost:8080/jetty.

So stellen Sie auf einer bestimmten Portnummer bereit:

Zugänglich überhttp://localhost:9090.

Um mehrere WARs mit demselben Befehl bereitzustellen, verwenden wir das Argument–path, um jedes eindeutig zu machen:

Wir würden dann überhttp://localhost:8080/one aufone.war und überhttp://localhost:8080/two auftwo.war zugreifen.

In diesem Abschnitt sehen wir uns an, wieuse Cargo’s Maven plugin to deploy a WAR to Jetty ausgeführt werden. In diesem Fall stellen wir eine WAR für eine Jetty 9.x-Instanz bereit.

Um den gesamten Prozess in den Griff zu bekommen, erstellen wir zunächst eine neue Java-Webanwendung über die Befehlszeile:

Dadurch wird eine vollständige Java-Webanwendung im Verzeichniscargo-deployerstellt. Wenn wir diese Anwendung so wie sie ist erstellen, bereitstellen und laden, werdenHello World! im Browser gedruckt.

Da unsere Webanwendung keine Servlets enthält, ist die Dateiweb.xmlehr einfach. Navigieren Sie also zum OrdnerWEB-INF unseres neu erstellten Projekts und erstellen Sie einenweb.xml, wenn dieser noch nicht automatisch mit folgendem Inhalt erstellt wurde:

Damit Maven Frachtbefehle erkennen kann, ohne den vollständig qualifizierten Namen einzugeben, müssen wir das Fracht-Maven-Plugin in einer Plugin-Gruppe insettings.xml.von Maven hinzufügen

Fügen Sie als unmittelbares untergeordnetes Element des Elements root<settings></settings>Folgendes hinzu:

In diesem Unterabschnitt bearbeiten wir unserepom.xml, um sie an unsere neuen Bereitstellungsanforderungen anzupassen.

Fügen Sie das Plugin wie folgt hinzu:

Beachten Sie, dass wirexplicitly define the packaging as a WAR, ohne dies wird unser Build fehlschlagen. In der Plugins Sektion fügen wir dann das cargo maven2 Plugin hinzu.

Die neueste Version zum Zeitpunkt des Schreibens ist1.5.0. Die neueste Version ist jedoch immerhere zu finden. Zusätzlich fügen wir einen Konfigurationsabschnitt hinzu, in dem wir Maven mitteilen, dass wir den Jetty-Container verwenden, sowie eine vorhandene Jetty-Installation.

Indem Sie den Containertyp aufinstalled setzen, teilen wir Maven mit, dass auf dem Computer eine Jetty-Instanz installiert ist, und geben die absolute URL für diese Installation an.

Indem Sie den Konfigurationstyp aufexisting setzen, teilen wir Maven mit, dass ein vorhandenes Setup vorhanden ist und keine weitere Konfiguration erforderlich ist.

Die Alternative wäre, cargo anzuweisen, die angegebene Jetty-Version unter Angabe einer URL herunterzuladen und einzurichten. Unser Fokus liegt jedoch aufWAR deployment.

Es ist erwähnenswert, dass unabhängig davon, ob wir Maven 2.x oder Maven 3.x verwenden, das Cargo maven2-Plugin für beide funktioniert.

Wir können unsere Anwendung jetzt installieren, indem wir Folgendes ausführen:

und implementieren Sie es durch Ausführen von:

Wenn in der Maven- und Jetty-Konsole alles gut läuft, sollten wir unsere Webanwendung durch Laden vonhttp://localhost:8080/cargo-deploy. ausführen können

Wenn wir den Ordner$JETTY_HOME/webapps überprüfen, finden wir eine Bereitstellungsdeskriptordatei oder eine zuvor als Kontextdatei bezeichnete Datei mit dem Namencargo-deploy.xml, die von der Fracht erstellt wurde.

Standardmäßig bietet Jetty keine Möglichkeiten für die Remote-Bereitstellung. Um Jetty eine solche Unterstützung hinzuzufügen, verwendet Cargo die WebanwendungJetty remote deployer.

Dies bedeutet, dass wir eine von den Cargo-Entwicklern vorab erstellte WAR-Datei für Webanwendungen herunterladen und diese auf dem Ziel-Stegcontainer bereitstellen müssen.

Jedes Mal, wenn wir mit dem Cargo Maven-Plugin eine Bereitstellung auf diesem Remoteserver durchführen möchten, wird eine HTTP-Anforderung an die Bereitstellungsanwendung auf dem Remoteserver mit unserem WAR zur Bereitstellung gesendet.

Dieser Remote-Bereitsteller befindet sich inhere. Gehen Sie zum Abschnitttools und laden Sie den WARcargo-jetty-7-and-onwards-deployerherunter.

Sicherheitsüberlegungen

Wir müssen einsecurity realm in der Anlegestelle einrichten, bevor dies zur Authentifizierung funktionieren kann. Erstellen Sie eine Datei mit dem Namenrealm.properties im Verzeichnis$JETTY_HOME/etcdes Remote-Jetty-Servers. Der Dateiinhalt ist:

admin ist der Benutzername, unter dem der Client auf die gesicherten Apps zugreifen kann,password ist das Kennwort undmanager ist die Rolle, die die Clients besitzen müssen, bevor sie Zugriff erhalten.

Wir müssen auch unsere Sicherheitsanforderungen in der Bereitstellungsanwendung deklarieren. Wir werden die von der Jetty-Downloadseite heruntergeladene WAR-Datei entpacken, einige Änderungen vornehmen und sie wieder in eine WAR-Datei packen.

Gehen Sie nach dem Entpacken zuWEB-INF/web.xml und kommentieren Sie den XML-Code mit dem KommentarUncomment in order to activate securityaus. Oder platzieren Sie dort den folgenden Code:

Bereitstellen des Bereitstellers

Wir können die App jetzt wieder in eine WAR packen und an einen beliebigen Ort auf dem Remote-Server kopieren. Wir werden es dann zum Steg bringen.

Während der Bereitstellung ist es am besten, eindeployment descriptor file zu verwenden, damit wir einsecurityHandler erstellen und einloginService an dieses übergeben können. Alle gesicherten Anwendungen müssen über einen Anmeldedienst verfügen, sonst kann Jetty sie nicht bereitstellen.

Lassen Sie uns nun eine Kontextdatei in$JETTY_HOME/webapps der Remote-Jetty-Instanz erstellen. Beachten Sie dabei die Regeln für die Benennung der Kontextdatei. Machen Sie es den gleichen Namen wie die WAR:

Starten Sie den Remote-Anlegestellen-Server. Wenn alles gut läuft, sollten wirhttp://localhost:8080/cargo-jetty-deployer. laden können. Dann sollten wir Folgendes sehen können:

Bereitstellen von WAR auf Remote Jetty

Für eine Remote-Bereitstellung müssen wir nur unseren Konfigurationsabschnitt vonpom.xml ändern. Remote-Bereitstellung bedeutet, dass wir keine lokale Installation von Jetty haben, sondern über authentifizierten Zugriff auf die auf dem Remote-Server ausgeführte Deployer-App verfügen.

Ändern wir also diepom.xml so, dass der Konfigurationsabschnitt folgendermaßen aussieht:

Dieses Mal ändern wir den Containertyp voninstalled inremote und den Konfigurationstyp vonexisting inruntime. Zuletzt fügen wir der Konfiguration Hostnamen-, Port- und Authentifizierungseigenschaften hinzu.

Bereinigen Sie das Projekt:

es installieren:

Stellen Sie es schließlich bereit:

Das ist es.

Wir können eine Jetty-Installation in Eclipse einbetten, indem wirwindow Element aus der Taskleiste und dannpreferences aus dem Dropdown-Menü auswählen.

Im linken Bereich des angezeigten Fensters finden Sie ein Baumgitter mit Präferenzelementen. Wir können dann zu Eclipse → Servern navigieren oder einfach Server in die Suchleiste eingeben.

Wir wählen dann das Jetty-Verzeichnis, falls es noch nicht für uns geöffnet ist, und wählen die von uns heruntergeladene Jetty-Version.

Auf der rechten Seite des Panels wird eine Konfigurationsseite angezeigt, auf der wir die Aktivierungsoption auswählen, um diese Jetty-Version zu aktivieren und zum Installationsordner zu navigieren.

In den Screenshots wird Steg 7.x durch die von uns konfigurierte Version des Stegs ersetzt.

Wir übernehmen Änderungen und wenn wir das nächste Mal die Serveransicht über das Untermenü von Eclipse öffnen → Ansicht anzeigen, ist der neu konfigurierte Server vorhanden und wir können Anwendungen darauf starten, stoppen und bereitstellen.

Um eine Webanwendung für die eingebettete Jetty-Instanz bereitzustellen, muss sie in unserem Arbeitsbereich vorhanden sein.

Öffnen Sie die Ansichtserversim Fenster → Ansicht anzeigen und suchen Sie nach Servern. Wenn es geöffnet ist, können wir einfach mit der rechten Maustaste auf den von uns konfigurierten Server klicken undadd deployment aus dem angezeigten Kontextmenü auswählen.

Öffnen Sie im angezeigten DialogfeldNew Deployment die Dropdown-Listeproject und wählen Sie das Webprojekt aus.

Unter dem KombinationsfeldProject befindet sich ein AbschnittDeploy Type, wenn wirExploded Archive(development mode),our changes in the application will be synced live without having to redeploy auswählen. Dies ist die beste Option während der Entwicklung, da es sehr effizient ist.

Wenn SiePackaged Archive(production mode) auswählen, müssen wir jedes Mal, wenn wir Änderungen vornehmen, diese erneut bereitstellen und im Browser anzeigen. Dies ist nur für die Produktion am besten geeignet, Eclipse macht es jedoch genauso einfach.

Wir entscheiden uns normalerweise für die Bereitstellung einer WAR über Eclipse, um das Debuggen zu vereinfachen. Es kann vorkommen, dass wir möchten, dass es an einem anderen Ort als den von den eingebetteten Servern von Eclipse verwendeten bereitgestellt wird.

In den meisten Fällen ist unser Produktionsserver online und wir möchten die Webanwendung aktualisieren.

Wir können dieses Verfahren umgehen, indem wir es im Produktionsmodus bereitstellen, dieDeploy Location im DialogfeldNew Deployment notieren und von dort aus die WAR auswählen.

Während der Bereitstellung können Sie anstelle eines eingebetteten Servers die Option<Externally Launched> in der Ansichtserversneben der Liste der eingebetteten Server auswählen. Wir navigieren zum Verzeichnis$JETTY_HOME /webapps einer externen Jetty-Installation.

Öffnen Sie das MenüRunund klicken Sie auf die OptionenEdit Configurations.

Wenn Sie im linken Bereich nachJetty Server suchen, klicken Sie auf das Pluszeichen im Menü, suchen Sie nachJetty und wählen SieLocal aus. Geben Sie in das FeldnameJetty 9 ein.

Klicken Sie auf die SchaltflächeConfigure… und navigieren Sie im FeldJetty Home zum Ausgangsort Ihrer Installation und wählen Sie ihn aus.

Stellen Sie die SeiteStartup optional aufhttp://localhost:8080/ undHTTP port: 8080 ein und ändern Sie den Port entsprechend.

Gehen Sie zur RegisterkarteDeployment und klicken Sie auf das Symbol +, wählen Sie das Artefakt aus, das Sie dem Server hinzufügen möchten, und klicken Sie auf OK

Befolgen Sie die gleichen Anweisungen wie für lokale Jetty-Konfigurationen, aber auf der Registerkarte Server müssen Sie den Remote-Speicherort der Installation eingeben.