Deployment einer Oracle JET-Webanwendung vorbereiten

Einführung

In diesem Tutorial wird gezeigt, wie Sie eine Oracle JavaScript Extension Toolkit-(Oracle JET-)Webanwendung für das Deployment vorbereiten.

Sie können die Oracle JET-Webanwendung, die eine Sammlung von HTML-, JavaScript- und Cascading Style Sheets-(CSS-)Dateien enthält, für jeden Web- oder Anwendungsservertyp bereitstellen. Die Deployment-Methode hängt vom Typ der Serverumgebung ab, in der Ihre App ausgeführt wird.

Um die Oracle JET-Webanwendung bereitzustellen, können Sie dieselbe Methode verwenden, mit der Sie eine andere Clientschnittstelle in Ihrer spezifischen Umgebung bereitstellen.

Wenn Sie Anwendungen normalerweise als ZIP-Dateien bereitstellen, können Sie den Ordner /web der Webanwendung komprimieren und Ihrem Standardbereitstellungsprozess folgen.
Wenn Sie Anwendungen normalerweise als WAR-Dateien bereitstellen, müssen Sie möglicherweise auch die Webanwendung ändern, bevor Sie die Archivdatei des Ordners /web generieren. Beispiel: Um eine .war-Datei zu erstellen, nehmen Sie einen /WEB-INF-Ordner auf, der eine web.xml-Konfigurationsdatei enthält.

Die Webanwendung, die Sie mit der Oracle JET-Befehlszeilenschnittstelle erstellen, enthält einen Ordner mit Hook-Skript-Vorlagendateien, mit denen Sie neue Schritte für den Erstellungsprozess definieren können. Beispiel: Sie können ein Hook-Skript erstellen, um den Ordner /web der Webanwendung als ZIP-Datei oder als WAR-Datei zu archivieren. Dieses after_build-Skript wird ausgeführt, nachdem der Erstellungsprozess abgeschlossen ist.

Dieses Tutorial veranschaulicht die Deployment-Schritte nicht, die von einer bestimmten Umgebung und Plattform abhängen.

Ziele

Nach Abschluss dieses Tutorials erfahren Sie, wie Sie den Ordner /web der Webanwendung als ZIP-Datei oder als WAR-Datei archivieren. Außerdem erfahren Sie, wie Sie die Webanwendung ändern, um die Archivierung im Rahmen des Erstellungsprozesses für die Oracle JET-App zu automatisieren.

Voraussetzungen

Eine Entwicklungsumgebung zum Erstellen von Oracle JET-Anwendungen mit der JavaScript-Laufzeit, Node.js und der neuesten installierten Oracle JET-Befehlszeilenschnittstelle
Abschluss der vorherigen Tutorials in diesem Lernpfad, sodass Sie die Oracle JET-Webanwendung im Ordner JET_Web_Application erstellt haben
Kenntnisse zu den Deployment-Praktiken Ihrer Umgebung

Aufgabe 1: after_build-Hook-Skript erstellen

Sie erstellen das Hook-Skript after_build mit einer von Ihnen geänderten Hook-Skriptvorlagendatei.

Navigieren Sie zum Verzeichnis JET_Web_Application/scripts/hooks, und öffnen Sie die Hook-Skriptvorlagendatei after_build.js in einem Editor.
Kopieren Sie das Code-Snippet after-build-js.txt, und ersetzen Sie den Inhalt der Vorlagendatei durch das kopierte Code-Snippet.

Aufgabe 2: after_build-Hook-Skript ändern

Ändern Sie das Hook-Skript, um den Typ der Archivdatei anzugeben, die Sie für die Webanwendung generieren möchten. Das Hook-Skript verwendet dieselbe Komprimierungsmethode, um die ZIP-Datei und die WAR-Datei zu erstellen. Sie ändern das Hook-Skript after_build, um die Erweiterung der Ausgabedatei anzugeben, die standardmäßig .war lautet.

Bearbeiten Sie in der Datei after_build.js den an fs.createWriteStream() übergebenen Dateinamen, um die entsprechende Erweiterung zu verwenden: .zip oder .war.
- Um eine WAR-Datei zu generieren, benennen Sie die Datei my-archive.war.
```
const output = fs.createWriteStream('my-archive.war');
```
- Um eine ZIP-Datei zu generieren, benennen Sie die Datei my-archive.zip.
```
const output = fs.createWriteStream('my-archive.zip');
```
Speichern Sie die Datei after_build.js, ohne den Dateinamen zu ändern. Die Dateinamen der Hook-Skripte im Verzeichnis /scripts/hooks entsprechen verschiedenen Oracle JET Build Hook Points.

Aufgabe 3: App im Releasemodus erstellen

Wenn Sie die Webanwendung im Releasemodus erstellen, ersetzt der Befehl build --release die Entwicklungsversion der Bibliotheken und Skripte im Ordner /web/ durch minimierte Versionen. Nach Abschluss des Erstellungsprozesses führt der Build das Hook-Skript after_build aus und archiviert den Inhalt des Ordners /web.

Öffnen Sie ein Terminalfenster, wechseln Sie in das Verzeichnis JET_Web_Application, und installieren Sie das Package archiver npm.
```
$ npm install archiver
```
Dadurch wird das archiver npm-Package im JET_Web_Application-Projekt installiert. Der Hook after_build.js verwendet dieses Package zur Archivierung Ihrer Webanwendung.
Öffnen Sie ein Terminalfenster, wechseln Sie in das Verzeichnis JET_Web_Application, und erstellen Sie die Webanwendung im Releasemodus.
```
$ ojet build web --release
```
Der Erstellungsprozess löst Hook-Skripte aus, die sich im Verzeichnis /scripts/hooks befinden, und nimmt einige Minuten in Anspruch.

Warten Sie auf eine Bestätigung.

. . .
Running after_build hook.
Success: Build finished.
Files were successfully archived.

Navigieren Sie in das Verzeichnis JET_Web_Application, und suchen Sie die vom Hook-Skript generierte Archivdatei. Beispiel: Wenn Sie das Hook-Skript after_build geändert haben, um eine WAR-Datei mit dem Namen my-archive.war zu generieren, wird im Root-Ordner der App eine WAR-Datei mit diesem Namen angezeigt.

Beschreibung der Abbildung root-folder-with-war-archive.png

Weitere Lernressourcen

Sehen Sie sich andere Übungen zu docs.oracle.com/learn an, oder greifen Sie auf weitere Inhalte für kostenloses Lernen im Oracle Learning YouTube-Kanal zu. Außerdem besuchen Sie education.oracle.com/learning-explorer, um Oracle Learning Explorer zu werden.

Produktdokumentation finden Sie im Oracle Help Center.

Titel und Copyright-Informationen

Prepare to deploy an Oracle JET web app

F53075-01

February 2022