Préparer le déploiement d'une application Oracle JET Virtual DOM

Introduction

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

Vous pouvez déployer l'application DOM virtuelle Oracle JET, qui contient un ensemble de fichiers HTML, TypeScript utilisant la syntaxe JSX (TSX) et des fichiers CSS (Cascading Style Sheets) vers n'importe quel type de serveur Web ou d'application. La méthode de déploiement dépend du type d'environnement de serveur dans lequel l'application s'exécute.

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

L'application DOM virtuelle que vous créez à l'aide de la commande du package d'interface de ligne de commande Oracle JET (npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom) contient un répertoire 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 point d'accrochage pour archiver le répertoire /web de l'application DOM virtuelle sous forme de fichier ZIP ou de fichier WAR. Ce script after_build est exécuté 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

Dans ce tutoriel, vous apprendrez à archiver le répertoire /web de l'application DOM virtuelle en tant que fichier ZIP ou fichier WAR. Vous apprendrez également à modifier l'application DOM virtuelle pour automatiser l'archivage dans le cadre du processus de création de l'application Oracle JET.

Prérequis

Tâche 1 : création du script de hook after_build

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

  1. Accédez au répertoire JET-Virtual-DOM-app/scripts/hooks et ouvrez le fichier de modèle de script de hook after_build.js dans un éditeur.

  2. 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 hook after_build

Modifiez le script de point d'accrochage pour spécifier le type de fichier d'archive à générer pour l'application DOM virtuelle. Le script hook utilise la même méthode de compression pour créer le fichier ZIP et le fichier WAR. Vous modifiez le script de point d'accrochage after_build pour indiquer l'extension du fichier de sortie, qui est .war par défaut.

  1. 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');
  2. Enregistrez le fichier after_build.js sans modifier son nom. Les noms de fichier des scripts de point d'accrochage dans le répertoire /scripts/hooks correspondent à divers points d'accrochage de build Oracle JET.

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

Lorsque vous créez l'application DOM virtuelle en mode version, la commande build --release remplace la version de développement des bibliothèques et des scripts du répertoire /web/ par des versions minifiées. Une fois le processus de construction terminé, le build exécute le script de point d'accrochage after_build et archive le contenu du répertoire /web.

  1. Ouvrez une fenêtre de terminal, accédez au répertoire JET-Virtual-DOM-app et installez le package npm archiver.

    npm install archiver

    Cette opération installe le package npm archiver dans le projet JET-Virtual-DOM-app. Le hook after_build.js utilise ce package pour archiver votre application DOM virtuelle.

  2. Ouvrez une fenêtre de terminal, accédez au répertoire JET-Virtual-DOM-app et créez l'application DOM virtuelle en mode Release.

    npx @oracle/ojet-cli 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.

  3. Attendez la confirmation.

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

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

    Fichier WAR dans le répertoire racine d'une application Oracle JET Virtual DOM

    Description de l'illustration root-folder-with-war-archive.png

Etape suivante

Pour passer au premier tutoriel du prochain parcours de formation de cette série, cliquez ici.

Ressources de formation supplémentaires

Parcourez d'autres ateliers sur docs.oracle.com/learn ou accédez à d'autres contenus de formation gratuite sur le canal Oracle Learning YouTube. En outre, visitez le site education.oracle.com/learning-explorer pour devenir un explorateur Oracle Learning.

Pour consulter la documentation du produit, visitez le site Oracle Help Center.