準備部署 Oracle JET Web App

簡介

本教學課程示範如何準備 Oracle JavaScript Extension Toolkit (Oracle JET) Web 應用程式以進行部署。

您可以將 Oracle JET Web 應用程式 (其中包含 HTML、JavaScript 和階層式樣式表 (CSS) 檔案的集合) 部署至任何類型的 Web 或應用程式伺服器。部署方法取決於 App 執行的伺服器環境類型。

若要部署 Oracle JET Web 應用程式,您可以使用與可在特定環境中部署任何其他從屬端介面相同的方法。

您使用 Oracle JET 命令行介面建立的 Web 應用程式包含一個掛鉤命令檔樣板檔案的資料夾,可供您用來定義組建處理作業的新步驟。例如,您可以建立鉤點命令檔,將 Web 應用程式 /web 資料夾存檔為 ZIP 檔案或 WAR 檔案。此 after_build 命令檔會在建立處理作業完成後執行。

本教學課程不說明相依於特定環境與平台的部署步驟。

目標

完成此教學課程時,您將學會如何將 Web 應用程式的 /web 資料夾存檔為 ZIP 檔案或 WAR 檔案。您也將瞭解如何將 Web 應用程式修改為在 Oracle JET App 建置程序自動化。

必要條件

作業 1:建立 after_build 鉤點命令檔

您可以使用您修改的內建掛鉤命令檔樣板檔案來建立 after_build 鉤點命令檔。

  1. 瀏覽至 JET_Web_Application/scripts/hooks 目錄,然後在編輯器中開啟 after_build.js 鉤點命令檔範本檔案。

  2. 複製 after-js.txt 程式碼片段,並以複製的程式碼片段取代範本檔案的內容。

作業 2:修改 after_build 鉤點命令檔

修改鉤點命令檔,指定您要為 Web 應用程式產生的存檔檔案類型。鉤點命令檔使用相同的壓縮方法來建立壓縮檔案和 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:以核發模式建立應用模組

當您在發行模式下建立 Web 應用程式時,build --release 指令會以精簡的版本取代 /web/ 資料夾中程式庫和命令檔的開發版本。建置程序完成後,建置就會執行 after_build 鉤點命令檔並封存 /web 資料夾的內容。

  1. 開啟終端機視窗,變更為 JET_Web_Application 目錄,然後安裝 archiver npm 套裝軟體。

    $ npm install archiver
    

    這會在 JET_Web_Application 專案中安裝 archiver npm 套裝軟體。after_build.js 鉤點會使用此套件來封存您的 Web App。

  2. 開啟終端機視窗,變更為 JET_Web_Application 目錄,然後在發行模式下建立 Web 應用程式。

    $ ojet build web --release
    

    建置程序會觸發位於 /scripts/hooks 目錄中的鉤點命令檔,需要幾分鐘的時間才能完成。

  3. 等待確認。

    . . .
    Running after_build hook.
    Success: Build finished.
    Files were successfully archived.
    
  4. 瀏覽至 JET_Web_Application 目錄,並尋找 hook 命令檔產生的存檔檔案。例如,如果您修改 after_build 鉤點命令檔來產生名為 my-archive.war 的 WAR 檔案,應用程式根目錄資料夾中就會顯示該名稱的 WAR 檔案。

    Oracle JET Web 應用程式根資料夾中的 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