配置、部署和测试 Web 应用程序

将 Web 应用程序导入 Oracle Visual Builder Studio

Oracle Visual Builder Studio 不仅用于开发 Visual Builder 应用程序，还支持开发任何类型的现代应用程序，这要归功于其丰富的集成开发工具，例如 GIT 资料档案库、CI/CD 管道引擎、构件生成、容器资料档案库、敏捷工具、团队构建工具等。

登录到 Oracle Cloud Web 控制台导航菜单，转到 OCI Classic Services ，然后单击开发人员。
单击 Oracle Visual Builder Studio 实例图标，然后单击访问服务实例。

注意：
如果没有现有实例，请创建一个新实例，等待它被创建，然后访问它。保存此 Visual Builder Studio 实例的 URL，因为它将在后续步骤中使用。
要创建新项目，请在默认页（组织）中单击 + Create 。
输入项目名称，然后单击下一步。
由于我们将导入现有 Visual Builder 应用程序作为项目模板，请选择空项目选项并单击下一步。
在向导的最后一个屏幕中，保留默认的 wiki 标记语言，然后单击完成。新项目将在 5 分钟左右创建。
创建项目后，将显示项目主页。在导入应用程序之前，我们需要有一个环境来配置和临时运行应用程序。单击创建环境。
输入环境名称、说明并单击创建。
如果租户中已存在任何 Visual Builder 实例，请单击添加实例将其添加到此环境中。如果您没有任何 Visual Builder 实例，请预配一个实例并返回到此步骤以将实例添加到环境。
选择 Visual Builder 实例，然后单击添加。
将环境添加到项目后，创建工作区，我们可以在其中导入预先创建的 Web 应用程序。选择左侧导航菜单中的工作区菜单选项。
可以通过将 Visual Builder Web 应用程序导入项目来创建工作区。单击导入。
在向导中，提供以下详细信息：
- 预先创建的 Visual Builder Web 应用程序的 zip 文件。
- 工作区的名称。
- 选择要用于测试应用程序的项目中先前配置的环境。
- 创建新的空 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 Repo/Branch 菜单，然后选择 Push（推送）选项。
输入提交消息，然后单击全部提交并推送。
首次执行此作业时，可能需要几分钟等待构建执行程序，但构建执行程序拾取作业后，应在大约 3 分钟内执行该作业，并且应显示 Git 推送成功的弹出消息。
此时，我们可以发布应用，此操作将触发构建作业，以优化在最佳条件下执行的应用。单击工作区页右上角的发布。
在发布更改对话框中，选择立即合并或复查后合并，然后单击发布。
输入身份证明，然后单击添加身份证明并继续。
在构建已启动弹出窗口中，单击打开作业。
单击对象可查看生成的程序包。
单击 built-assets.zip 下载程序包，以便可导出程序包可以部署到 Visual Builder 外部。

将导出的软件包执行到 Apache Tomcat 服务器中

built-assets.zip 软件包可以部署为由 Apache Tomcat 服务器直接提供服务。

安装 Apache Tomcat Server 后，通过尝试访问 URL 来启动它并检查它是否正常工作： http://localhost:8080。
我们的应用程序可以通过解压缩 built-assets.zip 软件包并将 zip 的内容复制到在 /webapps 文件夹内创建的新文件夹来安装在 Tomcat 中。
在 Tomcat 安装的 webapps 文件夹中部署应用程序后，我们可以重新启动 Tomcat，并尝试访问以下 URL： http://localhost:8080/<folder-name-inside-webapps>/webApps/docmngmt/
现在，我们可以在本地环境中测试应用程序。