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)。 本文為英文版的機器翻譯版本，如內容有任何歧義或不一致之處，概以英文版為準。 # 火箭軟體教學課程 （先前為 Micro Focus) 本節中的教學課程可協助您開始為 AWS Mainframe Modernization 服務在 Rocket Software 執行期引擎中設定各種任務。這些教學課程用於設定範例應用程式、搭配 Rocket Enterprise Developer 使用 範本，以及設定 Enterprise Analyzer。 **Topics** + [ # 教學課程：為 BankDemo 範例應用程式設定 Rocket Software （先前稱為 Micro Focus) 組建 ](tutorial-build-mf.md) + [ # 教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用 ](set-up-appstream-mf.md) + [ # 教學課程：搭配 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 使用 範本 ](tutorial-templates-ed.md) + [ # 教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer ](set-up-ea.md) + [ # 教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer ](set-up-ed.md) # 教學課程：為 BankDemo 範例應用程式設定 Rocket Software （先前稱為 Micro Focus) 組建 AWS Mainframe Modernization 可讓您為遷移的應用程式設定建置和持續整合/持續交付 (CI/CD) 管道。這些建置和管道會使用 AWS CodeBuild AWS CodeCommit和 AWS CodePipeline 來提供這些功能。CodeBuild 是全受管建置服務，可編譯您的原始程式碼、執行單元測試，並產生準備好部署的成品。CodeCommit 是一種版本控制服務，可讓您在 AWS 雲端中私下存放和管理 Git 回應。CodePipeline 是一種持續交付服務，可讓您模型化、視覺化和自動化發行軟體所需的步驟。 本教學課程示範如何使用 從 Amazon S3 AWS CodeBuild 編譯 BankDemo 範例應用程式原始碼，然後將編譯後的程式碼匯出回 Amazon S3。 AWS CodeBuild 是一種全受管持續整合服務，可編譯原始程式碼、執行測試，並產生準備好部署的軟體套件。使用 CodeBuild，您可以使用預先封裝的建置環境，也可以使用您自己的建置工具建立自訂建置環境。此示範案例使用第二個選項。它包含使用預先封裝 Docker 映像的 CodeBuild 建置環境。 **重要** 在開始大型主機現代化專案之前，建議您先了解[AWS 大型主機的 Migration Acceleration Program (MAP)](https://aws.amazon.com/migration-acceleration-program/mainframe/)，或聯絡[AWS 大型主機專家](mailto: mainframe@amazon.com)，以了解現代化大型主機應用程式所需的步驟。 **Topics** + [ ## 先決條件 ](#tutorial-build-mf-prerequisites) + [ ## 步驟 1：與 AWS 帳戶共用建置資產 ](#tutorial-build-mf-assets) + [ ## 步驟 2：建立 Amazon S3 儲存貯體 ](#tutorial-build-mf-s3) + [ ## 步驟 3：建立建置規格檔案 ](#tutorial-build-mf-spec) + [ ## 步驟 4：上傳來源檔案 ](#tutorial-build-mf-upload) + [ ## 步驟 5：建立 IAM 政策 ](#tutorial-build-mf-IAM-policy) + [ ## 步驟 6：建立 IAM 角色 ](#tutorial-build-mf-IAM-role) + [ ## 步驟 7：將 IAM 政策連接至 IAM 角色 ](#tutorial-build-mf-attach) + [ ## 步驟 8：建立 CodeBuild 專案 ](#tutorial-build-mf-create-project) + [ ## 步驟 9：啟動建置 ](#tutorial-build-mf-start) + [ ## 步驟 10：下載輸出成品 ](#tutorial-build-mf-download-output) + [ ## 清除資源 ](#tutorial-build-mf-clean) ## 先決條件 開始本教學課程之前，請先完成下列先決條件。 + 下載 [BankDemo 範例應用程式](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip)，並將其解壓縮至資料夾。來源資料夾包含 COBOL 程式、Copybook 和 定義。它也包含 JCL 資料夾以供參考，但您不需要建置 JCL。資料夾也包含建置所需的中繼檔案。 + 在 AWS 大型主機現代化主控台中，選擇**工具** 。在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 ## 步驟 1：與 AWS 帳戶共用建置資產 在此步驟中，您會確保與 AWS 帳戶共用建置資產，尤其是在使用資產的區域中。 1. 在 https：//[https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) 開啟 AWS 大型主機現代化主控台。 1. 在左側導覽中，選擇**工具**。 1. 在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 **重要** 您需要在每個要進行建置的 AWS 區域中執行此步驟一次。 ## 步驟 2：建立 Amazon S3 儲存貯體 在此步驟中，您會建立兩個 Amazon S3 儲存貯體。第一個是用來保存原始程式碼的輸入儲存貯體，另一個是用來保存建置輸出的輸出儲存貯體。如需詳細資訊，請參閱《[Amazon S3 使用者指南》中的建立、設定和使用 Amazon S3 儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html)體。 *Amazon S3 * 1. 若要建立輸入儲存貯體，請登入 Amazon S3 主控台，然後選擇**建立儲存貯**體。 1. 在**一般組態**中，提供儲存貯體的名稱，並指定您要建立儲存貯體 AWS 區域 的 。範例名稱為 `codebuild-regionId-accountId-input-bucket`，其中 `regionId`是儲存貯體 AWS 區域 的 ，而 `accountId`是您的 AWS 帳戶 ID。 **注意** 如果您要在與美國東部 （維吉尼亞北部） AWS 區域 不同的 中建立儲存貯體，請指定 `LocationConstraint` 參數。如需詳細資訊，請參閱《*Amazon Simple Storage Service API 參考*》中的[建立儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/API/API_CreateBucket.html)體。 1. 保留所有其他設定，然後選擇**建立儲存貯**體。 1. 重複步驟 1-3 來建立輸出儲存貯體。範例名稱為 `codebuild-regionId-accountId-output-bucket`，其中 `regionId`是儲存貯體 AWS 區域 的 ，而 `accountId`是您的 AWS 帳戶 ID。 無論您為這些儲存貯體選擇的名稱為何，請務必在本教學課程中使用這些儲存貯體。 ## 步驟 3：建立建置規格檔案 在此步驟中，您會建立建置規格檔案。此檔案提供 YAML 格式的建置命令和相關設定，讓 CodeBuild 執行建置。如需詳細資訊，請參閱*AWS CodeBuild 《 使用者指南*》中的[為 CodeBuild 建置規格參考](https://docs.aws.amazon.com/codebuild/latest/userguide/build-spec-ref.html)。 1. 在您解壓縮為先決條件`buildspec.yml`的目錄中建立名為 的檔案。 1. 將下列內容新增至 檔案並儲存。此檔案不需要變更。 ``` version: 0.2 env: exported-variables: - CODEBUILD_BUILD_ID - CODEBUILD_BUILD_ARN phases: install: runtime-versions: python: 3.7 pre_build: commands: - echo Installing source dependencies... - ls -lR $CODEBUILD_SRC_DIR/source build: commands: - echo Build started on `date` - /start-build.sh -Dbasedir=$CODEBUILD_SRC_DIR/source -Dloaddir=$CODEBUILD_SRC_DIR/target post_build: commands: - ls -lR $CODEBUILD_SRC_DIR/target - echo Build completed on `date` artifacts: files: - $CODEBUILD_SRC_DIR/target/** ``` 此處的 `CODEBUILD_BUILD_ID`、`$CODEBUILD_SRC_DIR/source`、 `CODEBUILD_BUILD_ARN`和 `$CODEBUILD_SRC_DIR/target`是 CodeBuild 中可用的環境變數。如需詳細資訊，請參閱[建置環境中的環境變數](https://docs.aws.amazon.com/codebuild/latest/userguide/build-env-ref-env-vars.html)。 此時，您的目錄看起來應該會像這樣。 ``` (root directory name) |-- build.xml |-- buildspec.yml |-- LICENSE.txt |-- source |... etc. ``` 1. 將資料夾的內容壓縮至名為 的檔案`BankDemo.zip`。在本教學課程中，您無法壓縮 資料夾。反之，請將資料夾的內容壓縮至檔案 `BankDemo.zip`。 ## 步驟 4：上傳來源檔案 在此步驟中，您將 BankDemo 範例應用程式的原始碼上傳至您的 Amazon S3 輸入儲存貯體。 1. 登入 Amazon S3 主控台，然後在左側導覽窗格中選擇**儲存貯**體。然後選擇您先前建立的輸入儲存貯體。 1. 在**物件**下，選擇**上傳**。 1. 在**檔案和資料夾**區段中，選擇**新增檔案**。 1. 導覽至 並選擇您的 `BankDemo.zip` 檔案。 1. 選擇**上傳**。 ## 步驟 5：建立 IAM 政策 在此步驟中，您會建立兩個 [IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)。一項政策授予 AWS Mainframe Modernization 存取和使用包含 Rocket Software 組建工具的 Docker 映像的許可。此政策不會為客戶自訂。其他政策授予 AWS Mainframe Modernization 與輸入和輸出儲存貯體以及 CodeBuild 產生的 [Amazon CloudWatch logs](https://docs.aws.amazon.com/AmazonCloudWatch/latest/logs/WhatIsCloudWatchLogs.html)互動的許可。 若要了解如何建立 IAM 政策，請參閱《[IAM 使用者指南》中的編輯 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_create.html)。 ** **建立存取 Docker 映像的政策** 1. 在 IAM 主控台中，複製下列政策文件並將其貼到政策編輯器中。 ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Action": [ "ecr:GetAuthorizationToken" ], "Resource": "*" }, { "Effect": "Allow", "Action": [ "ecr:BatchCheckLayerAvailability", "ecr:GetDownloadUrlForLayer", "ecr:BatchGetImage" ], "Resource": "arn:aws:ecr:*:673918848628:repository/m2-enterprise-build-tools" }, { "Effect": "Allow", "Action": [ "s3:PutObject" ], "Resource": "arn:aws:s3:::aws-m2-repo-*--prod" } ] } ``` ------ 1. 提供政策的名稱，例如 `m2CodeBuildPolicy`。 **建立允許 AWS Mainframe Modernization 與儲存貯體和日誌互動的政策** 1. 在 IAM 主控台中，複製下列政策文件並將其貼到政策編輯器中。請務必`regionId`將 AWS 區域和 更新`accountId`為 AWS 帳戶。 1. 提供政策的名稱，例如 `BankdemoCodeBuildRolePolicy`。 ## 步驟 6：建立 IAM 角色 在此步驟中，您會建立新的 [IAM 角色](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)，在您將先前建立的 IAM 政策與此新 IAM 角色建立關聯之後，允許 CodeBuild 與您 AWS 資源互動。 如需有關建立服務角色的資訊，請參閱《*IAM 使用者指南*》中的[建立角色以委派許可給 AWS 服務](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_create_for-service.html)。 1. 登入 IAM 主控台，然後在左側導覽窗格中選擇**角色**。 1. 選擇建**立角色**。 1. 在**信任的實體類型**下，選擇 **AWS 服務**。 1. 在**其他 AWS 服務的使用案例**下，選擇 **CodeBuild**，然後再次選擇 **CodeBuild**。 1. 選擇**下一步**。 1. 在 **Add permissions** (新增許可) 頁面上，選擇 **Next** (下一步)。您稍後會將政策指派給角色。 1. 在**角色詳細資訊**下，提供角色的名稱，例如 `BankdemoCodeBuildServiceRole`。 1. 在**選取信任的實體**下，確認政策文件如下所示： ------ #### [ JSON ] **** ``` { "Version":"2012-10-17", "Statement": [ { "Effect": "Allow", "Principal": { "Service": "codebuild.amazonaws.com" }, "Action": "sts:AssumeRole" } ] } ``` ------ 1. 選擇建**立角色**。 ## 步驟 7：將 IAM 政策連接至 IAM 角色 在此步驟中，您將先前建立的兩個 IAM 政策連接到 IAM `BankdemoCodeBuildServiceRole` 角色。 1. 登入 IAM 主控台，然後在左側導覽窗格中選擇**角色**。 1. 在**角色**中，選擇您先前建立的角色，例如 `BankdemoCodeBuildServiceRole`。 1. 在**許可政策**中，選擇**新增許可**，然後選擇**連接政策**。 1. **在其他許可政策**中，選擇您先前建立的政策，例如 `m2CodeBuildPolicy`和 `BankdemoCodeBuildRolePolicy`。 1. 選擇**連接政策**。 ## 步驟 8：建立 CodeBuild 專案 在此步驟中，您會建立 CodeBuild 專案。 1. 登入 CodeBuild 主控台，然後選擇**建立建置專案**。 1. 在**專案組態**區段中，提供專案的名稱，例如 `codebuild-bankdemo-project`。 1. 在**來源**區段中，針對**來源提供者**選擇 **Amazon S3**，然後選擇您先前建立的輸入儲存貯體，例如 `codebuild-regionId-accountId-input-bucket`。 1. 在 **S3 物件金鑰或 S3 資料夾**欄位中，輸入您上傳到 S3 儲存貯體的 zip 檔案名稱。在此情況下，檔案名稱為 `bankdemo.zip`。 1. 在**環境**區段中，選擇**自訂映像**。 1. 在**環境類型**欄位中，選擇 **Linux**。 1. 在**映像登錄**檔下，選擇**其他登錄檔**。 1. 在**外部登錄 URL** 欄位中， + 對於 Rocket 軟體 v9：輸入 `673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`。如果您使用不同的 AWS 區域搭配 Rocket Software v9，您也可以指定 ` 673918848628.dkr.ecr..amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`，其中 是可使用 AWS 大型主機現代化服務 AWS 的區域 （例如 `eu-west-3`)。 + 對於 Rocket 軟體 v8：輸入 `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1` + 對於 Rocket 軟體 v7：輸入 `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:7.0.R10` 1. 在**服務角色**下，選擇**現有服務角色**，然後在**角色 ARN** 欄位中，選擇您先前建立的服務角色；例如，`BankdemoCodeBuildServiceRole`。 1. 在 **Buildspec** 區段中，選擇**使用 buildspec 檔案**。 1. 在**成品**區段的**類型**下，選擇 **Amazon S3**，然後選擇輸出儲存貯體，例如 `codebuild-regionId-accountId-output-bucket`。 1. 在**名稱**欄位中，輸入您要包含建置輸出成品之儲存貯體中的資料夾名稱，例如 `bankdemo-output.zip`。 1. 在**成品封裝**下，選擇 **Zip**。 1. 選擇 **Create build project (建立建置專案)**。 ## 步驟 9：啟動建置 在此步驟中，您會啟動建置。 1. 登入 CodeBuild 主控台。 1. 在左側導覽窗格中，選擇**建置專案**。 1. 選擇您先前建立的建置專案，例如 `codebuild-bankdemo-project`。 1. 選擇 **Start build (開始組建)**。 此命令會啟動建置。組建會以非同步方式執行。命令的輸出是包含 屬性 ID 的 JSON。此屬性 idis 是您剛啟動之組建的 CodeBuild 組建 ID 參考。您可以在 CodeBuild 主控台中檢視組建的狀態。您也可以在 主控台中查看有關建置執行的詳細日誌。如需詳細資訊，請參閱*AWS CodeBuild 《 使用者指南*》中的[檢視詳細的建置資訊](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html)。 當目前階段為 COMPLETED 時，表示您的建置已成功完成，而且您的編譯成品已在 Amazon S3 上就緒。 ## 步驟 10：下載輸出成品 在此步驟中，您會從 Amazon S3 下載輸出成品。Rocket 軟體建置工具可以建立數種不同的可執行檔類型。在本教學課程中，它會產生共用物件。 1. 登入 Amazon S3 主控台。 1. 在**儲存貯體** role="bold"> 區段中，選擇輸出儲存貯體的名稱，例如 `codebuild-regionId-accountId-output-bucket`。 1. 選擇**下載** role="bold">。 1. 解壓縮所下載的 檔案。導覽至目標資料夾以查看建置成品。這些包括 `.so` Linux 共用物件。 ## 清除資源 如果您不再需要為本教學課程建立的資源，請將其刪除以避免額外費用。若要這樣做，請完成下列步驟： + 刪除您為此教學課程建立的 S3 儲存貯體。如需詳細資訊，請參閱《*Amazon Simple Storage Service 使用者指南*》中的[刪除儲存貯](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)體。 + 刪除您為此教學課程建立的 IAM 政策。如需詳細資訊，請參閱《[IAM 使用者指南》中的刪除 IAM 政策](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies_manage-delete.html)。 ** + 刪除您為此教學課程建立的 IAM 角色。如需詳細資訊，請參閱 *IAM 使用者指南*中的[刪除角色或執行個體描述檔](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles_manage_delete.html)。 + 刪除您為此教學課程建立的 CodeBuild 專案。如需詳細資訊，請參閱*AWS CodeBuild 《 使用者指南*》中的在 [ CodeBuild 中刪除組建專案](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html)。 # 教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用 AWS Mainframe Modernization 透過 Amazon WorkSpaces 應用程式提供數種工具。WorkSpaces 應用程式是一種全受管、安全的應用程式串流服務，可讓您將桌面應用程式串流給使用者，而無需重寫應用程式。WorkSpaces 應用程式可讓使用者立即存取所需的應用程式，並在自己選擇的裝置上提供回應靈敏、流暢的使用者體驗。使用 WorkSpaces 應用程式託管執行期引擎特定工具，可讓客戶應用程式團隊直接從 Web 瀏覽器使用工具，並與存放在 Amazon S3 儲存貯體或 CodeCommit 儲存庫中的應用程式檔案互動。 如需有關 WorkSpaces 應用程式中瀏覽器支援的資訊，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[系統需求和功能支援 （網頁瀏覽器）](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html)。如果您在使用 WorkSpaces 應用程式時遇到問題，請參閱《*Amazon WorkSpaces 應用程式管理指南*》中的[對 AppStream 2.0 使用者問題進行故障診斷](https://docs.aws.amazon.com/appstream2/latest/developerguide/troubleshooting-user-issues.html)。 本文件適用於客戶營運團隊的成員。它說明如何設定 Amazon WorkSpaces 應用程式機群和堆疊來託管與 AWS Mainframe Modernization 搭配使用的 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 工具。Rocket Enterprise Analyzer 通常在評估階段使用，Rocket Enterprise Developer 通常在 AWS 大型主機現代化方法的遷移和現代化階段使用。如果您打算同時使用 Enterprise Analyzer 和 Enterprise Developer，您必須為每個工具建立單獨的機群和堆疊。每個工具都需要自己的機群和堆疊，因為其授權條款不同。 **重要** 本教學課程中的步驟是以可下載的 CloudFormation 範本 [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 為基礎。 **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 [ VPCs》中的預設](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html) VPC。 **如需預設安全群組的詳細資訊，請參閱《*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 和 Enterprise Developer 的 WorkSpaces 應用程式映像。 1. 在 https：//[https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) 開啟 AWS 大型主機現代化主控台。 1. 在左側導覽中，選擇**工具**。 1. 在**分析、開發和建置資產**中，選擇**與我的 AWS 帳戶共用資產**。 ## 步驟 2：使用 CloudFormation 範本建立堆疊 在此步驟中，您會使用下載的 CloudFormation 範本來建立 WorkSpaces 應用程式堆疊和機群，以執行 Rocket Enterprise Analyzer。您可以稍後重複此步驟，為執行 Rocket Enterprise Developer 建立另一個 WorkSpaces 應用程式堆疊和機群，因為每個工具都需要自己的機群和 WorkSpaces 應用程式中的堆疊。如需 CloudFormation 堆疊的詳細資訊，請參閱*AWS CloudFormation 《 使用者指南*》中的[使用堆疊](https://docs.aws.amazon.com/AWSCloudFormation/latest/UserGuide/stacks.html)。 **注意** AWS Mainframe Modernization 會針對使用 Enterprise Analyzer 和 Enterprise Developer 的標準 WorkSpaces 應用程式定價增加額外費用。如需詳細資訊，請參閱[AWS 大型主機現代化定價](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.yml 範本。](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 1. 選擇**下一步**。 ![\[使用選取的 cfn-m2-appstream-fleet-ea-ed.yml 範本 CloudFormation 建立堆疊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/cfn-create-stack.png) 1. 在**指定堆疊詳細資訊**上，輸入下列資訊： + 在**堆疊名稱**中，輸入您選擇的名稱。例如 **m2-ea**。 + 在 **AppStreamApplication** 中，選擇 **ea**。 + 在 **AppStreamFleetSecurityGroup** 中，選擇預設 VPC 的預設安全群組。 + 在 **AppStreamFleetVpcSubnet** 中，選擇預設 VPC 內的子網路。 + 在 **AppStreamImageName** 中，選擇以 開頭的影像`m2-enterprise-analyzer`。此映像包含 Rocket Enterprise Analyzer 工具目前支援的版本。 + 接受其他欄位的預設值，然後選擇**下一步**。 ![\[已填入 Enterprise Analyzer 選項的 CloudFormation 指定堆疊詳細資訊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/cfn-specify-stack-details.png) 1. 接受所有預設值，然後再次選擇**下一步**。 1. **檢閱**時，請確定所有參數都是您想要的。 1. 捲動至底部，選擇**我確認 AWS CloudFormation 可能會使用自訂名稱建立 IAM 資源**，然後選擇**建立堆疊**。 堆疊和機群需要 20 到 30 分鐘才能建立。您可以選擇**重新整理**，在 CloudFormation 事件發生時查看事件。 ## 步驟 3：在 WorkSpaces 應用程式中建立使用者 當您等待 CloudFormation 完成建立堆疊時，您可以在 WorkSpaces 應用程式中建立一或多個使用者。這些使用者是將在 WorkSpaces 應用程式中使用 Enterprise Analyzer 的使用者。您需要為每個使用者指定電子郵件地址，並確保每個使用者有足夠的許可在 Amazon S3 中建立儲存貯體、將檔案上傳至儲存貯體，以及連結到儲存貯體以映射其內容。 1. 開啟 WorkSpaces 應用程式主控台。 1. 在左側導覽中，選擇**使用者集區**。 1. 選擇 **Create user** (建立使用者)。 1. 提供電子郵件地址，讓使用者可以收到使用 WorkSpaces 應用程式的電子郵件邀請、名字和姓氏，然後選擇**建立使用者**。 1. 如有必要，請重複此動作以建立更多使用者。每個使用者的電子郵件地址必須是唯一的。 如需建立 WorkSpaces 應用程式使用者的詳細資訊，請參閱《Amazon [WorkSpaces 應用程式管理指南》中的 WorkSpaces 應用程式使用者集](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool.html)區。 *Amazon WorkSpaces * CloudFormation 完成建立堆疊後，您可以將您建立的使用者指派給堆疊，如下所示： 1. 開啟 WorkSpaces 應用程式主控台。 1. 選擇使用者名稱。 1. 選擇**動作**，然後選擇**指派堆疊**。 1. 在**指派堆疊**中，選擇開頭為 的堆疊`m2-appstream-stack-ea`。 1. 選擇 **Assign stack (指派堆疊)**。 ![\[WorkSpaces 應用程式指派堆疊頁面顯示要指派的使用者和 Enterprise Analyzer 堆疊。\]](http://docs.aws.amazon.com/zh_tw/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_tw/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 帳戶中的所有機群和堆疊之間共用。Home Folder 的名稱是使用者電子郵件地址的 SHA256 雜湊，並根據該雜湊儲存在路徑上。 + 名稱開頭為 `appstream-app-settings-`。此儲存貯體包含 WorkSpaces 應用程式的使用者工作階段資訊，並包含瀏覽器我的最愛、IDE 和應用程式連線設定檔，以及 UI 自訂等設定。如需詳細資訊，請參閱*《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 應用程式上設定 Enterprise Analyzer](set-up-ea.md)。您也可以設定企業開發人員。如需詳細資訊，請參閱[教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer](set-up-ed.md)。 ## 清除資源 清除建立的堆疊和機群的程序如[建立 WorkSpaces 應用程式機群和堆疊](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html)中所述。 刪除 WorkSpaces 應用程式物件後，帳戶管理員也可以視需要清除應用程式設定和主資料夾的 Amazon S3 儲存貯體。 **注意** 指定使用者的主資料夾在所有機群中都是唯一的，因此如果同一帳戶中有其他 WorkSpaces 應用程式堆疊處於作用中狀態，您可能需要保留它。 最後，WorkSpaces 應用程式目前不允許您使用主控台刪除使用者。反之，您必須搭配 CLI 使用服務 API。如需詳細資訊，請參閱《Amazon WorkSpaces 應用程式管理指南》中的[使用者集](https://docs.aws.amazon.com/appstream2/latest/developerguide/user-pool-admin.html)區管理。 *Amazon WorkSpaces * # 教學課程：搭配 Rocket Enterprise Developer （先前為 Micro Focus Enterprise Developer) 使用 範本 本教學課程說明如何搭配 Rocket Enterprise Developer 使用 範本和預先定義的專案。它涵蓋三個使用案例。所有使用案例都會使用 BankDemo 範例中提供的範本程式碼。若要下載範例，請選擇 [https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) 。 **重要** 如果您使用適用於 Windows 的 Enterprise Developer 版本，編譯器產生的二進位檔只能在 Enterprise Developer 隨附的 Enterprise Server 上執行。您無法在以 Linux 為基礎的 AWS Mainframe Modernization 執行時間下執行它們。 **Topics** + [ ## 使用案例 1 - 使用包含來源元件的 COBOL 專案範本 ](#tutorial-templates-ed-step1) + [ ## 使用案例 2 - 使用不含來源元件的 COBOL 專案範本 ](#tutorial-templates-ed-step2) + [ ## 使用案例 3 - 使用連結至來源資料夾的預先定義 COBOL 專案 ](#tutorial-templates-ed-step3) + [ ## 使用區域定義 JSON 範本 ](#tutorial-templates-ed-step4) ## 使用案例 1 - 使用包含來源元件的 COBOL 專案範本 此使用案例需要您將來源元件複製到範本目錄結構，作為示範預先設定步驟的一部分。在 中，[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip)這已從原始`AWSTemplates.zip`交付變更，以避免有兩個來源複本。 1. 啟動企業開發人員並指定選擇的工作區。 ![\[選取工作區的 Eclipse 啟動器。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step1.png) 1. 在 **Application Explorer** 檢視中，從**企業開發專案**樹狀檢視項目中，從內容功能表中**選擇範本中的新專案**。 ![\[企業開發專案樹狀檢視內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step2.png) 1. 輸入範本參數，如下所示。 **注意** 範本路徑會參照 ZIP 的擷取位置。 ![\[輸入範本參數方塊，其中包含填入的路徑和專案名稱。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step3.png) 1. 選擇確定將根據提供的範本建立本機開發 Eclipse 專案，其中包含完整的來源和執行環境結構。 ![\[顯示其結構的本機開發 Eclipse 專案。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc1-step4.png) `System` 結構包含完整的資源定義檔案，其中包含 BANKDEMO 的必要項目、新增項目的必要目錄，以及對應的 ASCII 資料檔案。 由於來源範本結構包含所有來源項目，因此這些檔案會複製到本機專案，因此會自動建置在企業開發人員中。 ## 使用案例 2 - 使用不含來源元件的 COBOL 專案範本 步驟 1 到 3 與 相同[使用案例 1 - 使用包含來源元件的 COBOL 專案範本](#tutorial-templates-ed-step1)。 此使用案例中的`System`結構也包含完整的資源定義檔案，其中包含 BankDemo 所需的項目、新增項目的必要目錄，以及對應的 ASCII 資料檔案。 不過，範本來源結構不包含任何元件。您必須從您使用的任何來源儲存庫將這些項目匯入專案。 1. 選擇專案名稱。從相關內容功能表中，選擇**匯入**。 ![\[選取匯入的專案內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step4.png) 1. 在產生的對話方塊中，於**一般**區段下，選擇**檔案系統**，然後選擇下一步。 ![\[已選取檔案系統的匯入方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step5.png) 1. 瀏覽檔案系統以指向儲存庫資料夾，填入**從目錄**欄位。選擇您要匯入的所有資料夾，例如 `sources`。`Into folder` 欄位將預先填入。選擇**完成**。 ![\[展開 BankDemo 目錄的檔案系統方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc2-step6.png) 在來源範本結構包含所有來源項目之後，它們會自動建置在企業開發人員中。 ## 使用案例 3 - 使用連結至來源資料夾的預先定義 COBOL 專案 1. 啟動企業開發人員並指定選擇的工作區。 ![\[選取工作區的 Eclipse 啟動器。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step1.png) 1. 從 **File (檔案)** 功能表中，選擇 **Import (匯入)**。 ![\[已選取匯入的檔案功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step2.png) 1. 從產生的對話方塊中，在**一般**下，**從資料夾或封存中選擇專案**，然後選擇**下一步**。 ![\[選取從資料夾或封存匯入專案的方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step3.png) 1. 填入**匯入來源**、選擇**目錄**並瀏覽檔案系統，以選取預先定義的專案資料夾。中包含的專案具有相同儲存庫中來源資料夾的連結。 ![\[從檔案系統或封存方塊匯入專案，並輸入匯入來源的路徑。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-uc3-step4.png) 選擇**完成**。 由於專案是由來源資料夾的連結填入，因此會自動建置程式碼。 ## 使用區域定義 JSON 範本 1. 切換到 Server Explorer 檢視。從相關內容功能表中，選擇**開啟管理頁面**，這會啟動預設瀏覽器。 ![\[已選取開啟管理頁面的伺服器瀏覽器內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-admin-page.png) 1. 從產生的 Enterprise Server Common Web Administration (ESCWA) 畫面中，選擇**匯入** 。 ![\[已選取匯入的企業伺服器通用 Web 管理畫面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-import.png) 1. 選擇 **JSON** 匯入類型，然後選擇**下一步**。 ![\[選取 JSON 的選擇匯入類型方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-import-type.png) 1. 上傳提供的`BANKDEMO.JSON`檔案。 ![\[選擇要上傳且已選取 BANKDEMO 檔案的檔案方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-upload.png) 選取後，選擇**下一步**。 ![\[具有來自未選取端點之透明連接埠的選取區域方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-next.png) 在**選取區域**面板上，確保未選取**從端點清除連接埠**選項，然後繼續透過面板選擇**下一步**，直到顯示**執行匯入**面板。然後從左側導覽窗格中選擇**匯入**。 最後按一下**完成**。接著會將 BANKDEMO 區域新增至伺服器清單。 ![\[新增了 BankDemo 的區域和伺服器清單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-server-list.png) 1. 導覽至 BANKDEMO 區域**的一般屬性**。 1. 捲動至**組態**區段。 1. ESP 環境變數需要設定為與先前步驟中建立的 Eclipse 專案相關的`System`資料夾。這應該是 `workspacefolder/projectname/System`。 ![\[顯示 ESP 變數的組態區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-ESP.png) 1. 按一下 **Apply (套用)**。 區域現在已完全設定為搭配 Eclipse COBOL 專案執行。 1. 最後，回到企業開發人員，將匯入的區域與專案建立關聯。 ![\[選取與專案相關聯的專案內容選單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ed-json-associate.png) 企業開發人員環境現在已準備就緒，可使用完整的 BankDemo 工作版本。您可以針對區域編輯、編譯和偵錯程式碼。 **重要** 如果您使用適用於 Windows 的 Enterprise Developer 版本，編譯器產生的二進位檔只能在 Enterprise Developer 隨附的 Enterprise Server 上執行。您無法在以 Linux 為基礎的 AWS Mainframe Modernization 執行時間下執行它們。 # 教學課程：在 WorkSpaces 應用程式上設定 Enterprise Analyzer 本教學課程說明如何設定 Rocket Enterprise Analyzer （先前稱為 Micro Focus Enterprise Analyzer) 來分析一或多個大型主機應用程式。Enterprise Analyzer 工具會根據其對應用程式原始碼和系統定義的分析，提供數個報告。 此設定旨在促進團隊協作。安裝使用 Amazon S3 儲存貯體與虛擬磁碟共用原始程式碼。這樣做會在 Windows 機器上使用 [Rclone](https://rclone.org/))。使用執行 [PostgreSQL](https://www.postgresql.org/) 的常見 Amazon RDS 執行個體，團隊的任何成員都可以存取所有請求的報告。 團隊成員也可以在其個人機器上掛載虛擬 Amazon S3 支援的磁碟。 並從工作站更新來源儲存貯體。如果連接到其他內部部署系統，他們可以在機器上使用指令碼或任何其他形式的自動化。 設定是以 AWS 大型主機現代化與客戶共用的 WorkSpaces 應用程式 Windows 映像為基礎。設定也以 WorkSpaces 應用程式機群和堆疊的建立為基礎，如中所述[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。 **重要** 本教學課程中的步驟假設您使用可 CloudFormation 下載的範本 [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) 設定 WorkSpaces 應用程式。如需詳細資訊，請參閱[教學課程：設定 WorkSpaces 應用程式以搭配 Rocket Enterprise Analyzer 和 Rocket Enterprise Developer 使用](set-up-appstream-mf.md)。 若要執行本教學課程中的步驟，您必須已設定 Enterprise Analyzer 機群和堆疊，而且必須正在執行。 如需 Enterprise Analyzer 功能和交付項目的完整說明，請參閱 Rocket Software （先前稱為 Micro Focus) 網站上的 [Enterprise Analyzer 文件](https://www.microfocus.com/documentation/enterprise-analyzer/)。 ## 影像內容 除了 Enterprise Analyzer 應用程式本身之外，映像還包含下列工具和程式庫。 第三方工具 + [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`。 **Topics** + [ ## 影像內容 ](#set-up-ea-image-contents) + [ ## 先決條件 ](#tutorial-ea-prerequisites) + [ ## 步驟 1：設定 ](#tutorial-ea-step1) + [ ## 步驟 2：在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾 ](#tutorial-ea-step2) + [ ## 步驟 3：建立 Amazon RDS 執行個體的 ODBC 來源 ](#tutorial-ea-step3) + [ ## 後續工作階段 ](#tutorial-ea-step4) + [ ## 工作區連線故障診斷 ](#tutorial-ea-step5) + [ ## 清除資源 ](#tutorial-ea-clean) ## 先決條件 + 將您要分析的客戶應用程式的原始程式碼和系統定義上傳至 S3 儲存貯體。系統定義包括 CICS CSD、DB2 物件定義等。您可以在 儲存貯體中建立資料夾結構，以決定您想要如何組織應用程式成品。例如，當您解壓縮 BankDemo 範例時，其具有下列結構： ``` demo |--> jcl |--> RDEF |--> transaction |--> xa ``` + 建立並啟動執行 PostgreSQL 的 Amazon RDS 執行個體。此執行個體將存放 Enterprise Analyzer 產生的資料和結果。您可以與應用程式團隊的所有成員共用此執行個體。此外，在資料庫中建立名為 `m2_ea`（或任何其他適當名稱） 的空白結構描述。定義授權使用者的登入資料，允許他們建立、插入、更新和刪除此結構描述中的項目。您可以從 Amazon RDS 主控台或帳戶管理員取得資料庫名稱、其伺服器端點 URL 和 TCP 連接埠。 + 請確定您已設定 的程式設計存取權 AWS 帳戶。如需詳細資訊，請參閱 中的[程式設計存取](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)*Amazon Web Services 一般參考。* ## 步驟 1：設定 1. 使用您在 WorkSpaces 應用程式歡迎電子郵件訊息中收到的 URL 啟動 WorkSpaces 應用程式的工作階段。 1. 使用您的電子郵件做為您的使用者 ID，並定義您的永久密碼。 1. 選取 Enterprise Analyzer 堆疊。 1. 在 WorkSpaces 應用程式選單頁面上，選擇**桌面**以連接機群正在串流的 Windows 桌面。 ## 步驟 2：在 Windows 上建立以 Amazon S3 為基礎的虛擬資料夾 **注意** 如果您已在 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：建立 Amazon RDS 執行個體的 ODBC 來源 1. 若要啟動 EA\$1Admin 工具，請導覽至瀏覽器視窗左上角的應用程式選擇器選單，然後選擇 **MF EA\$1Admin**。 1. 從**管理員**功能表中，選擇 **ODBC 資料來源**，然後從**使用者 DSN** 索引標籤選擇**新增**。 1. 在建立新的資料來源對話方塊中，選擇 **PostgreSQL Unicode** 驅動程式，然後選擇**完成**。 1. 在 **PostgreSQL Unicode ODBC 驅動程式 (psqlODBC) 設定**對話方塊中，定義並記下您想要的資料來源名稱。使用您先前建立之 RDS 執行個體的值完成下列參數： **Description** 選用描述，協助您快速識別此資料庫連線。 **資料庫** 您先前建立的 Amazon RDS 資料庫。 **Server** Amazon RDS 端點。 **站點** Amazon RDS 連接埠。 **使用者名稱** 如 Amazon RDS 執行個體中所定義。 **密碼** 如 Amazon RDS 執行個體中所定義。 1. 選擇**測試**以驗證與 Amazon RDS 的連線是否成功，然後選擇**儲存**以儲存您的新使用者 DSN。 1. 等到您看到確認建立適當工作區的訊息，然後選擇**確定**完成 ODBC 資料來源，然後關閉 EA\$1Admin 工具。 1. 再次導覽至應用程式選擇器選單，然後選擇 Enterprise Analyzer 以啟動工具。選擇**建立新項目**。 1. 在工作區組態視窗中，輸入您的工作區名稱並定義其位置。如果您在此組態下工作，工作區可以是 Amazon S3 型磁碟，或者如果您願意，也可以是主資料夾。 1. 選擇**選擇其他資料庫**以連線至您的 Amazon RDS 執行個體。 1. 從選項中選擇 **Postgre** 圖示，然後選擇**確定**。 1. 針對**選項 – 定義連線參數**下的 Windows 設定，輸入您建立的資料來源名稱。同時輸入資料庫名稱、結構描述名稱、使用者名稱和密碼。選擇**確定**。 1. 等待 Enterprise Analyzer 建立所有資料表、索引等，以便儲存結果。此程序可能需要幾分鐘的時間。Enterprise Analyzer 會確認資料庫和工作區何時可供使用。 1. 再次導覽至應用程式選擇器選單，然後選擇 Enterprise Analyzer 以啟動工具。 1. Enterprise Analyzer 啟動視窗會顯示在新的所選工作區位置。選擇**確定**。 1. 導覽至左側窗格中的儲存庫，選取儲存庫名稱，然後選擇**將檔案/資料夾新增至工作區**。選取存放應用程式碼的資料夾，將其新增至工作區。您可以視需要使用先前的 BankDemo 範例程式碼。當 Enterprise Analyzer 提示您驗證這些檔案時，請選擇**驗證**以啟動初始 Enterprise Analyzer 驗證報告。視您的應用程式大小而定，可能需要幾分鐘的時間才能完成。 1. 展開您的工作區，以查看您已新增至工作區的檔案和資料夾。物件類型和循環複雜性報告也會顯示在**圖表檢視器**窗格的上象限中。 您現在可以針對所有必要的任務使用 Enterprise Analyzer。 ## 後續工作階段 1. 使用您在 WorkSpaces 應用程式歡迎電子郵件訊息中收到的 URL 啟動 WorkSpaces 應用程式的工作階段。 1. 使用您的電子郵件和永久密碼登入。 1. 選取 Enterprise Analyzer 堆疊。 1. 如果您使用此選項來共用工作區檔案，請啟動 `Rclone` 以連線至 Amazon S3 後端磁碟。 1. 啟動 Enterprise Analyzer 來執行您的任務。 ## 工作區連線故障診斷 當您嘗試重新連線至 Enterprise Analyzer 工作區時，您可能會看到如下錯誤： ``` Cannot access the workspace directory D:\PhotonUser\My Files\Home Folder\EA_BankDemo. The workspace has been created on a non-shared disk of the EC2AMAZ-E6LC33H computer. Would you like to correct the workspace directory location? ``` 若要解決此問題，請選擇**確定**以清除訊息，然後完成以下步驟。 1. 在 WorkSpaces 應用程式中，選擇工具列上的**啟動應用程式**圖示，然後選擇 **EA\$1Admin** 以啟動 Enterprise Analyzer 管理工具。 ![\[已選取 Rocket Enterprise Developer 管理工具的 WorkSpaces 應用程式啟動選擇器功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-launch-selector.png) 1. 從**管理員**功能表中，選擇**重新整理工作區路徑...**。 ![\[選取重新整理工作區路徑時，管理 Rocket Enterprise Analyzer 管理工具的功能表。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-administer-refresh.png) 1. 在**選取工作區**下，選擇您想要的工作區，然後選擇**確定**。 ![\[選取專案時 Rocket Enterprise Analyzer 管理工具的選取工作區對話方塊。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-select-workspace.png) 1. 選擇**確定**以確認錯誤訊息。 ![\[已選取 OK 的 Enterprise Analyzer 錯誤訊息「無法存取工作區目錄」。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-select-workspace-error.png) 1. 在**工作區目錄網路路徑**下，輸入工作區的正確路徑，例如 `D:\PhotonUser\My Files\Home Folder\EA\MyWorkspace3`。 ![\[Enterprise Analyzer 對話方塊具有範例路徑的工作區目錄網路路徑。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-workspace-directory-network-path.png) 1. 關閉 Micro Focus Enterprise Analyzer 管理工具。 ![\[已選取關閉按鈕的 Micro Focus Enterprise Analyzer 管理工具。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ea_admin-close.png) 1. 在 WorkSpaces 應用程式中，選擇工具列上的**啟動應用程式**圖示，然後選擇 **EA** 以啟動 Micro Focus Enterprise Analyzer。 ![\[已選取 EA 的 WorkSpaces 應用程式啟動應用程式圖示。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/aas-launch-ea.png) 1. 重複步驟 3 - 5。 Micro Focus Enterprise Analyzer 現在應使用現有的工作區開啟。 ## 清除資源 如果您不再需要為本教學課程建立的資源，請將其刪除，以免產生進一步的費用。請完成下列步驟： + 使用 **EA\$1Admin** 工具刪除工作區。 + 刪除您為此教學課程建立的 S3 儲存貯體。如需詳細資訊，請參閱《Amazon S3 使用者指南》**中的[刪除儲存貯體](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)。 + 刪除您為此教學課程建立的資料庫。如需詳細資訊，請參閱[刪除資料庫執行個體](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)。 # 教學課程：在 WorkSpaces 應用程式上設定 Rocket Enterprise Developer 本教學課程說明如何為一或多個大型主機應用程式設定 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) ## 影像內容 除了企業開發人員本身之外，映像還包含 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) ## 先決條件 + 一或多個 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：由個別企業開發人員使用者設定 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 型虛擬資料夾 （選用） 如果需要 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：複製儲存庫 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 環境中執行補充測試。 ## 後續工作階段 當您選取 WorkSpaces 應用程式管理下的資料夾時，例如複製 CodeCommit 儲存庫的主資料夾，它將在工作階段之間透明地儲存和還原。下次您需要使用應用程式時，請完成下列步驟： 1. 根據歡迎電子郵件中收到的 URL，使用 WorkSpaces 應用程式啟動工作階段。 1. 使用您的電子郵件和永久密碼登入。 1. 選取企業開發人員堆疊。 1. 當此選項用於共用工作區檔案時，啟動 `Rclone` 以連線至 （請參閱上述） Amazon S3 後端磁碟。 1. 啟動企業開發人員來執行您的工作。 ## 清除資源 如果您不再需要為本教學課程建立的資源，請將其刪除，這樣就不會繼續收取這些資源的費用。請完成下列步驟： + 刪除您為此教學課程建立的 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)。