Preparación para desplegar una aplicación DOM virtual de Oracle JET

Introducción

En este tutorial se muestra cómo preparar una aplicación DOM virtual de Oracle JavaScript Extension Toolkit (Oracle JET) para el despliegue.

Puede desplegar la aplicación DOM virtual de Oracle JET, que contiene una recopilación de archivos HTML, TypeScript mediante los archivos de sintaxis JSX (TSX) y hojas de estilo en cascada (CSS) en cualquier tipo de servidor web o de aplicación. El método de despliegue depende del tipo de entorno de servidor en el que se ejecute la aplicación.

Para desplegar la aplicación DOM virtual de Oracle JET, puede utilizar el mismo método que utiliza para desplegar cualquier otra interfaz de cliente en su entorno específico.

Si normalmente despliega aplicaciones como archivos ZIP, puede comprimir el directorio /web de la aplicación DOM virtual y seguir el proceso de despliegue estándar.
Si normalmente despliega aplicaciones como archivos WAR, puede que también necesite modificar la aplicación DOM virtual antes de generar el archivo de almacenamiento del directorio /web. Por ejemplo, para crear un archivo .war, debe incluir un directorio /WEB-INF que contenga un archivo de configuración web.xml.

La aplicación DOM virtual que crea con el comando del paquete de interfaz de línea de comandos (npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom) de Oracle JET contiene un directorio de archivos de plantilla de script de enlace que puede utilizar para definir nuevos pasos para el proceso de creación. Por ejemplo, puede crear un script de enlace para archivar el directorio /web de la aplicación DOM virtual como un archivo ZIP o como un archivo WAR. Este script after_build se ejecuta una vez que finaliza el proceso de creación.

En este tutorial no se ilustran los pasos de despliegue que dependen de un entorno y una plataforma específicos.

Objetivos

En este tutorial, aprenderá a archivar el directorio /web de la aplicación DOM virtual como un archivo ZIP o un archivo WAR. También aprenderá a modificar la aplicación DOM virtual para automatizar el archivado como parte del proceso de creación de la aplicación Oracle JET.

Requisitos

Un entorno de desarrollo configurado para crear aplicaciones DOM virtuales de Oracle JET que incluya una instalación de Node.js
Finalización del tutorial anterior en esta ruta de aprendizaje, Depuración de una aplicación de DOM virtual de Oracle JET
Familiaridad con las prácticas de despliegue de su entorno

Tarea 1: Creación del script de enlace after_build

La secuencia de comandos de enlace after_build se crea mediante un archivo de plantilla de secuencia de comandos de enlace proporcionado que se modifica.

Navegue al directorio JET-Virtual-DOM-app/scripts/hooks y abra el archivo de plantilla de script de enlace after_build.js en un editor.
Copie el fragmento de código after-build-js.txt y sustituya el contenido del archivo de plantilla por el fragmento de código copiado.

Tarea 2: Modificación del script de enlace after_build

Modifique el script de enlace para especificar el tipo de archivo de almacenamiento que desea generar para la aplicación DOM virtual. La secuencia de comandos de enlace utiliza el mismo método de compresión para crear el archivo ZIP y el archivo WAR. Modifique la secuencia de comandos de enlace after_build para especificar la extensión del archivo de salida, que es .war por defecto.

En el archivo after_build.js, edite el nombre de archivo transferido a fs.createWriteStream() para utilizar la extensión adecuada: .zip o .war.
- Para generar un archivo WAR, asigne al archivo el nombre my-archive.war.
```
const output = fs.createWriteStream('my-archive.war');
```
- Para generar un archivo ZIP, asigne al archivo el nombre my-archive.zip.
```
const output = fs.createWriteStream('my-archive.zip');
```
Guarde el archivo after_build.js sin cambiar el nombre de archivo. Los nombres de archivo de los scripts de enlace del directorio /scripts/hooks corresponden a varios puntos de enlace de compilación de Oracle JET.

Tarea 3: Creación de la aplicación en modo de versión

Al crear la aplicación DOM virtual en modo de versión, el comando build --release sustituye la versión de desarrollo de las bibliotecas y scripts del directorio /web/ por versiones minificadas. Cuando finaliza el proceso de creación, la compilación ejecuta la secuencia de comandos de enlace after_build y archiva el contenido del directorio /web.

Abra una ventana de terminal, cambie al directorio JET-Virtual-DOM-app e instale el paquete npm archiver.
```
npm install archiver
```
Esto instala el paquete npm archiver en el proyecto JET-Virtual-DOM-app. El enlace after_build.js utiliza este paquete para archivar la aplicación DOM virtual.
Abra una ventana de terminal, cambie al directorio JET-Virtual-DOM-app y cree la aplicación DOM virtual en modo de versión.
```
npx @oracle/ojet-cli build web --release
```
El proceso de creación dispara scripts de enlace ubicados en el directorio /scripts/hooks y tarda unos minutos en terminar.

Espere la confirmación.

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

Navegue hasta el directorio JET-Virtual-DOM-app y localice el archivo de almacenamiento generado por la secuencia de comandos de enlace. Por ejemplo, si ha modificado el script de enlace after_build para generar un archivo WAR denominado my-archive.war, aparecerá un archivo WAR con ese nombre en el directorio raíz de la aplicación.

Descripción de la ilustración root-folder-with-war-archive.png

Siguiente paso

Para continuar con el primer tutorial en la siguiente ruta de aprendizaje de esta serie, haga clic aquí.

Más recursos de aprendizaje

Explore otros laboratorios en docs.oracle.com/learn o acceda a más contenido de aprendizaje gratuito en el canal YouTube de Oracle Learning. Además, visite education.oracle.com/learning-explorer para convertirse en un explorador de Oracle Learning.

Para obtener documentación sobre el producto, visite Oracle Help Center.

Título e Información de Copyright

Prepare to deploy an Oracle JET virtual DOM app

F62133-01

December 2022