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

Présentation

Ce tutoriel explique comment préparer une application DOM virtuelle Oracle JavaScript Extension Toolkit (Oracle JET) en vue du déploiement.

Vous pouvez déployer l'application DOM virtuelle Oracle JET, qui contient une collection de fichiers HTML, TypeScript à l'aide de la syntaxe JSX (TSX) et des fichiers CSS (Cascading Style Sheets) sur 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 votre application s'exécute.

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

L'application DOM virtuelle que vous créez à l'aide de la commande du package de l'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 connexion 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 connexion pour archiver le répertoire /web de l'application DOM virtuelle en tant que fichier ZIP ou en tant que fichier WAR. Ce script after_build s'exécute une fois le processus de création terminé.

Ce tutoriel ne présente 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 d'application Oracle JET.

Conditions requises

Tâche 1 : Créer le script de crochet after_build

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

  1. Naviguez jusqu'au répertoire JET-Virtual-DOM-app/scripts/hooks et ouvrez le fichier de modèle de script de crochet after_build.js dans un éditeur.

  2. Copiez l'extrait de code after-build-js.txt et remplacez le contenu du fichier de modèle par l'extrait de code copié.

Tâche 2 : Modifier le script de crochet after_build

Modifiez le script hook pour indiquer 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 crochet after_build pour spécifier l'extension du fichier de sortie, qui est .war par défaut.

  1. Dans le fichier after_build.js, modifiez le nom du 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 le nom du fichier. Les noms de fichier des scripts de connexion dans le répertoire /scripts/hooks correspondent à différents points de connexion de compilation Oracle JET.

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

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 du répertoire /web/ par des versions réduites. Une fois le processus de compilation terminé, la compilation exécute le script de crochet 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 l'ensemble npm archiver.

    npm install archiver

    Cette opération installe l'ensemble npm archiver dans le projet JET-Virtual-DOM-app. Le crochet after_build.js utilise ce paquetage 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 de lancement.

    npx ojet build web --release

    Le processus de création déclenche les scripts de connexion 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'archives généré par le script de connexion. Par exemple, si vous avez modifié le script de connexion after_build pour générer un fichier WAR nommé my-archive.war, un fichier WAR portant ce nom s'affiche dans le répertoire racine de l'application.

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

Étape suivante

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

Vous pouvez passer au tutoriel suivant dans le cheminement d'apprentissage, Créer un conteneur parent 1 et des composants de conteneur d'activité, dans le module Rédiger des composants.

Vous pouvez également retourner à la page principale du cheminement d'apprentissage DOM virtuel pour accéder à tous les modules de création d'applications DOM virtuelles.

Ressources d'apprentissage supplémentaires

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

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