設定、部署及測試 Web 應用程式

將 Web 應用程式匯入 Oracle Visual Builder Studio

Oracle Visual Builder Studio 不僅用於開發 Visual Builder 應用程式，還允許開發任何類型的現代化應用程式，這取決於它的各種整合開發工具，例如 GIT 儲存庫、CI/CD 管線引擎、構件產生、容器儲存庫、敏捷工具、團隊建構工具等。

登入 Oracle Cloud Web 主控台導覽功能表，前往 OCI Classic 服務，然後按一下開發人員。
按一下 Oracle Visual Builder Studio 執行處理圖示，然後按一下存取服務執行處理。

附註：
如果沒有現有的執行處理，請建立新執行處理，等待執行處理建立後再存取。儲存此 Visual Builder Studio 執行處理的 URL，因為將會用於後續步驟。
若要建立新專案，請按一下預設頁面 (組織) 中的 + 建立。
輸入專案名稱，然後按下一步。
將匯入現有的 Visual Builder 應用程式作為專案樣板時，請選取空白專案選項，然後按下一步。
在精靈的最後一個畫面中，保留預設的 Wiki 標記語言，然後按一下完成。新專案約會在 5 分鐘內建立。
專案建立之後，將會顯示專案的主要頁面。在匯入應用程式之前，我們需要有一個環境來設定和暫時執行應用程式。按一下建立環境。
輸入環境名稱、描述，然後按一下建立。
如果租用戶中已經有 Visual Builder 執行處理，請按一下新增執行處理，將它新增至此環境。如果您沒有任何 Visual Builder 執行處理，請啟動設定一個執行處理，然後返回此步驟將執行處理新增至環境。
選取您的 Visual Builder 執行處理，然後按一下新增。
將環境新增至專案後，請建立 Workspace，以便匯入預先建立的 Web 應用程式。選取左側導覽功能表中的工作區功能表選項。
您可以將 Visual Builder Web 應用程式匯入專案來建立工作區。按一下匯入。
在精靈中，提供下列詳細資訊：
- 預先建立之 Visual Builder Web 應用程式的壓縮檔。
- 工作區的名稱。
- 選取先前在專案中設定的環境，以用於測試應用程式。
- 建立新的空白 Git 儲存區域，並指定名稱和預設分支名稱。
按一下匯入。

設定 Web 應用程式以指向您的區塊鏈執行處理

在本節中，我們將設定提供的 Web 應用程式指向上一節中建立的區塊鏈執行處理。

請記下您所建立區塊鏈網路的下列資訊：

BC 端點
執行處理名稱
Channel
鏈碼

存取 Visual Builder Studio 執行處理，並在存取 Visual Builder Studio 時，從您登陸 (組織) 的預設頁面按一下專案名稱，以開啟您所建立的專案。
選取您在匯入 Web 應用程式時建立的工作區，然後選取 Web 應用程式，如下列影像與步驟所示。

oci-vbs.png 圖解描述
1. 選取 Web 應用程式區段。
2. 選取 Web 應用程式。
移至變數頁籤，然後按一下每個變數之「預設值」屬性右上角的 f (x) 符號，變更變數 bcEndpoint、bcInstance、chaincode 和 channel 的預設值。

設定 Web 應用程式以指向您的物件儲存的儲存桶

在此區段中，我們將根據您之前建立的 API 金鑰和儲存桶值，設定 Web 應用程式所使用的物件儲存的儲存桶。

存取 Visual Builder Studio 執行處理，並在存取 Visual Builder Studio 時，從您登陸 (組織) 的預設頁面按一下專案名稱，以開啟您所建立的專案。
選取服務連線段落，然後選取 fileUpload 服務連線。
移至伺服器頁籤，然後在伺服器組態的右側，按一下鉛筆圖示以變更 fileUpload 服務連線的組態。
用來與儲存桶互動的「服務連線」組態必須在三個地方進行調整。
在編輯伺服器畫面中，更新下列欄位：
- 執行處理 URL ：必須將它變更為根據 OCI 租用戶的一些特性指向您的儲存桶，以及您在建立儲存桶時提供給該儲存桶的名稱。URL 必須根據下列 URL 範本組成：
```
https://objectstorage.<region-name>.oraclecloud.com/n/<storage-namespace>/b/<bucket-name>
```
- 認證：您必須確定認證方法設為 Oracle Cloud Infrastructure API Signature 1.0 ，而且按一下金鑰 ID 特性右邊的「鉛筆」圖示即可設定金鑰。
  附註：
  金鑰 ID 是根據下列範本所組成：
