AWS 大型机现代化服务（托管运行时环境体验）不再向新客户开放。有关类似于 AWS 大型机现代化服务（托管运行时环境体验）的功能，请浏览 AWS 大型机现代化服务（自我管理体验）。现有客户可以继续正常使用该服务。有关更多信息，请参阅[AWS 大型机现代化可用性变更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。
本文属于机器翻译版本。若本译文内容与英语原文存在差异，则一律以英文原文为准。
# 教程：在 WorkSpaces 应用程序上设置 Rocket 企业开发人员
本教程介绍如何为一个或多个大型机应用程序设置 Rocket Enterprise Developer（前身为 Micro Focus Enterprise Developer），以便使用企业开发者功能对其进行维护、编译和测试。该设置基于 AWS 大型机现代化与客户共享的 WorkSpaces 应用程序 Windows 映像，以及 WorkSpaces 应用程序队列和堆栈的创建，如中所述。[教程：设置 WorkSpaces 应用程序以用于 Rocket Enterprise Analyzer 和 Rocket](set-up-appstream-mf.md)
**重要**
本教程中的步骤假设您使用可下载的 CloudFormation 模板 [cfn-m2-](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) .yaml 来设置 WorkSpaces 应用程序。appstream-fleet-ea-ed有关更多信息，请参阅 [教程：设置 WorkSpaces 应用程序以用于 Rocket Enterprise Analyzer 和 Rocket](set-up-appstream-mf.md)。
如果 Enterprise Developer 实例集和堆栈已启动并正在运行时，则必须执行此设置的步骤。
有关企业开发者 v7 功能和交付成果的完整描述，请在 Rocket Softwar [e（前身为 Micro Focus）网站上查看其up-to-date 在线文档 (v7.0)](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html)。
## 映像内容
除了企业开发者本身，该图像还包含包含 Rumba（ TN3270 模拟器）的图像。此外，它还包含以下工具和库。
第三方工具
+ [Python](https://www.python.org/)
+ [Rclone](https://rclone.org/)
+ [pgAdmin](https://www.pgadmin.org/)
+ [git-scm](https://git-scm.com/)
+ [PostgreSQL ODBC 驱动程序](https://odbc.postgresql.org/)
`C:\Users\Public` 中的库
+ BankDemo 企业开发者的源代码和项目定义:`m2-bankdemo-template.zip`.
+ 大型机的 MFA 安装包：`mfa.zip`。有关更多信息，请参阅《Micro Focus Enterprise Developer》**文档中的[大型机访问权限概述](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)。
+ Rclone 的命令和配置文件（教程中的使用说明）：`m2-rclone.cmd` 和 `m2-rclone.conf`。
如果您需要访问尚未加载到 CodeCommit 存储库但在 Amazon S3 存储桶中可用的源代码，例如将源代码初始加载到 git 中，请按照中所述的步骤创建虚拟 Windows 磁盘[教程：在 WorkSpaces 应用程序上设置企业分析器](set-up-ea.md)。
**Topics**
+ [映像内容](#set-up-ed-image-contents)
+ [先决条件](#tutorial-ed-prerequisites)
+ [步骤 1：由个人 Enterprise Developer 用户设置](#tutorial-ed-step1)
+ [步骤 2：在 Windows 上创建基于 Amazon S3 的虚拟文件夹（可选）](#tutorial-ed-step2)
+ [步骤 3：克隆存储库](#tutorial-ed-step3)
+ [后续会话](#tutorial-ed-step4)
+ [清理 资源](#tutorial-ed-clean)
## 先决条件
+ 一个或多个装有待维护应用程序源代码的 CodeCommit 存储库。存储库的设置应符合上述CI/CD管道的要求，以便通过结合使用这两种工具来实现协同效应。
+ 每个用户都必须拥有账户管理员根据 [AWS 的身份验证和访问控制中的信息定义的一个或多个存储库的](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)证书 CodeCommit。 CodeCommit 这些证书的结构在 [AWS CodeCommit 的身份验证和访问控制](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)中进行了审查，IAM 授权的完整[参考见CodeCommit 权限参考](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html)：管理员可以为不同的角色定义不同的 IAM 策略，这些角色具有每个存储库的特定角色的证书，并限制其对用户的授权仅限于他在给定存储库上必须完成的特定任务集。 CodeCommit 因此，账户管理员将为 CodeCommit 仓库的每位维护者生成一个主用户，并通过选择适当的 IAM 访问策略向该用户授予 CodeCommit访问所需一个或多个存储库的权限。
## 步骤 1：由个人 Enterprise Developer 用户设置
1. 获取您的 IAM 凭证：
1. 连接 AWS 控制台，网址为[https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/)。
1. 按照《AWS CodeCommit 用户指南》**中[适用于使用 Git 凭证的 HTTPS 用户的设置](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)的步骤 3 中描述的过程操作。
1. 复制 IAM 为您生成的 CodeCommit特定登录证书，方法是显示、复制这些信息，然后将其粘贴到本地计算机上的安全文件中，或者选择**下载证书将此信息下载**为.CSV 文件。您需要该信息才能连接到 CodeCommit。
1. 根据欢迎电子邮件中收到的网址开始与 WorkSpaces 应用程序的会话。使用您的电子邮件作为用户名并创建密码。
1. 选择您的 Enterprise Developer 堆栈。
1. 在菜单页面上，选择**桌面**以访问实例集正在进行流式传输的 Windows 桌面。
## 步骤 2：在 Windows 上创建基于 Amazon S3 的虚拟文件夹（可选）
如果需要 Rclone（见上文），请在 Windows 上创建基于 Amazon S3 的虚拟文件夹：（如果所有应用程序工件都完全来自访问权限，则可选）。 CodeCommit
**注意**
如果您在 AWS 大型机现代化预览版中已经使用过 Rclone，则必须更新`m2-rclone.cmd`到位于中的较新版本。`C:\Users\Public`
1. 使用文件资源管理器将 `C:\Users\Public` 中提供的 `m2-rclone.conf` 和 `m2-rclone.cmd` 文件复制到您的主文件夹 `C:\Users\PhotonUser\My Files\Home Folder`。
1. 使用您的 AWS 访问密钥和相应的密钥以及您的密钥更新`m2-rclone.conf`配置参数 AWS 区域。
```
[m2-s3]
type = s3
provider = AWS
access_key_id = YOUR-ACCESS-KEY
secret_access_key = YOUR-SECRET-KEY
region = YOUR-REGION
acl = private
server_side_encryption = AES256
```
1. 在 `m2-rclone.cmd` 中，进行以下更改：
+ 将 `amzn-s3-demo-bucket` 更改为您的 Amazon S3 存储桶名称。例如 `m2-s3-mybucket`。
+ 将 `your-s3-folder-key` 更改为您的 Amazon S3 存储桶密钥。例如 `myProject`。
+ 将 `your-local-folder-path` 更改为要从包含应用程序文件的 Amazon S3 存储桶同步应用程序文件的目录路径。例如 `D:\PhotonUser\My Files\Home Folder\m2-new`。此同步目录必须是主文件夹的子目录， WorkSpaces 应用程序才能在会话开始和结束时对其进行正确备份和恢复。
```
:loop
timeout /T 10
"C:\Program Files\rclone\rclone.exe" sync m2-s3:{{amzn-s3-demo-bucket}}/{{your-s3-folder-key}} "D:\PhotonUser\My Files\Home Folder\{{your-local-folder-path}}" --config "D:\PhotonUser\My Files\Home Folder\m2-rclone.conf"
goto :loop
```
1. 打开 Windows 命令提示符，使用 cd 命令切换到 `C:\Users\PhotonUser\My Files\Home Folder`（如果需要），然后运行 `m2-rclone.cmd`。此命令脚本连续循环运行，每 10 秒将您的 Amazon S3 存储桶和密钥同步到本地文件夹。您可以根据需要调整超时。您应该在 Windows 文件资源管理器的 Amazon S3 存储桶中看到该应用程序的源代码。
要将新文件添加到您正在处理的文件集中或更新现有文件，请将文件上传到 Amazon S3 存储桶，这些文件将在 `m2-rclone.cmd` 中定义的下一次迭代中同步到您的目录。同样，如果要删除某些文件，请将其从 Amazon S3 存储桶中删除。下次同步操作会将其从您的本地目录中删除。
## 步骤 3：克隆存储库
1. 导航到浏览器窗口左上角的应用程序选择器菜单，然后选择“Enterprise Developer”。
1. 在您的主文件夹中完成 Enterprise Developer 所需的工作区创建，选择`C:\Users\PhotonUser\My Files\Home Folder`（又或 `D: \PhotonUser\My Files\Home Folder`）作为工作区的位置。
1. 在 Enterprise Developer 中，进入项目资源管理器，右键单击并选择 “**导入****...**”、“Git”、“Git”、“从 **Gi **t**** **Clone URI 中的**项目**” 来克隆 CodeCommit **仓库。然后，输入您的 CodeCommit特定登录凭据并完成 Eclipse 对话框以导入代码。
中的 CodeCommit git 存储库现已克隆到您的本地工作区中。
您的 Enterprise Developer 工作区现已准备就绪，可以开始对您的应用程序进行维护工作。特别是，您可以使用与 Enterprise Developer 集成的本地企业服务器 (ES) 实例以交互方式调试和运行应用程序，以便在本地验证您的更改。
**注意**
本地企业开发人员环境（包括本地企业服务器实例）在 Windows 下运行，而 AWS 大型机现代化则在 Linux 下运行。我们建议您在向 AWS 大型机现代化提供的 Linux 环境中运行补充测试，然后再将新应用程序投入生产。 CodeCommit
## 后续会话
当您选择 WorkSpaces 应用程序管理下的文件夹（例如用于克隆 CodeCommit 存储库的主文件夹）时，该文件夹将在各个会话中透明地保存和恢复。您可以在下次需要使用该应用程序时完成以下步骤：
1. 根据欢迎电子邮件中收到的网址开始与 WorkSpaces 应用程序的会话。
1. 使用您的电子邮件和永久密码登录。
1. 选择 Enterprise Developer 堆栈。
1. 启动 `Rclone` 以连接（见上文）到 Amazon S3 支持的磁盘（如果您使用此选项共享工作区文件）。
1. 启动 Enterprise Developer 来完成工作。
## 清理 资源
如果您不再需要为本教程创建的资源，请将其删除，以免继续产生费用。完成以下步骤：
+ 删除您为本教程创建的 CodeCommit 存储库。有关更多信息，请参阅《*AWS CodeCommit 用户指南》*中的[删除 CodeCommit 存储库](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html)。
+ 删除您为本教程创建的数据库。有关更多信息，请参阅[删除数据库实例](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)。