

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)。

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

# 教學課程：為大型主機的 AWS Transform 設定受管執行期
<a name="tutorial-runtime-ba"></a>

您可以使用本教學課程中指定的示範應用程式，將大型主機現代化應用程式的 AWS 轉換部署至 AWS 大型主機現代化執行期環境。

**Topics**
+ [先決條件](#tutorial-runtime-ba-prerequisites)
+ [步驟 1：上傳示範應用程式](#tutorial-runtime-ba-step1)
+ [步驟 2：建立應用程式定義](#tutorial-runtime-ba-step2)
+ [步驟 3：建立執行時間環境](#tutorial-runtime-ba-step3)
+ [步驟 4：建立應用程式](#tutorial-runtime-ba-step4)
+ [步驟 5：部署應用程式](#tutorial-runtime-ba-step5)
+ [步驟 6：啟動應用程式](#tutorial-runtime-ba-step6)
+ [步驟 7：存取應用程式](#tutorial-runtime-ba-step7)
+ [步驟 8：測試應用程式](#tutorial-runtime-ba-test)
+ [清除資源](#tutorial-runtime-ba-clean)

## 先決條件
<a name="tutorial-runtime-ba-prerequisites"></a>

若要完成本教學課程，請下載示範應用程式封存 [PlanetsDemo-v4.zip。](https://d2azvcayevmroy.cloudfront.net/tutorials/bluage/PlanetsDemo-v4.zip)

執行中的示範應用程式需要現代瀏覽器才能存取。無論您是從桌面還是從 Amazon Elastic Compute Cloud 執行個體執行此瀏覽器，例如在 VPC 中， 都會決定您的安全設定。

## 步驟 1：上傳示範應用程式
<a name="tutorial-runtime-ba-step1"></a>

將示範應用程式上傳至 Amazon S3 儲存貯體。請確定此儲存貯體與您部署應用程式 AWS 區域 的位置相同。下列範例顯示名為 **planets-demo** 的儲存貯體，其中包含名為 **v1** 的金鑰字首或資料夾，以及名為 的封存`planetsdemo-v4.zip`。

![\[Amazon S3 中的 PlanetsDemo 儲存貯體，顯示 v1 字首和 planetsdemo-v4.zip 檔案。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/s3-ba-bucket.png)


**注意**  
儲存貯體中的 資料夾為必要項目。

## 步驟 2：建立應用程式定義
<a name="tutorial-runtime-ba-step2"></a>

若要將應用程式部署到受管執行期，您需要 AWS Mainframe Modernization 應用程式定義。此定義是描述應用程式位置和設定的 JSON 檔案。下列範例是示範應用程式的這類應用程式定義：

```
{
    "template-version": "2.0",
    "source-locations": [{
        "source-id": "s3-source",
        "source-type": "s3",
        "properties": {
            "s3-bucket": "planets-demo",
            "s3-key-prefix": "v1"
        }
    }],
    "definition": {
        "listeners": [{
            "port": 8196,
            "type": "http"
        }],
        "ba-application": {
            "app-location": "${s3-source}/PlanetsDemo-v4.zip"
        }
    }
}
```

將`s3-bucket`項目變更為範例應用程式 zip 檔案的名稱 （例如 `planets-demo`)，並將`app-location`項目變更為您存放範例應用程式 zip 檔案的 S3 路徑 （例如 `${s3-source}/PlanetsDemo-v4.zip`)。

**注意**  
請務必在本機上將應用程式定義檔案建立為文字檔案。

如需應用程式定義的詳細資訊，請參閱 [AWS 大型主機應用程式定義範例的轉換](applications-m2-definition.md#applications-m2-definition-ba)。

## 步驟 3：建立執行時間環境
<a name="tutorial-runtime-ba-step3"></a>

若要建立 AWS Mainframe Modernization 執行時間環境，請執行下列步驟：

1. 開啟 [AWS Mainframe Modernization 主控台](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing)。

1. 在 AWS 區域 選擇器中，選擇您要建立環境的區域。這 AWS 區域 必須符合您在 中建立 S3 儲存貯體的區域[步驟 1：上傳示範應用程式](#tutorial-runtime-ba-step1)。

1. 在**現代化大型主機應用程式**下，選擇**使用大型主機的 AWS 轉換重構**，然後選擇**開始使用**。  
![\[針對大型主機使用選取的重構 AWS 轉換來現代化大型主機應用程式區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-get-started.png)

1. 在 **AWS Mainframe Modernization 說明**下，選擇**部署**和**建立執行時間環境**。  
![\[您要如何從選取部署和建立執行時間環境 AWS 的 Mainframe Modernization 區段開始。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/update-m2-ba-deploy-create-env.png)

1. 在左側導覽中，選擇**環境**，然後選擇**建立環境**。在**指定基本資訊**頁面上，輸入您環境的名稱和描述，然後確定已選取 **AWS Blu Age** 引擎。或者，您可以將標籤新增至建立的資源。然後選擇**下一步**。  
![\[AWS 大型主機現代化 在選取大型主機引擎的 AWS 轉換時指定基本資訊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-env-basic.png)

1. 在**指定組態**頁面上，選擇**獨立執行期環境**。  
![\[已選取獨立執行時間環境 AWS 的主要主機現代化可用性區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-config-avail.png)

1. 在**安全性和網路**下，進行下列變更：
   + 選擇**允許部署到此環境的應用程式可公開存取**。此選項會將公有 IP 地址指派給應用程式，以便您可以從桌面存取它。
   + 選擇 VPC。您可以使用**預設值**。
   + 選擇兩個子網路。請確定子網路允許指派公有 IP 地址。
   + 選擇安全群組。您可以使用**預設值**。請確定您選擇的安全群組允許從瀏覽器 IP 地址存取您在應用程式定義的 `listener` 屬性中指定的連接埠。如需詳細資訊，請參閱[步驟 2：建立應用程式定義](#tutorial-runtime-ba-step2)。  
![\[已選取預設 VPC 和兩個子網路的安全和網路區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-security-network.png)

   如果您想要從您選擇的 VPC 外部存取應用程式，請確定該 VPC 的傳入規則已正確設定。如需詳細資訊，請參閱[故障診斷錯誤：無法存取應用程式 URL](both-application-connectivity.md)。

1. 選擇**下一步**。

1. 在**連接儲存 - 選用**中，保留預設選擇，然後選擇**下一步**。  
![\[套用預設值的連接儲存頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-attach-storage.png)

1. 在**排程維護**中，選擇**無偏好設定**，然後選擇**下一步**。

1. 在**檢閱和建立**中，檢閱資訊，然後選擇**建立環境**。

## 步驟 4：建立應用程式
<a name="tutorial-runtime-ba-step4"></a>

1. 導覽至 中的 **AWS Mainframe Modernization** AWS 管理主控台。

1. 在導覽窗格中，選擇 **Applications** (應用程式)，然後選擇 **Create application** (建立應用程式)。在**指定基本資訊**頁面上，輸入應用程式的名稱和描述，並確認已選取**大型主機引擎的 AWS AWS 轉換**。然後選擇**下一步**。  
![\[應用程式 指定基本資訊頁面，並選取大型主機引擎的 AWS 轉換。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-app-basic.png)

1. 在**指定資源和組態**頁面上，複製並貼上您在 中建立的更新應用程式定義 JSON[步驟 2：建立應用程式定義](#tutorial-runtime-ba-step2)。  
![\[貼上更新應用程式定義 JSON 的資源和組態區段。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-resources-configs.png)

1. 在**檢閱和建立**中，檢閱您的選擇，然後選擇**建立應用程式**。
**注意**  
如果您的應用程式建立失敗，請檢查您輸入的 S3 路徑，因為它區分大小寫。

## 步驟 5：部署應用程式
<a name="tutorial-runtime-ba-step5"></a>

成功建立 AWS Mainframe Modernization 執行期環境和應用程式，且兩者都處於**可用**狀態後，您可以將應用程式部署到執行期環境。若要執行此動作，請執行下列步驟。

1. 在 AWS 管理主控台中導覽至 **AWS Mainframe Modernization**。在導覽窗格中，選擇 **Environments (環境)**。隨即顯示環境清單頁面。  
![\[AWS Mainframe Modernization 執行時間環境清單。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-environments.png)

1. 選擇先前建立的執行時間環境。環境詳細資訊頁面隨即顯示。

1. 選擇**部署應用程式**。  
![\[planets-demo-env 環境的環境詳細資訊頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-env-details-planets.png)

1. 選擇先前建立的應用程式，然後選擇您要部署應用程式的版本。然後選擇 **Deploy (部署)**。  
![\[大型 AWS 主機現代化部署應用程式頁面，並顯示行星示範應用程式。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-app-deploy.png)

1. 等待應用程式完成部署。您將看到橫幅，其中包含**應用程式已成功部署**的訊息。

## 步驟 6：啟動應用程式
<a name="tutorial-runtime-ba-step6"></a>

1. 導覽至 中的 **AWS Mainframe Modernization**， AWS 管理主控台 然後選擇**應用程式**。

1. 選擇您的應用程式，然後前往**部署**。應用程式的狀態應該**成功**。  
![\[AWS 大型主機現代化部署頁面顯示成功部署狀態。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/m2-ba-app-deployments-succeeded.png)

1. 選擇**動作**，然後選擇**啟動應用程式**。

## 步驟 7：存取應用程式
<a name="tutorial-runtime-ba-step7"></a>

1. 等到應用程式處於**執行**中狀態。您將看到橫幅，其中包含**應用程式已成功啟動**的訊息。

1. 複製應用程式 DNS 主機名稱。您可以在**應用程式的應用程式資訊**區段中找到此主機名稱。

1. 在瀏覽器中，導覽至 `http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/`，其中：
   + `hostname` 是先前複製的 DNS 主機名稱。
   + `portname` 是您在 中建立的應用程式定義中定義的 Tomcat 連接埠[步驟 2：建立應用程式定義](#tutorial-runtime-ba-step2)。

   JICS 畫面隨即出現。  
![\[JICS 交易啟動器頁面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ba-jics-launcher.png)

如果您無法存取應用程式，請參閱 [故障診斷錯誤：無法存取應用程式 URL](both-application-connectivity.md)。

**注意**  
如果應用程式無法存取，且安全群組上的傳入規則已在連接埠 8196 上選取「我的 IP」，請指定規則以允許連接埠 8196 上來自 LB i/p 的流量。

## 步驟 8：測試應用程式
<a name="tutorial-runtime-ba-test"></a>

在此步驟中，您會在遷移的應用程式中執行交易。

1. 在 JICS 畫面上，`PINQ`在輸入欄位中輸入 ，然後選擇**執行** （或按 Enter) 以啟動應用程式交易。

   示範應用程式畫面應會出現。  
![\[插入模式中的 PlanetsDemo 應用程式畫面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ba-demo-app-screen.png)

1. 在對應的欄位中輸入行星名稱，然後按 Enter 鍵。  
![\[在PlanetsDemo應用程式畫面。\]](http://docs.aws.amazon.com/zh_tw/m2/latest/userguide/images/ba-demo-with-data.png)

   您應該會看到有關地球的詳細資訊。

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

如果您不再需要為本教學課程建立的資源，請將其刪除以避免額外費用。若要這樣做，請完成下列步驟：
+ 如果 AWS Mainframe Modernization 應用程式仍在執行中，請將其停止。
+ 刪除 應用程式。如需詳細資訊，請參閱[刪除 AWS Mainframe Modernization 應用程式](applications-m2-delete.md)。
+ 刪除執行時間環境。如需詳細資訊，請參閱[刪除 AWS 大型主機現代化執行期環境刪除執行時間環境](delete-environments-m2.md)。