准备部署 Oracle JET Web 应用程序

简介

本教程展示如何准备 Oracle JavaScript Extension Toolkit (Oracle JET) Web 应用程序进行部署。

您可以将包含 HTML、JavaScript 和级联样式表 (CSS) 文件集合的 Oracle JET Web 应用程序部署到任何类型的 Web 或应用程序服务器。部署方法取决于应用程序在其中运行的服务器环境的类型。

要部署 Oracle JET Web 应用程序，可以使用与在特定环境中部署任何其他客户机接口相同的方法。

如果通常将应用程序部署为 ZIP 文件，则可以压缩 Web 应用程序的 /web 文件夹并遵循标准部署过程。
如果通常将应用程序部署为 WAR 文件，则在生成 /web 文件夹的归档文件之前，您可能还需要修改 Web 应用程序。例如，要创建 .war 文件，请包含包含 web.xml 配置文件的 /WEB-INF 文件夹。

使用 Oracle JET 命令行界面创建的 Web 应用程序包含挂钩脚本模板文件的文件夹，您可以使用该文件夹为构建过程定义新步骤。例如，您可以创建一个挂钩脚本，将 Web 应用程序 /web 文件夹归档为 ZIP 文件或 WAR 文件。此 after_build 脚本在构建过程完成后运行。

本教程未说明依赖特定环境和平台的部署步骤。

目标

完成本教程后，您将了解如何将 Web 应用程序的 /web 文件夹归档为 ZIP 文件或 WAR 文件。您还将学习如何修改 Web 应用程序，以便在 Oracle JET 应用程序构建过程中自动执行归档。

先决条件

开发环境已设置为创建 Oracle JET 应用程序，并安装了 JavaScript 运行时、Node.js 和最新的 Oracle JET 命令行界面
完成此学习路径中的先前教程，以便您在 JET_Web_Application 文件夹中创建了 Oracle JET Web 应用程序
熟悉环境的部署做法

任务 1：创建 after_build Hook 脚本

使用您修改的提供的挂钩脚本模板文件创建 after_build 挂钩脚本。

导航到 JET_Web_Application/scripts/hooks 目录并在编辑器中打开 after_build.js 挂钩脚本模板文件。
复制 after-build-js.txt 代码片段并使用复制的代码片段替换模板文件的内容。

任务 2：修改 after_build Hook 脚本

修改挂钩脚本以指定要为 Web 应用程序生成的档案文件的类型。挂钩脚本使用相同的压缩方法创建 zip 文件和 WAR 文件。修改 after_build 钩子脚本以指定输出文件的扩展名，缺省情况下为 .war。

在 after_build.js 文件中，编辑传递给 fs.createWriteStream() 的文件名以使用相应的扩展名：.zip 或 .war。
- 要生成 WAR 文件，请将文件命名为 my-archive.war。
```
const output = fs.createWriteStream('my-archive.war');
```
- 要生成 ZIP 文件，请将文件命名为 my-archive.zip。
```
const output = fs.createWriteStream('my-archive.zip');
```
保存 after_build.js 文件而不更改文件名。/scripts/hooks 目录中的挂钩脚本的文件名对应于各种 Oracle JET 构建挂钩点。

任务 3：在发布模式下构建应用程序

在发行模式下构建 Web 应用程序时，build --release 命令会将 /web/ 文件夹中库和脚本的开发版本替换为最小版本。构建过程完成后，构建将执行 after_build 挂钩脚本并归档 /web 文件夹的内容。

打开终端窗口，转到 JET_Web_Application 目录，然后安装 archiver npm 软件包。
```
$ npm install archiver
```
这将安装 JET_Web_Application 项目中的 archiver npm 软件包。after_build.js 挂钩使用此程序包来归档 Web 应用程序。
打开终端窗口，转到 JET_Web_Application 目录，然后在发行模式下构建 Web 应用程序。
```
$ ojet build web --release
```
构建过程触发位于 /scripts/hooks 目录中的钩子脚本，需要几分钟才能完成。

等待确认。

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

导航到 JET_Web_Application 目录并找到由挂钩脚本生成的归档文件。例如，如果修改了 after_build 钩子脚本以生成名为 my-archive.war 的 WAR 文件，则会在应用程序根文件夹中显示具有该名称的 WAR 文件。

插图 root-folder-with-war-archive.png 的说明