```
<Tenancy-OCID>/<User-OCID>/<Key-Fingerprint>
```
  您可以在 OCI 儲存桶儲存組態期間建立 API 金鑰時，從取得的組態檔預覽存取所有這些值。私密金鑰指的是建立 API 金鑰時所使用或產生或下載的私密金鑰 (視選取的選項而定)。
- 連線類型：必須設為動態，服務支援 CORS 。
只要這三個特性已根據您的儲存桶和 API 金鑰正確設定，Web 應用程式就可以完全與儲存的儲存桶互動。您可以繼續測試您的「Web 應用程式」。

測試您的 Web 應用程式

您現在可以從專案中設定的 Visual Builder 環境測試應用程式。如果一切都正常運作，我們可以向前移動並匯出要部署到獨立組態的 Web 應用程式。

此 Web 應用程式會與解決方案中使用的兩個後端互動：用於儲存資料夾和文件中繼資料的區塊鏈，以及用於文件內容的 OCI 儲存桶。因此，我們將測試一些功能，確保後端 (區塊鏈和儲存桶) 可透過 Web 應用程式存取。

若要測試應用程式，請按一下 Visual Studio Workspace 右上角的「預覽」圖示。
以資料夾管理員身分登入應用程式，使用者將能夠存取他們目前擁有者的資料夾，或建立新資料夾，他們將成為目前託管人、新增更多文件至資料夾，或將整個資料夾移轉至其他使用者或部門。
讓我們嘗試建立資料夾並將文件上傳至該資料夾。
以其中一個使用者 (cmsleg001 、cmsfin001 或 cmsrsk001) 的身分登入，確保角色設定為資料夾管理員，然後按一下登入。
在資料夾管理頁面中，按一下新建資料夾。
將值指派給三個輸入欄位 ( 資料夾類型、描述和客戶 ID)，然後按一下建立資料夾。
在 Oracle Blockchain Service 主控台中，瀏覽至通道頁籤，選取 wedocms 通道，然後檢查上次儲存至分類帳區塊的內容。它應該包含執行剛執行之交易的要求。
若要測試是否可以將文件上傳至新建立的資料夾，請選取資料夾，然後按一下上傳文件。
如果此資料夾中未上傳任何文件，請按一下上傳新文件。
選取文件類型，輸入文件名稱，選取檔案或將 PDF 檔案放入拖放區域，新增動態特性，然後按一下上傳文件。

如果已執行這項新交易，也可以在 Oracle Blockchain 主控台中複查文件是否已上傳到 OCI 儲存的儲存桶。以文件審查者身分登入，任何可存取應用程式的使用者都能夠複查從任何資料夾上傳的文件。

匯出要在獨立機器中執行的應用程式

下列步驟描述如何匯出應用程式，以及下載要在 Visual Builder 之外部署的可匯出套裝程式。

Visual Builder 應用程式若符合某些條件，可在 Visual Builder 的相關資訊環境之外執行。如需詳細資訊，請參閱下列部落格：在其他伺服器上執行 Visual Builder 應用程式 (和內部部署) 和在 Visual Builder 之外執行 Visual Builder 應用程式。

若要匯出應用程式，請將變更植入「Git 儲存區域」。按一下工作區左上方的 Git 儲存區域 / 分支功能表，然後選取推送選項。
輸入確認訊息，然後按一下全部確認並發送。
第一次執行此工作時，等待組建執行程式可能需要數分鐘的時間，但組建執行程式挑選工作之後，應該在約 3 分鐘內執行，並且應該顯示 Git 推送成功的即現式訊息。
此時，我們可以發布應用軟體，此操作將觸發建構工作，使應用軟體在最佳條件下執行最佳化。按一下「工作區」頁面右上角的發布。
在發布變更對話方塊中，選取立即合併或複查後合併，然後按一下發布。
輸入您的證明資料，然後按一下新增證明資料並繼續。
在組建已開始即現式視窗中，按一下開啟工作。
按一下物件以檢視產生的套件。
按一下 built-assets.zip 以下載套裝程式，即可在 Visual Builder 之外部署可匯出的套裝程式。

將匯出的套裝程式執行至 Apache Tomcat 伺服器

built-assets.zip 套裝軟體可以部署成由 Apache Tomcat Server 直接提供服務。

安裝 Apache Tomcat Server 後，請啟動它並嘗試存取 URL 來檢查它是否正常運作： http://localhost:8080。
我們的應用程式可以透過解壓縮 built-assets.zip 套裝軟體的方式安裝在 Tomcat 中，並將壓縮的內容複製到 /webapps 資料夾內建立的新資料夾中。
在 Tomcat 安裝的 webapps 資料夾中部署應用程式之後，我們可以重新啟動 Tomcat，並嘗試存取下列 URL： http://localhost:8080/<folder-name-inside-webapps>/webApps/docmngmt/
現在，我們可以在本機環境中測試應用程式。