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

Introduction

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

Vous pouvez déployer l'application DOM virtuelle Oracle JET, qui contient un ensemble de fichiers HTML, TypeScript à l'aide de la syntaxe JSX (TSX) et de 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 serveur dans lequel votre 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 hook que vous pouvez utiliser pour définir de nouvelles étapes pour le processus de création. Par exemple, vous pouvez créer un script hook pour archiver le répertoire /web de l'application DOM virtuelle sous forme de fichier ZIP ou de fichier WAR. Ce script after_build s'exécute une fois le processus de build 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 sous forme de fichier ZIP ou de fichier WAR. Vous apprendrez également à modifier l'application DOM virtuelle pour automatiser l'archivage dans le cadre du processus de création d'applications Oracle JET.

Prérequis

Tâche 1 : créer le script Hook after_build

Vous créez le script de hook after_build à l'aide d'un fichier de modèle de script de hook 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 : modifier le script de point d'accrochage after_build

Modifiez le script hook pour spécifier le type de fichier archive que vous souhaitez 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 hook 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 my-archive.war. 
      const output = fs.createWriteStream('my-archive.war');
    • Pour générer un fichier ZIP, nommez-le 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 construction Oracle JET.

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

Lorsque vous créez l'application DOM virtuelle en mode de publication, la commande build --release remplace la version de développement des bibliothèques et des scripts dans le répertoire /web/ par des versions réduites. Une fois le processus de construction terminé, le build exécute le script de hook 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 archiver npm.

    npm install archiver

    Cette opération installe le package archiver npm 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 ojet build web --release

    Le processus de build déclenche des scripts 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 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 répertoire racine de l'application.

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

Etape suivante

Ce tutoriel conclut le module Votre première application Oracle JET Virtual DOM dans ce parcours pédagogique sur la création d'applications Web DOM virtuelles.

Vous pouvez passer au tutoriel suivant dans le parcours de formation, Créer un conteneur parent 1 et des composants de conteneur d'activité, dans le module Composer des composants.

Vous pouvez également revenir à la page principale du parcours de formation DOM virtuel pour accéder à tous les modules sur la création d'applications DOM virtuelles.

Ressources de formation supplémentaires

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

Pour obtenir de la documentation sur le produit, consultez Oracle Help Center.