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アプリケーションをデプロイするには、特定の環境に他のクライアント・インタフェースをデプロイするのと同じ方法を使用できます。

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アプリケーションを変更する方法についても学習します。

前提条件

タスク1: after_buildフック・スクリプトの作成

変更した付属のフック・スクリプト・テンプレート・ファイルを使用して、after_buildフック・スクリプトを作成します。

  1. JET-Virtual-DOM-app/scripts/hooksディレクトリに移動し、エディタでafter_build.jsフック・スクリプト・テンプレート・ファイルを開きます。

  2. after-build-js.txtコードスニペットをコピーし、テンプレートファイルの内容をコピーしたコードスニペットに置き換えます。

タスク2: after_buildフック・スクリプトの変更

フック・スクリプトを変更して、仮想DOMアプリケーションに対して生成するアーカイブ・ファイルのタイプを指定します。フック・スクリプトは、同じ圧縮方法を使用してZIPファイルとWARファイルを作成します。after_buildフック・スクリプトを変更して、出力ファイルの拡張子(デフォルトでは.war)を指定します。

  1. 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');
      
  2. ファイル名を変更せずにafter_build.jsファイルを保存します。/scripts/hooksディレクトリのフック・スクリプトのファイル名は、様々なOracle JETビルド・フック・ポイントに対応します。

タスク3: リリース・モードでのアプリケーションの構築

仮想DOMアプリケーションをリリース・モードで構築する場合、build --releaseコマンドは、/web/ディレクトリ内のライブラリおよびスクリプトの開発バージョンを最小化されたバージョンに置き換えます。ビルド・プロセスが完了すると、ビルドはafter_buildフック・スクリプトを実行し、/webディレクトリの内容をアーカイブします。

  1. ターミナル・ウィンドウを開き、JET-Virtual-DOM-appディレクトリに移動し、archiver npmパッケージをインストールします。

    npm install archiver
    

    これにより、JET-Virtual-DOM-appプロジェクトにarchiver npmパッケージがインストールされます。after_build.jsフックは、このパッケージを使用して仮想DOMアプリケーションをアーカイブします。

  2. ターミナル・ウィンドウを開き、JET-Virtual-DOM-appディレクトリに移動し、仮想DOMアプリケーションをリリース・モードで構築します。

    npx @oracle/ojet-cli build web --release
    

    ビルド・プロセスは、/scripts/hooksディレクトリにあるフック・スクリプトをトリガーし、終了まで数分かかります。

  3. 確認されるまで待ちます。

    . . .
    Running after_build hook.
    Success: Build finished.
    Files were successfully archived.
    
  4. JET-Virtual-DOM-appディレクトリに移動し、フック・スクリプトによって生成されたアーカイブ・ファイルを見つけます。たとえば、after_buildフック・スクリプトを変更してmy-archive.WARという名前のWARファイルを生成した場合、その名前のWARファイルがアプリケーションのルート・ディレクトリに表示されます。

    Oracle JET仮想DOMアプリケーションのルート・ディレクトリにあるWARファイル

    図root- folder- with- war- archive.pngの説明

次のステップ

このシリーズの次の学習パスの最初のチュートリアルに進むには、ここをクリックしてください。

その他の学習リソース

docs.oracle.com/learnで他のラボを探すか、Oracle Learning YouTubeチャネルで無料のラーニング・コンテンツにアクセスしてください。また、education.oracle.com/learning-explorerにアクセスしてOracle Learning Explorerになります。

製品ドキュメントについては、Oracle Help Centerを参照してください。