AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 教程：在应用程序上 WorkSpaces 使用适用于大型机开发人员的 AWS 转换
本教程向您展示了如何在 WorkSpaces 应用程序上访问适用于大型机开发人员的 Tr AWS ansform，并将其与示例应用程序一起使用，以便您可以试用这些功能。完成本教程后，您可以在使用自己的应用程序的情况下，使用相同的步骤进行操作。
**Topics**
+ [步骤 1：创建数据库](#tutorial-ba-developer-create-db)
+ [步骤 2：访问环境](#tutorial-ba-developer-access-env)
+ [步骤 3：设置运行时](#tutorial-ba-developer-set-up-runtime)
+ [步骤 4：启动 Eclipse IDE](#tutorial-ba-developer-start-eclipse)
+ [步骤 5：设置 Maven 项目](#tutorial-ba-developer-set-up-maven)
+ [步骤 6：配置 Tomcat 服务器](#tutorial-ba-developer-config-tomcat)
+ [步骤 7：部署到 Tomcat](#tutorial-ba-developer-deploy-tomcat)
+ [步骤 8：创建 JICS 数据库](#tutorial-ba-developer-create-jics)
+ [步骤 9：启动和测试应用程序](#tutorial-ba-developer-test-app)
+ [步骤 10：部署应用程序](#tutorial-ba-developer-debug)
+ [清理 资源](#tutorial-ba-developer-clean)
## 步骤 1：创建数据库
在此步骤中，使用 Amazon RDS 创建托管 PostgreSQL 数据库，演示应用程序使用该数据库来存储配置信息。
1. 打开 Amazon RDS 控制台。
1. 选择**数据库 > 创建数据库**。
1. 选择**标准创建 > PostgreSQL**，保留默认版本，然后选择**免费套餐**。
1. 选择数据库实例标识符。
1. 对于**凭证设置**，选择**管理 AWS Secrets Manager中的主凭证**。有关更多信息，请参阅《Amazon RDS 用户指南》**中的[使用 Amazon RDS 和 AWS Secrets Manager管理密码](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html)。
1. 确保 VPC 与您用于 WorkSpaces 应用程序实例的 VPC 相同。您可以向管理员询问此值。
1. 对于 **VPC 安全组**，选择**新建**。
1. 将**公共访问**设置为**是**。
1. 保留所有其他默认值。审核这些值。
1. 选择**创建数据库**。
要使数据库服务器可以从您的实例访问，请在 Amazon RDS 中选择数据库服务器。在**连接和安全性**下，为数据库服务器选择 VPC 安全组。此安全组是之前创建的，其描述应与 **RDS 管理控制台创建**的安全组的描述类似。选择**操作 > 编辑入站规则**，选择**添加规则**，然后创建 **PostgreSQL** 类型的规则。对于规则来源，请使用安全组**默认值**。您可以开始在**来源**字段中输入来源名称，然后接受建议的 ID。最后，选择**保存规则**。
## 步骤 2：访问环境
在此步骤中，您将访问 “ WorkSpaces 应用程序” 上的 “大型机 AWS 转换” 开发环境。
1. 请联系您的管理员以获取访问您的 WorkSpaces 应用程序实例的正确方法。有关可能的客户端和配置的一般信息，请参阅《*Amazon WorkSpaces 应用程序管理指南》中的 WorkSpaces 应用程序*[访问方法和客户端](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html)。请考虑使用本机客户端以获得最佳体验。
1. 在 “ WorkSpaces 应用程序” 中选择 “**桌面**”。
## 步骤 3：设置运行时
在此步骤中，您将设置大型机 AWS 转换运行时。您必须在首次启动时设置运行时，如果收到运行时升级的通知，则必须重新设置运行时。此步骤将填充您的 `.m2` 文件夹。
1. 从菜单栏中选择**应用程序**，然后选择**终端**。
1. 输入以下命令：
```
~/_install-velocity-runtime.sh
```
## 步骤 4：启动 Eclipse IDE
在此步骤中，启动 Eclipse IDE 并选择要创建工作区的位置。
1. 在 “ WorkSpaces 应用程序” 中，选择工具栏上的 “启动应用程序” 图标，然后选择 **Eclipse JEE**。
![\[在 “应用程序” 工具栏上启动 “ WorkSpaces 应用程序” 图标。已选择 Eclipse JEE。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/aas-ba-eclipse.png)
1. 启动器打开后，输入要创建工作区的位置，然后选择**启动**。
![\[AWS Transform for mainframe应用程序中的 Eclipse IDE 启动器。 WorkSpaces 已选择“工作区”。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-launcher.png)
您也可以选择通过命令行启动 Eclipse，如下所示：
```
~/eclipse &
```
## 步骤 5：设置 Maven 项目
在此步骤中，为 Planets 演示应用程序导入 Maven 项目。
1. [PlanetsDemo将-pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) 上传到你的主文件夹。您可以使用本机客户端“我的文件”特征来执行此操作。
1. 使用 `unzip` 命令行工具提取文件。
1. 在解压缩后的文件夹中导航，然后在文本编辑器中打开项目的根 `pom.xml`。
1. 编辑该`gapwalk.version`属性，使其与已安装的 Transform fo AWS r 大型机运行时相匹配。
如果不确定安装的版本，请在终端中发出以下命令：
```
cat ~/runtime-version.txt
```
此命令会输出当前可用的运行时版本，例如 `3.1.0-b3257-dev`。
**注意**
请勿在 `gapwalk.version` 中包含 `-dev` 后缀。例如，有效的值可以是 `3.1.0-b3257`。
1. 在 Eclipse 中，选择**文件**，然后选择**导入**。在**导入**对话框窗口中，展开 **Maven**，然后选择**现有的 Maven 项目**。选择**下一步**。
1. 在**导入 Maven 项目**中，提供提取的文件的位置，然后选择**完成**。
您可以放心地忽略以下弹出窗口。Maven 下载 `node.js` 本地副本来构建项目的 Angular (\$1-web) 部分：
![\[“缺少 node.js”的警告消息。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-node-warning.png)
等到构建结束。您可以在**进度**视图中查看构建进度。
1. 在 Eclipse 中，选择项目并选择**运行方式**。然后选择 **安装**。Maven 安装成功后，会在 `PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war` 下创建 `war` 文件。
## 步骤 6：配置 Tomcat 服务器
在此步骤中，配置一个 Tomcat 服务器，用于部署和启动已编译的应用程序。
1. 在 Eclipse 中，选择**窗口 > 显示视图 > 服务器**以显示**服务器**视图：
![\[AWS 在选中 “服务器” 视图的情况下为大型机 Eclipse 进行转换。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-servers.png)
1. 选择**没有可用的服务器。请单击此链接创建新服务器...**。随后将出现**新建服务器**向导。在向导的**选择服务器类型**字段中，输入 **tomcat v9**，并选择 **Tomcat v9.0 服务器**。然后选择**下一步**。
![\[“新建服务器”对话框。已选择“Tomcat v9.0 服务器”。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. 选择**浏览**，然后选择主文件夹根目录下的 **tomcat** 文件夹。保持 JRE 的默认值，然后选择**完成**。
**服务器**项目已在工作区中创建，Tomcat v9.0 服务器现在在**服务器**视图中可用。已编译应用程序将在此处部署和启动：
![\[AWS 大型机 Eclipse 服务器的 “转换” 选项卡，其中列出了新的 Tomcat 服务器。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-server-added.png)
## 步骤 7：部署到 Tomcat
在此步骤中，将 Planets 演示应用程序部署到 Tomcat服务器，以便运行该应用程序。
1. 选择 `PlanetsDemo-web` 文件并选择**运行方式 > Maven 安装**。再次选择 `PlanetsDemo-web` 并选择**刷新**，确保将经 npm 编译的前端正确编译为 .war 并被 Eclipse 注意到。
1. 将 [PlanetsDemo-runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) 上传到实例，然后将文件解压缩到可访问的位置。这样可以确保演示应用程序可以访问所需的配置文件夹和文件。
1. 将 `PlanetsDemo-runtime/tomcat-config` 的内容复制到您为 Tomcat 服务器创建的 `Servers/Tomcat v9.0...` 子文件夹中：
![\[AWS 为大型机 Eclipse Tomcat v9.0 子文件夹及其包含的文件进行转换。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. 在“服务器”视图中打开 `tomcat v9.0` 服务器条目。此时会显示服务器属性编辑器：
![\[服务器属性编辑器。已选择“概览”选项卡。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. 在**概览**选项卡中，将“启动”的**超时**值增加到 450 秒，将“停止”的“超时”值增加到 150 秒，如下所示：
![\[启动超时值设置为 450 秒。停止超时值设置为 150 秒。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. 选择**打开启动配置**。此时将显示向导。在向导中，导航到**参数**文件夹，然后在**工作目录**中选择**其他**。选择**文件系统**，然后导航到之前解压缩的 `PlanetsDemo-runtime` 文件夹。此文件夹应包含一个名为 **config** 的直接子文件夹。
![\[“编辑配置”对话框（已在“其他”字段中指定工作目录）。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. 选择服务器属性编辑器的**模块**选项卡并进行以下更改：
+ 选择**添加 Web 模块**并添加 `PlanetsDemo-service`。
+ 选择**添加外部 Web 模块**。随后显示**添加 Web 模块**对话框窗口。进行以下更改：
+ 在**文档库**中，选择**浏览**并导航至 `~/webapps/gapwalk-application...war`
+ 在**路径**中，输入 `/gapwalk-application`。
+ 选择“确定”。
+ 再次选择**添加外部 Web 模块**并进行以下更改：
+ 对于**文档库**，输入前端 .war 的路径（在 `PlanetsDemo-web/target` 中）
+ 在**路径**，输入 `/demo`
+ 选择“确定”。
+ 保存编辑器修改 (Ctrl \$1 S)。
编辑器内容应类似于以下示例所示。
![\[Tomcat 服务器属性的“Web 模块”选项卡（其中列出了模块）。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## 步骤 8：创建 JICS 数据库
在此步骤中，连接到您在 [步骤 1：创建数据库](#tutorial-ba-developer-create-db) 中创建的数据库。
1. 在 WorkSpaces 应用程序实例中，在终端中发出以下命令进行启动`pgAdmin`：
```
./pgadmin-start.sh
```
1. 选择电子邮件地址和密码作为登录标识符。记录提供的 URL（通常是 http://127.0.0.1:5050）。在实例中启动 Google Chrome，将此 URL 复制并粘贴到浏览器中，然后使用您的标识符登录。
![\[pgAdmin“登录”对话框。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-pgadmin-login.png)
1. 登录后，选择**添加新服务器**，然后按如下方式输入先前创建的数据库的连接信息。
![\[pgAdmin“注册 – 服务器”对话框。已选择“连接”选项卡。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. 连接到数据库服务器时，使用**对象 > 创建 > 数据库**并创建一个名为 **jics** 的新数据库。
1. 编辑演示应用程序使用的数据库连接信息。此信息在 `PlanetsDemo-runtime/config/application-main.yml` 中定义。搜索 `jicsDs` 条目。要检索 `username` 和 `password` 的值，请在 Amazon RDS 控制台中导航到数据库。在**配置**选项卡的**主凭证 ARN** 下，选择**在 Secrets Manager 中管理**。然后，在 Secrets Manager 控制台中，在密钥中选择**检索密钥值**。
## 步骤 9：启动和测试应用程序
在此步骤中，启动 Tomcat 服务器和演示应用程序，以便对其进行测试。
1. 要启动 Tomcat 服务器和先前部署的应用程序，请在“服务器”视图中选择服务器条目，然后选择**启动**。随后将显示控制台，控制台上显示启动日志。
1. 在“服务器”视图中查看**服务器**状态，或者在控制台中等待**服务器在 [xxx] 毫秒后启动**消息。服务器启动后，检查 gapwalk-application 是否已正确部署。为此，请在 Google Chrome 浏览器中访问 **http://localhost:8080/gapwalk-application** URL。您应该看到以下内容。
![\[显示 jics 应用程序正在运行的确认消息。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. 从 Google Chrome 访问已部署的应用程序前端，网址为 http://localhost:8080/demo。随后会出现以下**事务启动器**页面。
![\[JICS“事务启动器”页面。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-jics-launcher.png)
1. 要启动应用程序事务，请在输入字段中输入 `PINQ`，然后选择**运行**（或按 Enter）。
随后会显示演示应用程序屏幕。
![\[插入模式下的 PlanetsDemo 应用程序屏幕。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-demo-app-screen.png)
1. 在相应的字段中键入行星名称，然后按 Enter。
![\[在 “行星名称” 字段中输入了地球的 PlanetsDemo 应用程序屏幕。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-demo-with-data.png)
## 步骤 10：部署应用程序
在此步骤中，使用标准 Eclipse 调试特征进行测试。当您使用经过现代化造的应用程序时，这些特征可用。
1. 要打开主服务类，请按 Ctrl \$1 Shift \$1 T。然后输入 `PlanetsinqProcessImpl`。
![\[已输入的 Eclipse 打开类型对话框窗口。 PlanetsinqProcessImpl\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. 导航到 `searchPlanet` 方法，并在此处放置一个断点。
1. 选择服务器名称并选择**在调试中重新启动**。
1. 重复前述步骤，即访问应用程序，输入行星名称，然后按 Enter。
Eclipse 将在 `searchPlanet` 方法中停止该应用程序。现在，您可以进行检查。
## 清理 资源
如果您不再需要为本教程创建的资源，请将其删除，以免产生额外费用。完成以下步骤：
+ 如果 Planets 应用程序仍在运行，请将其停止。
+ 删除您在 [步骤 1：创建数据库](#tutorial-ba-developer-create-db) 中创建的数据库。有关更多信息，请参阅[删除数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html)。