AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 教程：设置 WorkSpaces 应用程序以用于 Rocket Enterprise Analyzer 和 Rocket
AWS 大型机现代化通过 Amazon WorkSpaces 应用程序提供了多种工具。 WorkSpaces Applications 是一项完全托管的安全应用程序流服务，允许您在不重写应用程序的情况下将桌面应用程序流式传输给用户。 WorkSpaces 应用程序使用户可以即时访问他们需要的应用程序，并在他们选择的设备上提供响应灵敏、流畅的用户体验。使用 WorkSpaces 应用程序托管特定于运行时引擎的工具，使客户应用程序团队能够直接通过其网络浏览器使用这些工具，与存储在 Amazon S3 存储桶或存储库中的应用程序文件进行交互。 CodeCommit
有关 WorkSpaces 应用程序中浏览器支持的信息，请参阅《*亚马逊 WorkSpaces 应用程序管理指南》*中的 “[系统要求和功能支持（Web 浏览器）](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html)”。如果您在使用 WorkSpaces 应用程序时遇到问题，请参阅《*Amazon WorkSpaces 应用程序管理指南》*中的 [ AppStream2.0 用户问题疑难解答](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html)。
本文档适用于客户运营团队的成员。它描述了如何设置 Amazon A WorkSpaces pplications 队列和堆栈来托管用于 AWS 大型机现代化的火箭企业分析器和火箭企业开发者工具。Rocket Enterprise Analyzer 通常在评估阶段使用，Rocket Enterprise Developer 通常在 AWS 大型机现代化方法的迁移和现代化阶段使用。如果您计划同时使用 Enterprise Analyzer 和 Enterprise Developer，则必须为每个工具创建单独的实例集和堆栈。每个工具都需要各自的实例集和堆栈，因为它们的许可条款不同。
**重要**
本教程中的步骤基于可下载的 CloudFormation 模板 [cfn-m2-.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)。appstream-fleet-ea-ed
**Topics**
+ [先决条件](#tutorial-aas-prerequisites)
+ [步骤 1：获取 WorkSpaces 应用程序镜像](#tutorial-aas-step1)
+ [第 2 步：使用 CloudFormation 模板创建堆栈](#tutorial-aas-step2)
+ [步骤 3：在 “ WorkSpaces 应用程序” 中创建用户](#tutorial-aas-step3)
+ [步骤 4：登录 WorkSpaces 应用程序](#tutorial-aas-step4)
+ [步骤 5：验证 Amazon S3 中的存储桶（可选）](#tutorial-aas-step5)
+ [后续步骤](#tutorial-aas-next-steps)
+ [清理 资源](#tutorial-aas-cleanup)
## 先决条件
+ 下载模板：[cfn-m2-appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml)。
+ 获取您的默认 VPC 的 ID 和安全组。有关默认 VPC 的更多信息，请参阅 *Amazon VPC 用户指南 VPCs*中的[默认](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html)。有关默认安全组的更多信息，请参阅《Amazon EC2 用户指南》**中的[默认和自定义安全组](https://docs.aws.amazon.com/AWSEC2/latest/UserGuide/default-custom-security-groups.html)。
+ 请确保您具有以下权限：
+ 在应用程序中创建堆栈、队列和用户。 WorkSpaces
+ CloudFormation 使用模板创建堆栈。
+ 在 Amazon S3 中创建存储桶和并将文件上传到存储桶
+ 从 IAM 下载凭证（`access_key_id` 和 `secret_access_key`）。
## 步骤 1：获取 WorkSpaces 应用程序镜像
在此步骤中，您将与您的 AWS 账户共享 Enterprise Analyzer 和企业开发人员的 WorkSpaces 应用程序映像。
1. 打开 AWS 大型机现代化控制台，网址为[https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/)。
1. 在左侧导航中，选择**工具**。
1. 在**分析、开发和生成资产**中，选择**与我的 AWS 账户共享资产**。
## 第 2 步：使用 CloudFormation 模板创建堆栈
在此步骤中，您将使用下载的 CloudFormation 模板创建用于运行 Rocket Enterprise Analyzer 的 WorkSpaces 应用程序堆栈和队列。您可以稍后重复此步骤来创建另一个 WorkSpaces 应用程序堆栈和队列来运行 Rocket Enterprise Developer，因为每个工具都需要自己的队列和 WorkSpaces 应用程序中的堆栈。有关 CloudFormation 堆栈的更多信息，请参阅《*AWS CloudFormation 用户*指南》中的[使用堆栈](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html)。
**注意**
AWS 大型机现代化在企业分析器和企业开发人员使用的标准 WorkSpaces 应用程序定价基础上增加了额外费用。有关更多信息，请参阅 [AWS Mainframe Modernization 定价](https://aws.amazon.com/mainframe-modernization/pricing/)。
1. 如有必要，请下载 [cfn-m2-appstream-fleet-ea-ed .yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 模板。
1. 打开 CloudFormation 控制台，选择**创建堆栈**并**使用新资源（标准）**。
1. 在**先决条件 – 准备模板**中，选择**模板已就绪**。
1. 在**指定模板**中，选择**上传模板文件**。
1. 在**上传模板文件中，选择**选择文件****并上传 [cfn-m2-appstream-fleet-ea-ed .ym](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) l 模板。
1. 选择**下一步**。
![\[使用选定的 cfn-m2-appstream-fleet-ea-ed .yml 模板 CloudFormation 创建堆栈页面。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/cfn-create-stack.png)
1. 在**指定堆栈集详细信息**页面上，输入以下信息：
+ 在**堆栈名称**中，输入您所选的名称。例如 **m2-ea**。
+ 在中 **AppStreamApplication**，选择 **ea**。
+ 在中 **AppStreamFleetSecurityGroup**，选择默认 VPC 的默认安全组。
+ 在中 **AppStreamFleetVpcSubnet**，选择默认 VPC 内的子网。
+ 在中 **AppStreamImageName**，选择以开头的图像`m2-enterprise-analyzer`。此镜像包含当前支持的 Rocket Enterprise Analyzer 工具版本。
+ 接受其他字段的默认值，然后选择**下一步**。
![\[“ CloudFormation 指定堆栈详细信息” 页面，其中填写了 “企业分析器” 选项。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/cfn-specify-stack-details.png)
1. 接受所有默认值，然后选择**下一步**。
1. 在**审核**页面上，确保所有参数都符合您的预期。
1. 滚动到底部，选择**我确认 AWS CloudFormation 可能使用自定义名称创建 IAM 资源**，然后选择**创建堆栈**。
创建堆栈和实例集需要 20 到 30 分钟。您可以选择 “**刷新**” 以在 CloudFormation 事件发生时查看事件。
## 步骤 3：在 “ WorkSpaces 应用程序” 中创建用户
在等待 CloudFormation 堆栈创建完成时，可以在 WorkSpaces 应用程序中创建一个或多个用户。这些用户是将在 WorkSpaces 应用程序中使用企业分析器的用户。您需要为每个用户指定一个电子邮件地址，并确保每个用户都有足够的权限在 Amazon S3 中创建存储桶、将文件上传到存储桶以及链接到存储桶以映射其内容。
1. 打开 WorkSpaces 应用程序控制台。
1. 在左侧导航窗格中，选择 **用户池**。
1. 选择**创建用户**。
1. 提供一个电子邮件地址，用户可以在其中收到使用 WorkSpaces 应用程序的电子邮件邀请、名字和姓氏，然后选择 C **reate user**。
1. 如有必要，请重复此步骤以创建更多用户。每个用户的电子邮件地址必须是唯一的。
有关创建 WorkSpaces 应用程序用户的更多信息，请参阅《*Amazon WorkSpaces 应用程序管理指南》中的 WorkSpaces 应用程序*[用户池](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html)。
创建 CloudFormation 完堆栈后，您可以将创建的用户分配给堆栈，如下所示：
1. 打开 WorkSpaces 应用程序控制台。
1. 选择用户名。
1. 依次选择**操作**和**分配堆栈**。
1. 在**分配堆栈**中，选择以 `m2-appstream-stack-ea` 开头的堆栈。
1. 选择**分配堆栈**。
![\[“ WorkSpaces 应用程序分配堆栈” 页面显示了用户和要分配的 Enterprise Analyzer 堆栈。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/aas-assign-stack.png)
将用户分配到堆栈会使 WorkSpaces 应用程序通过您提供的地址向该用户发送电子邮件。此电子邮件包含指向 WorkSpaces 应用程序登录页面的链接。
## 步骤 4：登录 WorkSpaces 应用程序
在此步骤中，您将使用 WorkSpaces 应用程序发送给您在中创建的用户的电子邮件中的链接登录 WorkSpaces 应用程序[步骤 3：在 “ WorkSpaces 应用程序” 中创建用户](#tutorial-aas-step3)。
1. 使用 WorkSpaces 应用程序发送的电子邮件中提供的链接登录 WorkSpaces 应用程序。
1. 如果出现提示，请更改密码。您看到的 “ WorkSpaces 应用程序” 屏幕类似于以下内容：
![\[显示桌面图标的示例 WorkSpaces 应用程序登录屏幕。\]](http://docs.aws.amazon.com/zh_cn/m2/latest/userguide/images/aas-login-screen.png)
1. 选择**桌面**。
1. 在任务栏上，选择**搜索**，然后输入 **D:** 以导航到主文件夹。
**注意**
如果跳过此步骤，则在尝试访问主文件夹时可能会出现`Device not ready`错误。
在任何时候，如果您在登录 WorkSpaces 应用程序时遇到问题，都可以按照以下步骤重新启动 WorkSpaces 应用程序群并尝试重新登录。
1. 打开 WorkSpaces 应用程序控制台。
1. 在左侧导航窗格中，选择**实例集**。
1. 选择您要使用的实例集。
1. 选择**操作**，然后选择**停止**。
1. 等待实例集停止。
1. 选择**操作**，然后选择**启动**。
此过程大约需要 10 分钟。
## 步骤 5：验证 Amazon S3 中的存储桶（可选）
您用于创建堆栈的 CloudFormation 模板完成的任务之一是在 Amazon S3 中创建两个存储桶，这两个存储桶是跨工作会话保存和恢复用户数据和应用程序设置所必需的。这些存储桶如下所示：
+ 名称以 `appstream2-` 开头。此存储桶将数据映射到 WorkSpaces 应用程序中的主文件夹 (`D:\PhotonUser\My Files\Home Folder`)。
**注意**
对于给定的电子邮件地址，主文件夹是唯一的，并且在给定帐户中的所有舰队和堆栈之间共享。 AWS 主文件夹的名称是用户电子邮件地址的 SHA256 哈希值，存储在基于该哈希值的路径上。
+ 名称以 `appstream-app-settings-` 开头。此存储桶包含 WorkSpaces 应用程序的用户会话信息，并包括浏览器收藏夹、IDE 和应用程序连接配置文件以及用户界面自定义等设置。有关更多信息，[请参阅《*Amazon 应用程序管理指南》中的 WorkSpaces 应用程序*设置持久性工作原理](https://docs.aws.amazon.com/appstream2/latest/developerguide/how-it-works-app-settings-persistence.html)。
要验证存储桶是否已创建，请执行以下步骤：
1. 打开 Amazon S3 控制台。
1. 在左侧导航中，选择**存储桶**。
1. 在**按名称查找存储桶**中，输入 **appstream** 以筛选列表。
如果您看到存储桶，则无需采取进一步的操作。请注意存储桶存在即可。如果您没有看到存储桶，则可能是 CloudFormation 模板未完成运行，或者发生了错误。转到 CloudFormation 控制台并查看堆栈创建消息。
## 后续步骤
现在， WorkSpaces 应用程序基础架构已设置完毕，您可以设置并开始使用 Enterprise Analyzer。有关更多信息，请参阅 [教程：在 WorkSpaces 应用程序上设置企业分析器](set-up-ea.md)。您还可以设置 Enterprise Developer。有关更多信息，请参阅 [教程：在 WorkSpaces 应用程序上设置 Rocket 企业开发人员](set-up-ed.md)。
## 清理 资源
创建[ WorkSpaces 应用程序队列和堆栈中描述了清理已创建堆栈和队列的](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html)过程。
删除 WorkSpaces 应用程序对象后，账户管理员还可以根据需要清理 Amazon S3 存储桶中的应用程序设置和主文件夹。
**注意**
给定用户的主文件夹在所有队列中都是唯一的，因此，如果同一账户中的其他 WorkSpaces 应用程序堆栈处于活动状态，则可能需要保留该文件夹。
最后， WorkSpaces 应用程序目前不允许您使用控制台删除用户。而是必须使用服务 API 和 CLI 进行删除。有关更多信息，请参阅《*Amazon WorkSpaces 应用程序[管理指南》中的用户池](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html)管理*。