Préparer le déploiement d'une application Web Oracle JET

Introduction

Ce tutoriel vous explique comment préparer une application Web Oracle JavaScript Extension Toolkit (Oracle JET) pour le déploiement.

Vous pouvez déployer l'application Web Oracle JET, qui contient un ensemble de fichiers HTML, JavaScript et CSS (Cascading Style Sheets), vers n'importe quel type de serveur d'applications ou Web. La méthode de déploiement dépend du type d'environnement de serveur dans lequel l'application est exécutée.

Pour déployer l'application Web Oracle JET, vous pouvez utiliser la même méthode que pour déployer toute autre interface client dans votre environnement spécifique.

Si vous déployez normalement des applications en tant que fichiers ZIP, vous pouvez compresser le dossier /web de l'application Web et suivre le processus de déploiement standard.
Si vous déployez normalement des applications en tant que fichiers WAR, vous devrez peut-être également modifier l'application Web avant de générer le fichier d'archive du dossier /web. Par exemple, pour créer un fichier .war, vous incluez un dossier /WEB-INF contenant un fichier de configuration web.xml.

L'application Web que vous créez avec l'interface de ligne de commande d'Oracle JET contient un dossier de fichiers de modèle de script de point d'accrochage que vous pouvez utiliser pour définir de nouvelles étapes pour le processus de création. Par exemple, vous pouvez créer un script de hook pour archiver le dossier /web de l'application Web sous forme de fichier ZIP ou de fichier WAR. Ce script after_build s'exécute une fois le processus de création terminé.

Ce tutoriel n'illustre pas les étapes de déploiement qui dépendent d'un environnement et d'une plate-forme spécifiques.

Objectifs

A l'issue de ce tutoriel, vous aurez appris à archiver le dossier /web de l'application Web en tant que fichier ZIP ou fichier WAR. Vous apprendrez également à modifier l'application Web pour automatiser l'archivage dans le cadre du processus de création d'applications Oracle JET.

Prérequis

Environnement de développement configuré pour créer des applications Oracle JET avec l'exécution JavaScript, Node.js et la dernière interface de ligne de commande Oracle JET installée
Réalisation des tutoriels précédents dans ce parcours de formation, afin que vous ayez créé l'application Web Oracle JET dans le dossier JET_Web_Application
Connaissance des pratiques de déploiement de votre environnement

Tâche 1 : création du script de point d'accrochage after_build

Vous créez le script de hook after_build à l'aide d'un fichier modèle de script de hook fourni que vous modifiez.

Accédez au répertoire JET_Web_Application/scripts/hooks et ouvrez le fichier de modèle de script de hook after_build.js dans un éditeur.
Copiez le fragment de code after-build-js.txt et remplacez le contenu du fichier modèle par le fragment de code copié.

Tâche 2 : modification du script de point d'accrochage after_build

Modifiez le script de hook pour indiquer le type de fichier d'archive à générer pour l'application Web. Le script de hook utilise la même méthode de compression pour créer le fichier zip et le fichier WAR. Modifiez le script de hook after_build afin d'indiquer l'extension du fichier de sortie, à savoir .war par défaut.

Dans le fichier after_build.js, modifiez le nom de fichier transmis à fs.createWriteStream() pour utiliser l'extension appropriée : .zip ou .war.
- Pour générer un fichier WAR, nommez le fichier my-archive.war.
```
const output = fs.createWriteStream('my-archive.war');
```
- Pour générer un fichier ZIP, nommez le fichier my-archive.zip.
```
const output = fs.createWriteStream('my-archive.zip');
```
Enregistrez le fichier after_build.js sans modifier le nom du fichier. Les noms de fichier des scripts de hook dans le répertoire /scripts/hooks correspondent à différents points de hook de build Oracle JET.

Tâche 3 : créer l'application en mode version

Lorsque vous créez l'application Web en mode version, la commande build --release remplace la version de développement des bibliothèques et des scripts dans le dossier /web/ par des versions minifiées. Une fois le processus de création terminé, le build exécute le script de hook after_build et archive le contenu du dossier /web.

Ouvrez une fenêtre de terminal, accédez au répertoire JET_Web_Application et installez le package archiver npm.
```
$ npm install archiver
```
Cette opération installe le package archiver npm dans le projet JET_Web_Application. Le hook after_build.js utilise ce package pour archiver votre application Web.
Ouvrez une fenêtre de terminal, accédez au répertoire JET_Web_Application et créez l'application Web en mode version.
```
$ ojet build web --release
```
Le processus de création déclenche des scripts de hook situés dans le répertoire /scripts/hooks et prend quelques minutes.

Attendez la confirmation.

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

Accédez au répertoire JET_Web_Application et localisez le fichier d'archive généré par le script de hook. Par exemple, si vous avez modifié le script de hook after_build pour générer un fichier WAR nommé my-archive.war, un fichier WAR portant ce nom apparaît dans le dossier racine de l'application.

Description de l'illustration root-folder-with-war-archive.png ci-après

Ressources de formation supplémentaires

Explorez d'autres exercices sur docs.oracle.com/learn ou accédez à davantage de contenu d'apprentissage gratuit sur le canal Oracle Learning YouTube. De plus, visitez le site education.oracle.com/learning-explorer pour devenir Oracle Learning Explorer.

Pour consulter la documentation du produit, consultez le centre d'aide Oracle.

Informations relatives au titre et au copyright

Prepare to deploy an Oracle JET web app

F53083-01

February 2022