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 configurationweb.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 hookafter_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 packagearchiver
npm.$ npm install archiver
Cette opération installe le package
archiver
npm dans le projetJET_Web_Application
. Le hookafter_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 hookafter_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.
Prepare to deploy an Oracle JET web app
F53083-01
February 2022
Copyright © 2022, Oracle and/or its affiliates.