Oracle JET仮想DOMアプリケーションのデプロイの準備
イントロダクション
このチュートリアルでは、Oracle JavaScript Extension Toolkit (Oracle JET)仮想DOMアプリケーションをデプロイ用に準備する方法を示します。
You can deploy the Oracle JET virtual DOM app, which contains a collection of HTML, TypeScript files using JSX syntax (TSX), and Cascading Style Sheets (CSS) files to any type of web or application server.デプロイメント方法は、アプリケーションが実行されるサーバー環境のタイプによって異なります。
Oracle JET仮想DOMアプリケーションをデプロイするには、特定の環境に他のクライアント・インタフェースをデプロイするのと同じ方法を使用できます。
- 通常、アプリケーションをZIPファイルとしてデプロイする場合は、仮想DOMアプリケーションの
/web
ディレクトリを圧縮し、標準のデプロイメント・プロセスに従うことができます。 - 通常、アプリケーションをWARファイルとしてデプロイする場合は、
/web
ディレクトリのアーカイブ・ファイルを生成する前に、仮想DOMアプリケーションを変更する必要がある場合もあります。たとえば、.war
ファイルを作成するには、web.xml
構成ファイルを含む/WEB-INF
ディレクトリを含めます。
Oracle JETコマンドライン・インタフェース・パッケージ(npx @oracle/ojet-cli create JET-Virtual-DOM-app --template=basic --vdom
)のコマンドを使用して作成する仮想DOMアプリケーションには、作成プロセスの新しいステップを定義するために使用できるフック・スクリプト・テンプレート・ファイルのディレクトリが含まれます。たとえば、仮想DOMアプリケーションの/web
ディレクトリをZIPファイルまたはWARファイルとしてアーカイブするフック・スクリプトを作成できます。このafter_build
スクリプトは、ビルド・プロセスの終了後に実行されます。
このチュートリアルでは、特定の環境およびプラットフォームに依存するデプロイメント・ステップを説明していません。
目的
このチュートリアルでは、仮想DOMアプリケーションの/web
ディレクトリをZIPファイルまたはWARファイルとしてアーカイブする方法を学習します。また、Oracle JETアプリケーション・ビルド・プロセスの一部としてアーカイブを自動化するように仮想DOMアプリケーションを変更する方法についても学習します。
前提条件
- Node.jsのインストールを含むOracle JET仮想DOMアプリケーションを作成するように設定された開発環境
- この学習パスの前のチュートリアルの完了、Oracle JET仮想DOMアプリケーションのデバッグ
- 環境のデプロイメント・プラクティスに精通していること
タスク1: after_buildフック・スクリプトの作成
変更した付属のフック・スクリプト・テンプレート・ファイルを使用して、after_build
フック・スクリプトを作成します。
-
JET-Virtual-DOM-app/scripts/hooks
ディレクトリに移動し、エディタでafter_build.js
フック・スクリプト・テンプレート・ファイルを開きます。 -
after-build-js.txt
コードスニペットをコピーし、テンプレートファイルの内容をコピーしたコードスニペットに置き換えます。
タスク2: after_buildフック・スクリプトの変更
フック・スクリプトを変更して、仮想DOMアプリケーションに対して生成するアーカイブ・ファイルのタイプを指定します。フック・スクリプトは、同じ圧縮方法を使用して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: リリース・モードでのアプリケーションの構築
仮想DOMアプリケーションをリリース・モードで構築する場合、build --release
コマンドは、/web/
ディレクトリ内のライブラリおよびスクリプトの開発バージョンを最小化されたバージョンに置き換えます。ビルド・プロセスが完了すると、ビルドはafter_build
フック・スクリプトを実行し、/web
ディレクトリの内容をアーカイブします。
-
ターミナル・ウィンドウを開き、
JET-Virtual-DOM-app
ディレクトリに移動し、archiver
npmパッケージをインストールします。npm install archiver
これにより、
JET-Virtual-DOM-app
プロジェクトにarchiver
npmパッケージがインストールされます。after_build.js
フックは、このパッケージを使用して仮想DOMアプリケーションをアーカイブします。 -
ターミナル・ウィンドウを開き、
JET-Virtual-DOM-app
ディレクトリに移動し、仮想DOMアプリケーションをリリース・モードで構築します。npx @oracle/ojet-cli build web --release
ビルド・プロセスは、
/scripts/hooks
ディレクトリにあるフック・スクリプトをトリガーし、終了まで数分かかります。 -
確認されるまで待ちます。
. . . Running after_build hook. Success: Build finished. Files were successfully archived.
-
JET-Virtual-DOM-app
ディレクトリに移動し、フック・スクリプトによって生成されたアーカイブ・ファイルを見つけます。たとえば、after_build
フック・スクリプトを変更してmy-archive.WAR
という名前のWARファイルを生成した場合、その名前のWARファイルがアプリケーションのルート・ディレクトリに表示されます。
次のステップ
このシリーズの次の学習パスの最初のチュートリアルに進むには、ここをクリックしてください。
その他の学習リソース
docs.oracle.com/learnで他のラボを探すか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、education.oracle.com/learning-explorerにアクセスしてOracle Learning Explorerになります。
製品ドキュメントについては、Oracle Help Centerを参照してください。
Prepare to deploy an Oracle JET virtual DOM app
F62133-01
December 2022
Copyright © 2022, Oracle and/or its affiliates.