教程:在 AppStream 2.0 上设置 Micro Focus Enterprise Developer
本教程介绍如何为一个或多个大型机应用程序设置 Micro Focus Enterprise Developer,以便使用 Enterprise Developer 特征对应用程序进行维护、编译和测试。该设置基于 AWS Mainframe Modernization 与客户共享的 AppStream 2.0 Windows 映像,以及创建的 AppStream 2.0 实例集和堆栈(如教程:设置 AppStream 2.0 以与 Micro Focus Enterprise Analyzer 和 Micro Focus Enterprise Developer 搭配使用中所述)。
重要
本教程中的步骤假设您使用可下载的 AWS CloudFormation 模板 cfn-m2-appstream-fleet-ea-ed.yaml
如果 Enterprise Developer 实例集和堆栈已启动并正在运行时,则必须执行此设置的步骤。
有关 Enterprise Developer v7 特征和交付项的完整描述,请在 Micro Focus 网站上查看其最新在线文档 (v7.0)
映像内容
除了 Enterprise Developer 本身,映像还包含包含 Rumba(TN3270 模拟器)的映像。此外,它还包含以下工具和库。
第三方工具
C:\Users\Public
中的库
-
Enterprise Developer 的 BankDemo 源代码和项目定义:
m2-bankdemo-template.zip
。 -
大型机的 MFA 安装包:
mfa.zip
。有关更多信息,请参阅《Micro Focus Enterprise Developer》文档中的大型机访问权限概述。 -
Rclone 的命令和配置文件(教程中的使用说明):
m2-rclone.cmd
和m2-rclone.conf
。
如果您需要访问尚未加载到 CodeCommit 存储库但在 Amazon S3 存储桶中可用的源代码,例如要将源代码初始加载到 git 中,请按照教程:在 AppStream 2.0 上设置 Enterprise Analyzer 中所述的步骤创建虚拟 Windows 磁盘。
先决条件
-
一个或多个 CodeCommit 存储库,其中加载了待维护的应用程序的源代码。存储库设置应符合上述 CI/CD 管道的要求,以便通过结合使用这两种工具来实现协同效应。
-
每个用户都必须拥有账户管理员根据 AWS CodeCommit 的身份验证和访问控制中的信息定义的凭证,用于访问 CodeCommit 存储库。有关这些凭证的结构,请参阅 AWS CodeCommit 的身份验证和访问控制,有关 CodeCommit 的 IAM 授权的完整参考,请参阅 CodeCommit 权限参考:管理员可以为不同的角色定义不同的 IAM 策略,这些策略具有特定于每个存储库的角色的凭证,并将对用户的授权限制为用户必须在给定存储库上完成的特定任务集。因此,账户管理员将为 CodeCommit 存储库的每位维护者生成一个主用户,并通过选择适用于 CodeCommit 访问的一个或多个 IAM 策略,授予该用户访问所需的一个或多个存储库的权限。
步骤 1:由个人 Enterprise Developer 用户设置
-
获取您的 IAM 凭证:
-
连接到 AWS 控制台,网址为 https://console.aws.amazon.com/iam/
。 -
按照《AWS CodeCommit 用户指南》中适用于使用 Git 凭证的 HTTPS 用户的设置的步骤 3 中描述的过程操作。
-
通过以下两种方式之一复制 IAM 为您生成的 CodeCommit 特定登录凭证:显示这些信息,然后将其复制并粘贴到本地计算机上安全的文件中;或选择下载凭证),将这些信息下载为 .CSV 文件。您需要这些信息才能连接到 CodeCommit。
-
-
根据收到的欢迎电子邮件中的 URL 开始与 AppStream 2.0 的会话。使用您的电子邮件作为用户名并创建密码。
-
选择您的 Enterprise Developer 堆栈。
-
在菜单页面上,选择桌面以访问实例集正在进行流式传输的 Windows 桌面。
步骤 2:在 Windows 上创建基于 Amazon S3 的虚拟文件夹(可选)
如果需要 Rclone(见上文),请在 Windows 上创建基于 Amazon S3 的虚拟文件夹:(如果所有应用程序构件都完全来自 CodeCommit 访问,则为可选)。
注意
如果您在 AWS Mainframe Modernization 预览版中已经使用过 Rclone,则必须将 m2-rclone.cmd
更新到位于 C:\Users\Public
中的较新版本。
-
使用文件资源管理器将
C:\Users\Public
中提供的m2-rclone.conf
和m2-rclone.cmd
文件复制到您的主文件夹C:\Users\PhotonUser\My Files\Home Folder
。 -
使用您的 AWS 访问密钥和相应的密钥以及 AWS 区域来更新
m2-rclone.conf
配置参数。[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
-
在
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
。此同步目录必须是主文件夹的子目录,AppStream 2.0 才能在会话开始和结束时对其进行正确备份和恢复。
: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 -
-
打开 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:克隆存储库
-
导航到浏览器窗口左上角的应用程序选择器菜单,然后选择“Enterprise Developer”。
-
在您的主文件夹中完成 Enterprise Developer 所需的工作区创建,选择
C:\Users\PhotonUser\My Files\Home Folder
(又或D: \PhotonUser\My Files\Home Folder
)作为工作区的位置。 -
在 Enterprise Developer 中,进入项目资源管理器,右键单击并选择导入、导入...、Git、Git 克隆 URI 中的项目,克隆您的 CodeCommit 存储库。然后,输入您的 CodeCommit 特定登录凭证并完成 Eclipse 对话框以导入代码。
CodeCommit git 存储库现已克隆到您的本地工作区中。
您的 Enterprise Developer 工作区现已准备就绪,可以开始对您的应用程序进行维护工作。具体而言,您可以使用与 Enterprise Developer 集成的 Microfocus Enterprise Server (ES) 本地实例以交互方式调试和运行应用程序,以便在本地验证您的更改。
注意
本地 Enterprise Developer 环境(包括本地 Enterprise Server 实例)在 Windows 下运行,而 AWS Mainframe Modernization 则在 Linux 下运行。我们建议您在将新应用程序提交到 CodeCommit 并针对此目标进行重建之后,以及将新应用程序部署到生产环境之前,在 AWS Mainframe Modernization 提供的 Linux 环境中运行补充测试。
后续会话
当您选择一个受 AppStream 2.0 管理的文件夹(例如用于克隆 CodeCommit 存储库的主文件夹)时,该文件夹将在各个会话之间透明地保存和恢复。您可以在下次需要使用该应用程序时完成以下步骤:
-
根据收到的欢迎电子邮件中的 URL 开始与 AppStream 2.0 的会话。
-
使用您的电子邮件和永久密码登录。
-
选择 Enterprise Developer 堆栈。
-
启动
Rclone
以连接(见上文)到 Amazon S3 支持的磁盘(如果您使用此选项共享工作区文件)。 -
启动 Enterprise Developer 来完成工作。
清理资源
如果您不再需要为本教程创建的资源,请将其删除,以免继续产生费用。完成以下步骤:
-
删除您为本教程创建的 CodeCommit 存储库。有关更多信息,请参阅《AWS CodeCommit 用户指南》中的删除 CodeCommit 存储库。
-
删除您为本教程创建的数据库。有关更多信息,请参阅删除数据库实例。