

AWS Mainframe Modernization Service （受管執行期環境體驗） 不再向新客戶開放。對於與 AWS Mainframe Modernization Service （受管執行期環境體驗） 類似的功能，探索 AWS Mainframe Modernization Service （自我管理體驗）。現有客戶可以繼續正常使用該服務。如需詳細資訊，請參閱[AWS 大型主機現代化可用性變更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)。

本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。

# 教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer
<a name="set-up-ed"></a>

本教學課程說明如何為一或多個大型主機應用程式設定 Rocket Enterprise Developer （先前稱為 Micro Focus Enterprise Developer)，以便使用企業開發人員功能進行維護、編譯和測試。此設定是根據 AWS 大型主機現代化與客戶共用的 WorkSpaces 應用程式 Windows 映像，以及建立 WorkSpaces 應用程式機群和堆疊，如中所述[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。

**重要**  
本教學課程中的步驟假設您使用可 CloudFormation 下載的範本 [cfn-m2-appstream-fleet-ea-ed.yaml](https://d1vi4vxke6c2hu.cloudfront.net/tutorial/cfn-m2-appstream-fleet-ea-ed.yaml) 設定 WorkSpaces 應用程式。如需詳細資訊，請參閱[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。  
當企業開發人員機群和堆疊啟動並執行時，您必須執行此設定的步驟。

如需 Enterprise Developer v7 功能和交付項目的完整說明，請參閱 Rocket Software （先前稱為 Micro Focus[) 網站上的up-to-date線上文件 (v7.0)。](https://www.microfocus.com/documentation/enterprise-developer/ed70/ED-Eclipse/GUID-8D6B7358-AC35-4DAF-A445-607D8D97EBB2.html)

## 影像內容
<a name="set-up-ed-image-contents"></a>

除了企業開發人員本身之外，映像還包含 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 應用程式上設定 Enterprise Analyzer](set-up-ea.md)。

**Topics**
+ [影像內容](#set-up-ed-image-contents)
+ [先決條件](#tutorial-ed-prerequisites)
+ [步驟 1：由個別企業開發人員使用者設定](#tutorial-ed-step1)
+ [步驟 2：在 Windows 上建立 Amazon S3 型虛擬資料夾 （選用）](#tutorial-ed-step2)
+ [步驟 3：複製儲存庫](#tutorial-ed-step3)
+ [後續工作階段](#tutorial-ed-step4)
+ [清除資源](#tutorial-ed-clean)

## 先決條件
<a name="tutorial-ed-prerequisites"></a>
+ 一或多個 CodeCommit 儲存庫，載入要維護的應用程式原始碼。儲存庫設定應符合上述CI/CD管道的要求，以透過結合這兩種工具來建立協同作用。
+ 每個使用者都必須擁有 CodeCommit 儲存庫的登入資料，或帳戶管理員根據 [ AWS CodeCommit 身分驗證和存取控制](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)中的資訊定義的儲存庫。這些登入資料的結構會在 [ AWS CodeCommit 的身分驗證和存取控制](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)中檢閱，而 CodeCommit 的 IAM 授權完整參考位於 [CodeCommit 許可參考](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control-permissions-reference.html)中：管理員可以為具有每個儲存庫角色特定登入資料的不同角色定義不同的 IAM 政策，並將使用者的授權限制在指定儲存庫上必須完成的特定任務集。因此，對於 CodeCommit 儲存庫的每個維護者，帳戶管理員將產生主要使用者，並透過選取適當的 IAM 政策或 CodeCommit 存取政策，授予此使用者存取所需儲存庫或儲存庫的許可。

## 步驟 1：由個別企業開發人員使用者設定
<a name="tutorial-ed-step1"></a>

1. 取得您的 IAM 登入資料：

   1. 連線至 AWS 主控台，網址為 https：//[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. 根據歡迎電子郵件中收到的 URL，使用 WorkSpaces 應用程式啟動工作階段。使用您的電子郵件做為使用者名稱並建立您的密碼。

1. 選取您的企業開發人員堆疊。

1. 在選單頁面上，選擇**桌面**以連接機群串流的 Windows 桌面。

## 步驟 2：在 Windows 上建立 Amazon S3 型虛擬資料夾 （選用）
<a name="tutorial-ed-step2"></a>

如果需要 Rclone （請參閱上述），請在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾： （如果所有應用程式成品完全來自 CodeCommit 存取，則為選用）。

**注意**  
如果您已在 AWS Mainframe Modernization 預覽期間使用 Rclone，則必須更新`m2-rclone.cmd`至位於 的較新版本`C:\Users\Public`。

1. `C:\Users\PhotonUser\My Files\Home Folder` 使用 `m2-rclone.cmd` File Explorer 將 中提供的 `m2-rclone.conf`和 檔案`C:\Users\Public`複製到主資料夾。

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. `C:\Users\PhotonUser\My Files\Home Folder` 視需要開啟 Windows 命令提示字元，cd 至 並執行 `m2-rclone.cmd`。此命令指令碼會執行連續迴圈，將您的 Amazon S3 儲存貯體和金鑰每 10 秒同步至本機資料夾。您可以視需要調整逾時。您應該會在 Windows File Explorer 的 Amazon S3 儲存貯體中看到應用程式的原始碼。

若要將新檔案新增至您正在處理的集，或更新現有的檔案，請將檔案上傳至 Amazon S3 儲存貯體，並在 中定義的下一個反覆運算時同步至您的目錄`m2-rclone.cmd`。同樣地，如果您要刪除一些檔案，請從 Amazon S3 儲存貯體中刪除它們。下一個同步操作會從本機目錄刪除它們。

## 步驟 3：複製儲存庫
<a name="tutorial-ed-step3"></a>

1. 導覽至瀏覽器視窗左上角的應用程式選擇器選單，然後選取企業開發人員。

1. 在主資料夾中選擇 `C:\Users\PhotonUser\My Files\Home Folder`（也稱為 `D: \PhotonUser\My Files\Home Folder`) 作為工作區的位置，以完成企業開發人員所需的工作區建立。

1. 在企業開發人員中，前往 Project Explorer 複製您的 CodeCommit 儲存庫，按一下滑鼠右鍵，然後選擇**匯入**、**匯入...**、**Git**、來自 **Git** **複製 URI** **的專案**。然後，輸入您的 CodeCommit 特定登入憑證，並完成 Eclipse 對話方塊以匯入程式碼。

現在已在您的本機工作區複製 中的 CodeCommit git 儲存庫。

您的企業開發人員工作區現在已準備好在您的應用程式上開始維護工作。特別是，您可以使用與企業開發人員整合的 Enterprise Server (ES) 本機執行個體，以互動方式偵錯和執行您的應用程式，以在本機驗證您的變更。

**注意**  
本機企業開發人員環境，包括本機企業伺服器執行個體，會在 Windows 下執行，而 AWS 大型主機現代化則在 Linux 下執行。建議您在將新應用程式遞交至 CodeCommit 後，以及在將新應用程式推展至生產環境之前，在 AWS Mainframe Modernization 提供的 Linux 環境中執行補充測試。

## 後續工作階段
<a name="tutorial-ed-step4"></a>

當您選取 WorkSpaces 應用程式管理下的資料夾時，例如複製 CodeCommit 儲存庫的主資料夾，它將在工作階段之間透明地儲存和還原。下次您需要使用應用程式時，請完成下列步驟：

1. 根據歡迎電子郵件中收到的 URL，使用 WorkSpaces 應用程式啟動工作階段。

1. 使用您的電子郵件和永久密碼登入。

1. 選取企業開發人員堆疊。

1. 當此選項用於共用工作區檔案時，啟動 `Rclone` 以連線至 （請參閱上述） Amazon S3 後端磁碟。

1. 啟動企業開發人員來執行您的工作。

## 清除資源
<a name="tutorial-ed-clean"></a>

如果您不再需要為本教學課程建立的資源，請將其刪除，這樣就不會繼續收取這些資源的費用。請完成下列步驟：
+ 刪除您為此教學課程建立的 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)。