AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) は、新規のお客様に公開されなくなりました。 AWS Mainframe Modernization Service (マネージドランタイム環境エクスペリエンス) と同様の機能については、 AWS Mainframe Modernization Service (セルフマネージドエクスペリエンス) をご覧ください。既存のお客様は、通常どおりサービスを引き続き使用できます。詳細については、[AWS 「 Mainframe Modernization の可用性の変更](https://docs.aws.amazon.com/m2/latest/userguide/mainframe-modernization-availability-change.html)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# チュートリアル: メインフレームの AWS 変換用にマネージドランタイムを設定する
このチュートリアルで指定されたデモアプリケーションを使用して、メインフレームモダナイゼーションアプリケーションの AWS 変換を AWS Mainframe Modernization ランタイム環境にデプロイできます。
**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)
## 前提条件
このチュートリアルを完了するには、デモアプリケーションアーカイブ [PlanetsDemo-v4.zip](https://d2azvcayevmroy.cloudfront.net/tutorials/bluage/PlanetsDemo-v4.zip) をダウンロードします。
デモアプリケーションを実行するには、最新のブラウザが必要です。このブラウザをデスクトップから実行するか、VPC 内などの Amazon Elastic Compute Cloud インスタンスから実行するかによって、セキュリティ設定が決まります。
## ステップ 1: デモアプリケーションをアップロードする
Amazon S3 バケットにデモアプリケーションをアップロードします。このバケットがアプリケーションをデプロイする場所と同じ AWS リージョン にあることを確認します。次の例は、キープレフィックス を持つ **planets-demo** という名前のバケット、または **v1** という名前のフォルダと という名前のアーカイブを示しています`planetsdemo-v4.zip`。
![\[v1 プレフィックスと PlanetsDemo-v4.zip ファイルを示す Amazon S3 の PlanetsDemo バケット。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/s3-ba-bucket.png)
**注記**
バケット内のフォルダは必須です。
## ステップ 2: アプリケーション定義を作成する
マネージドランタイムにアプリケーションをデプロイするには、 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: ランタイム環境を作成する
AWS Mainframe Modernization ランタイム環境を作成するには、次の手順を実行します。
1. [AWS Mainframe Modernization コンソール](https://us-east-2.console.aws.amazon.com/m2/home?region=us-east-2#/landing)を開きます。
1. AWS リージョン セレクターで、環境を作成するリージョンを選択します。これは、 で S3 バケットを作成したリージョンと一致する AWS リージョン 必要があります[ステップ 1: デモアプリケーションをアップロードする](#tutorial-runtime-ba-step1)。
1. **メインフレームアプリケーションのモダナイズ**で、**メインフレームの AWS Transform によるリファクタ**リングを選択し、**開始**を選択します。
![\[メインフレームのリファクタリング AWS 変換を選択したメインフレームアプリケーションのモダナイズセクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-get-started.png)
1. **[AWS Mainframe Modernization はどのように役立つのか]** で、**[デプロイ]** と **[ランタイム環境を作成]** を選択します。
![\[デプロイとランタイム環境の作成が選択された AWS Mainframe Modernization セクションから開始する方法。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/update-m2-ba-deploy-create-env.png)
1. ナビゲーションペインで、**[環境]** を選択し、**[環境を作成]** を選択します。**[基本情報を指定]** ページで、環境の名前と説明を入力し、**AWS Blu Age** エンジンが選択されていることを確認します。オプションで、作成したリソースにタグを追加できます。次いで、**[次へ]** を選択します。
![\[AWS Mainframe Modernization メインフレームエンジンの AWS 変換を選択した状態で基本情報ページを指定します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-env-basic.png)
1. **[設定を指定]** ページで、**[スタンドアロンランタイム環境]** を選択します。
![\[スタンドアロンランタイム環境が選択されている AWS Mainframe Modernization の可用性セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-config-avail.png)
1. **[セキュリティとネットワーク]** で、以下の変更を行います。
+ **[この環境にデプロイされたアプリケーションをパブリックにアクセスできるようにする]** を選択します。このオプションでは、アプリケーションにパブリック IP アドレスを割り当てて、デスクトップからアクセスできるようにします。
+ VPC を選択してください。**[デフォルト]** を使用できます。
+ 2 つのサブネットを選択します。サブネットがパブリック IP アドレスの割り当てを許可していることを確認してください。
+ [セキュリティグループ] をクリックします。**[デフォルト]** を使用できます。選択したセキュリティグループが、ブラウザの IP アドレスからアプリケーション定義の `listener` プロパティで指定したポートへのアクセスを許可していることを確認してください。詳細については、「[ステップ 2: アプリケーション定義を作成する](#tutorial-runtime-ba-step2)」を参照してください。
![\[デフォルトの VPC と 2 つのサブネットが選択された状態の [セキュリティとネットワーク] セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-security-network.png)
選択した VPC の外部からアプリケーションにアクセスする場合は、その VPC のインバウンドルールが適切に設定されていることを確認してください。詳細については、「[エラーのトラブルシューティング: アプリケーション URL にアクセスできない](both-application-connectivity.md)」を参照してください。
1. **[次へ]** を選択します。
1. **[ストレージをアタッチ - オプション]** では、デフォルトの選択をそのままにして **[次へ]** を選択します。
![\[デフォルト値が適用された [ストレージをアタッチ] ページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-attach-storage.png)
1. **[メンテナンスをスケジュール]** で、**[指定なし]** を選択し、**[次へ]** を選択します。
1. **[確認して作成]** で情報を確認し、**[環境の作成]** を選択します。
## ステップ 4: アプリケーションを作成する
1. AWS マネジメントコンソールで **[AWS Mainframe Modernization]** に移動します。
1. ナビゲーションペインで、**[アプリケーション]** を選択し、**[アプリケーションを作成]** を選択します。**「基本情報を指定**」ページで、アプリケーションの名前と説明を入力し、**メインフレームエンジンの AWS 変換**が選択されていることを確認します。次いで、**[次へ]** を選択します。
![\[アプリケーション メインフレームエンジンの AWS 変換を選択した状態で基本情報ページを指定します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-app-basic.png)
1. **[リソースと設定を指定]** ページで、[ステップ 2: アプリケーション定義を作成する](#tutorial-runtime-ba-step2) で作成し手更新したアプリケーション定義 JSON をコピーして貼り付けます。
![\[更新したアプリケーション定義 JSON を貼り付けた [リソースと設定] セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-resources-configs.png)
1. **[確認と作成]** で選択内容を見直してから **[ウェブ ACL の作成]** を選択します。
**注記**
アプリケーションの作成に失敗した場合は、大文字と小文字が区別されるため、入力した S3 パスを確認してください。
## ステップ 5: アプリケーションをデプロイする
AWS Mainframe Modernization ランタイム環境とアプリケーションの両方を正常に作成し、両方が**使用可能**状態になったら、アプリケーションをランタイム環境にデプロイできます。そのためには、以下のステップを完了します。
1. AWS マネジメントコンソールで **AWS Mainframe Modernization** に移動します。ナビゲーションペインで **[環境]** を選択します。[環境] リストページが表示されます。
![\[AWS Mainframe Modernization ランタイム環境のリスト。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-environments.png)
1. 以前に作成したランタイム環境を選択します。[環境の詳細] ページが表示されます。
1. **[アプリケーションのデプロイ]** を選択します。
![\[planets-demo-env 環境の [環境の詳細] ページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-env-details-planets.png)
1. 前に作成したアプリケーションを選択し、アプリケーションをデプロイするバージョンを選択します。その後、**[デプロイ]** を選択します。
![\[AWS 「 Mainframe Modernization Deploy application」ページに planets デモアプリが表示されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-app-deploy.png)
1. アプリケーションがデプロイを完了するまでお待ちください。「**アプリケーションが正常にデプロイされました**」というメッセージのバナーが表示されます。
## ステップ 6: アプリケーションを開始する
1. で **AWS Mainframe Modernization** に移動 AWS マネジメントコンソール し、**アプリケーション**を選択します。
1. アプリケーションを選択してから、**[デプロイ]** に移動します。アプリケーションのステータスは **[成功]** になっているはずです。
![\[AWS Mainframe Modernization Deployments ページには、Succeeded のデプロイステータスが表示されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/m2-ba-app-deployments-succeeded.png)
1. **[アクション]** を選択してから、**[アプリケーションを開始]** を選択します。
## ステップ 7: アプリケーションにアクセスする
1. アプリケーションが **[実行中]** 状態になるまで待ちます。「**アプリケーションが正常に開始されました**」というメッセージのバナーが表示されます。
1. アプリケーションの DNS ホスト名をコピーします。このホスト名はアプリケーションの **[アプリケーション情報]** セクションにあります。
1. ブラウザで、`http://{hostname}:{portname}/PlanetsDemo-web-1.0.0/` に移動します。ここで:
+ `hostname` は以前にコピーした DNS ホスト名です。
+ `portname` は [ステップ 2: アプリケーション定義を作成する](#tutorial-runtime-ba-step2) で作成したアプリケーション定義で定義されている Tomcat ポートです。
JICS 画面が表示されます。
![\[[JICS トランザクションランチャー] ページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-jics-launcher.png)
アプリケーションにアクセスできない場合は、「[エラーのトラブルシューティング: アプリケーション URL にアクセスできない](both-application-connectivity.md)」を参照してください。
**注記**
アプリケーションにアクセスできず、セキュリティグループのインバウンドルールによりポート 8196 で「My IP」が選択されている場合は、ポート 8196 で LB i/p からのトラフィックを許可するルールを指定します。
## ステップ 8: アプリケーションをテストする
このステップでは、移行したアプリケーションでトランザクションを実行します。
1. JICS 画面で、入力フィールドで `PINQ` を入力し、**[実行]** を選択 (または Enter を押す) してアプリケーショントランザクションを開始します。
デモアプリ画面が表示されます。
![\[PlanetsDemo アプリケーション画面が挿入モードになっています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-demo-app-screen.png)
1. 対応するフィールドに惑星名を入力し、Enter キーを押します。
![\[PlanetsDemo アプリケーション画面では、[惑星名] フィールドに「地球」と入力されています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-demo-with-data.png)
惑星の詳細が表示されます。
## リソースをクリーンアップする
このチュートリアルのために作成したリソースが不要になった場合は、追加料金が発生しないように削除します。そのためには、以下のステップを実行します。
+ AWS Mainframe Modernization アプリケーションがまだ実行されている場合は、停止します。
+ アプリケーションを削除します。詳細については、「[AWS Mainframe Modernization アプリケーションを削除する](applications-m2-delete.md)」を参照してください。
+ ランタイム環境を削除します。詳細については、「[AWS Mainframe Modernization ランタイム環境を削除するランタイム環境を削除する](delete-environments-m2.md)」を参照してください。