AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。 本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。 # 教程：为大型机的 Tr AWS ansform 设置托管运行时 您可以使用本教程中指定的演示应用程序将 Transf AWS orm for AWS 大型机现代化应用程序部署到大型机现代化运行时环境中。 **Topics** + [先决条件](#tutorial-runtime-ba-prerequisites) + [步骤 1：上传演示应用程序](#tutorial-runtime-ba-step1) + [步骤 2：创建应用程序定义](#tutorial-runtime-ba-step2) + [步骤 3：创建运行时环境](#tutorial-runtime-ba-step3) + [步骤 4：创建 应用程序](#tutorial-runtime-ba-step4) + [步骤 5：部署应用程序](#tutorial-runtime-ba-step5) + [步骤 6：启动应用程序](#tutorial-runtime-ba-step6) + [步骤 7：访问应用程序](#tutorial-runtime-ba-step7) + [步骤 8：测试应用程序](#tutorial-runtime-ba-test) + [清理 资源](#tutorial-runtime-ba-clean) ## 先决条件 要完成本教程，请下载演示应用程序档案 [PlanetsDemo-v4.zip](https://d2azvcayevmroy.cloudfront.net/tutorials/bluage/PlanetsDemo-v4.zip)。 需要使用现代浏览器才能访问正在运行的演示应用程序。您是在桌面上还是从 Amazon Elastic Compute Cloud 实例（例如，在 VPC 内）运行此浏览器，决定了您的安全设置。 ## 步骤 1：上传演示应用程序 将演示应用程序上传到 Amazon S3 存储桶。请确保此存储桶与您要部署的应用程序位于相同的 AWS 区域 。以下示例显示了一个名为 p **lanets-demo** 的存储桶，其密钥前缀或文件夹名为 v1，存档名为 **v1**。`planetsdemo-v4.zip` ![\[Amazon S3 中显示了 v1 前缀和 planetsdemo-v4.zip 文件的 PlanetsDemo 存储桶。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/s3-ba-bucket.png) **注意** 存储桶中的文件夹是必需的。 ## 步骤 2：创建应用程序定义 要将应用程序部署到托管运行时，您需要一个 AWS 大型机现代化应用程序定义。此定义是一个描述应用程序位置和设置的 JSON 文件。以下示例是演示应用程序的应用程序定义： ``` { "template-version": "2.0", "source-locations": [{ "source-id": "s3-source", "source-type": "s3", "properties": { "s3-bucket": "planets-demo", "s3-key-prefix": "v1" } }], "definition": { "listeners": [{ "port": 8196, "type": "http" }], "ba-application": { "app-location": "${s3-source}/PlanetsDemo-v4.zip" } } } ``` 将`s3-bucket`条目更改为示例应用程序 zip 文件的名称（例如`planets-demo`），将`app-location`条目更改为存储示例应用程序 zip 文件的 S3 路径（例如`${s3-source}/PlanetsDemo-v4.zip`）。 **注意** 请务必在本地以文本文件形式创建应用程序定义文件。 有关应用程序定义的更多信息，请参阅 [AWS 大型机应用程序的转换定义示例](applications-m2-definition.md#applications-m2-definition-ba)。 ## 步骤 3：创建运行时环境 要创建 AWS 大型机现代化运行时环境，请执行以下步骤： 1. 使用 [AWS Mainframe Modernization 控制台](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing)。 1. 在 AWS 区域 选择器中，选择要在其中创建环境的区域。这 AWS 区域 必须与您在其中创建 S3 存储桶的区域相匹配[步骤 1：上传演示应用程序](#tutorial-runtime-ba-step1)。 1. **在 “**大型机应用程序现代化**” 下，选择 “**使用 AWS Transform 进行大型机重构**”，然后选择 “开始”。** ![\[“对大型机应用程序进行现代化改造” 部分，其中包含选定的大型机重构 AWS 转换。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-get-started.png) 1. 在 **AWS Mainframe Modernization 如何帮助您**下，选择**部署**和**创建运行时环境**。 ![\[“您想如何开始 AWS 大型机现代化” 部分，并选择部署和创建运行时环境。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/update-m2-ba-deploy-create-env.png) 1. 在左侧导航中，选择**环境**，然后选择**创建环境**。在**指定基本信息**页面上，输入您的环境的名称和描述，然后确保选择 **AWS Blu Age** 引擎。您可以选择向创建的资源添加标签。然后选择**下一步**。 ![\[AWS 大型机现代化指定基本信息页面，其中选择了大型机 AWS 转换引擎。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-env-basic.png) 1. 在**指定配置**页面上，选择**独立运行时环境**。 ![\[已选择独立运行时环境的 “ AWS 大型机现代化可用性” 部分。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-config-avail.png) 1. 在**安全和网络**下，进行以下更改： + 选择**允许部署到此环境的应用程序可公开访问**。此选项为应用程序分配一个公有 IP 地址，以便您可以从桌面访问它。 + 选择 VPC。您可以使用**默认值**。 + 选择两个子网。确保子网允许分配公有 IP 地址。 + 选择安全组。您可以使用**默认值**。请确保您所选的安全组允许从浏览器 IP 地址访问您在应用程序定义的 `listener` 属性中指定的端口。有关更多信息，请参阅 [步骤 2：创建应用程序定义](#tutorial-runtime-ba-step2)。 ![\[“安全和网络”部分（选中了默认 VPC 和两个子网）。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-security-network.png) 如果要从所选 VPC 的外部访问应用程序，请确保已正确配置该 VPC 的入站规则。有关更多信息，请参阅 [错误故障排除：无法访问应用程序 URL](both-application-connectivity.md)。 1. 选择**下一步**。 1. 在**附加存储 – 可选**中，保留默认选项，然后选择**下一步**。 ![\[“附加存储”页面（应用了默认值）。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-attach-storage.png) 1. 在**计划维护**中，选择**无首选项**，然后选择**下一步**。 1. 在**审核并创建**中，审核信息，然后选择**创建环境**。 ## 步骤 4：创建 应用程序 1. 在 AWS 管理控制台中导航到 **AWS Mainframe Modernization**。 1. 在导航窗格中，选择**应用程序**，然后选择**创建应用程序**。在**指定基本信息**页面上，输入应用程序的名称和描述，并确保已选择**适用于大型机的 AWS AWS Tran** sform 引擎。然后选择**下一步**。 ![\[应用程序 “指定基本信息” 页面，其中选定了 “大型机 AWS 转换” 引擎。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-app-basic.png) 1. 在**指定资源和配置**页面上，复制并粘贴在[步骤 2：创建应用程序定义](#tutorial-runtime-ba-step2)中创建的更新的应用程序定义 JSON。 ![\[“资源和配置”部分（已粘贴更新后的应用程序定义 JSON）。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-resources-configs.png) 1. 在**审核和创建**中，审核您的选择，然后选择**创建应用程序**。 **注意** 如果您的应用程序创建失败，请检查您输入的 S3 路径，因为该路径区分大小写。 ## 步骤 5：部署应用程序 成功创建 AWS 大型机现代化运行时环境和应用程序，并且两者都处于 “**可用**” 状态后，就可以将应用程序部署到运行时环境中。为此，请完成以下步骤： 1. 在 AWS 管理控制台中导航到 **AWS 大型机现代化**。在导航窗格中，选择**环境**。随后显示环境列表页面。 ![\[AWS 大型机现代化运行时环境列表。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-environments.png) 1. 选择之前创建的运行时环境。随后显示环境详细信息页面。 1. 选择**部署应用程序**。 ![\[环境的环境详细信息页面。 planets-demo-env\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-env-details-planets.png) 1. 选择前面创建的应用程序，然后选择要将应用程序部署到的版本。然后选择**部署**。 ![\[显示了 planets 演示应用程序的 “ AWS 大型机现代化部署” 应用程序页面。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-app-deploy.png) 1. 等待直到应用程序完成部署。您将看到一条横幅，带有消息**已成功部署应用程序**。 ## 步骤 6：启动应用程序 1. 导航到 “**AWS 大型机现代化**”， AWS 管理控制台 然后选择 “**应用程序**”。 1. 选择您的应用程序，然后转到**部署**。应用程序的状态应为**成功**。 ![\[AWS 大型机现代化部署页面显示部署状态为 “成功”。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/m2-ba-app-deployments-succeeded.png) 1. 选择**操作**，然后选择**启动应用程序**。 ## 步骤 7：访问应用程序 1. 等待直到应用程序处于**正在运行**状态。您将看到一条横幅，带有消息**已成功启动应用程序**。 1. 复制应用程序 DNS 主机名。您可以在应用程序的**应用程序信息**部分中找到此主机名。 1. 在浏览器中，导航到 `http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/`，其中： + `hostname` 是之前复制的 DNS 主机名。 + `portname` 是您在[步骤 2：创建应用程序定义](#tutorial-runtime-ba-step2)中创建的应用程序定义中定义的 Tomcat 端口。 随后显示 JICS 屏幕。 ![\[JICS“事务启动器”页面。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/ba-jics-launcher.png) 如果您无法访问应用程序，请参阅[错误故障排除：无法访问应用程序 URL](both-application-connectivity.md)。 **注意** 如果应用程序不可访问，并且安全组的入站规则在端口 8196 上选择了 “我的 IP”，请指定规则以允许端口 8196 i/p 上来自 LB 的流量。 ## 步骤 8：测试应用程序 在此步骤中，在迁移的应用程序中运行事务。 1. 在 JICS 屏幕上的输入字段中输入 `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) 您可以看到有关该行星的详细信息。 ## 清理 资源 如果您不再需要为本教程创建的资源，请将其删除，以免产生额外费用。为此，请完成以下步骤： + 如果 AWS 大型机现代化应用程序仍在运行，请将其停止。 + 删除应用程序。有关更多信息，请参阅 [删除 AWS Mainframe Modernization 应用程序](applications-m2-delete.md)。 + 删除运行时环境。有关更多信息，请参阅 [删除 AWS 大型机现代化运行时环境删除运行时环境](delete-environments-m2.md)。