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)」を参照してください。
翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。
# チュートリアル: WorkSpaces アプリケーションでメインフレーム開発者の AWS 変換を使用する
このチュートリアルでは、WorkSpaces アプリケーションでメインフレーム開発者の AWS 変換にアクセスし、それをサンプルアプリケーションで使用して、機能を試す方法について説明します。このチュートリアルを終了すると、同じ手順を独自のアプリケーションで使用できます。
**Topics**
+ [ステップ 1: データベースを作成する](#tutorial-ba-developer-create-db)
+ [ステップ 2: 環境にアクセスする](#tutorial-ba-developer-access-env)
+ [ステップ 3: ランタイムを設定する](#tutorial-ba-developer-set-up-runtime)
+ [ステップ 4: Eclipse IDE を起動する](#tutorial-ba-developer-start-eclipse)
+ [ステップ 5: Maven プロジェクトをセットアップする](#tutorial-ba-developer-set-up-maven)
+ [ステップ 6: Tomcat サーバーを設定する](#tutorial-ba-developer-config-tomcat)
+ [ステップ 7: Tomcat にデプロイする](#tutorial-ba-developer-deploy-tomcat)
+ [ステップ 8: JICS データベースを作成する](#tutorial-ba-developer-create-jics)
+ [ステップ 8: アプリケーションの起動とテスト](#tutorial-ba-developer-test-app)
+ [ステップ 10: アプリケーションをデバッグする](#tutorial-ba-developer-debug)
+ [リソースをクリーンアップする](#tutorial-ba-developer-clean)
## ステップ 1: データベースを作成する
このステップでは、Amazon RDS を使用して、デモアプリケーションが設定情報を保存するために使用するマネージド PostgreSQL データベースを作成します。
1. Amazon RDS コンソールを開きます。
1. **[データベース] > [データベースの作成]** を選択します。
1. **[標準作成] > [PostgreSQL]** を選択し、デフォルトバージョンのままにして、**[無料利用枠]** を選択します。
1. DB インスタンス識別子を選択します。
1. **[認証情報の設定]** で、**[ AWS Secrets Managerでのマスター資格情報の管理]** を選択します。詳細については、「Amazon RDS ユーザーガイド」の「[Amazon RDS および AWS Secrets Managerでのパスワード管理](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/rds-secrets-manager.html)」を参照してください。**
1. VPC が WorkSpaces アプリケーションインスタンスに使用するものと同じであることを確認します。この値は管理者に問い合わせることができます。
1. **[VPC セキュリティグループ]** で、**[新規作成]** を選択します。
1. **[パブリックアクセス]** を **[はい]** に設定します。
1. 他はすべてデフォルト値のままにしておきます。これらの値を確認してください。
1. **[データベースの作成]** を選択します。
インスタンスからデータベースサーバーにアクセスできるようにするには、Amazon RDS のデータベースサーバーを選択します。**[接続とセキュリティ]** で、データベースサーバーの VPC セキュリティグループを選択します。このセキュリティグループは以前に作成したもので、**RDS マネジメントコンソールで作成**の説明と類似の説明が付いているはずです。**[アクション] > [インバウンドルールの編集]** を選択し、**[ルールを追加]** を選択して、**PostgreSQL** タイプのルールを作成します。ルールソースには、セキュリティグループの**デフォルト**を使用します。最初に **[ソース]** フィールドにソース名を入力し、提示された ID を受け入れます。最後に、**[ルールを保存]** を選択します。
## ステップ 2: 環境にアクセスする
このステップでは、WorkSpaces アプリケーションのメインフレーム開発環境の AWS 変換にアクセスします。
1. WorkSpaces アプリケーションインスタンスに適切なアクセス方法については、管理者にお問い合わせください。可能なクライアントと設定の一般的な情報については、「Amazon [WorkSpaces アプリケーション管理ガイド」の「WorkSpaces アプリケーションアクセス方法とクライアント](https://docs.aws.amazon.com/appstream2/latest/developerguide/clients-access-methods-user.html)」を参照してください。 *Amazon WorkSpaces * 最適なエクスペリエンスを得るには、ネイティブクライアントの使用を検討してください。
1. WorkSpaces Applications で **Desktop** を選択します。
## ステップ 3: ランタイムを設定する
このステップでは、メインフレームランタイムの AWS 変換を設定します。初回起動時にランタイムを設定し、ランタイムのアップグレードを通知された場合は再度設定する必要があります。このステップにより `.m2` フォルダにデータが入力されます。
1. メニューバーから **[アプリケーション]** を選択し、**[ターミナル]** を選択します。
1. 次のコマンドを入力します。
```
~/_install-velocity-runtime.sh
```
## ステップ 4: Eclipse IDE を起動する
このステップでは、Eclipse IDE を起動し、ワークスペースを作成する場所を選択します。
1. WorkSpaces Applications で、ツールバーのアプリケーション起動アイコンを選択し、**Eclipse JEE** を選択します。
![\[WorkSpaces Applications のツールバーでアプリケーションを起動するアイコン。Eclipse JEE が選択されています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-ba-eclipse.png)
1. ランチャーが開いたら、ワークスペースを作成する場所を入力し、**[起動する]** を選択します。
![\[AWS Transform for mainframe WorkSpaces Applications の Eclipse IDE ランチャー。ワークスペースが選択されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-launcher.png)
オプションで、以下のように Eclipse をコマンドラインから起動できます。
```
~/eclipse &
```
## ステップ 5: Maven プロジェクトをセットアップする
このステップでは、Planets デモアプリケーション用の Maven プロジェクトをインポートします。
1. [PlanetsDemo-pom.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-pom.zip) をホームフォルダにアップロードします。これには、ネイティブクライアントの「My Files」機能を使用できます。
1. `unzip` コマンドラインツールを使用してファイルを抽出します。
1. 解凍したフォルダ内に移動し、テキストエディタでプロジェクトのルート `pom.xml` を開きます。
1. `gapwalk.version` プロパティを編集して、インストールされているメインフレームランタイムの AWS 変換と一致するようにします。
インストールされているバージョンがわからない場合は、ターミナルで次のコマンドを実行します。
```
cat ~/runtime-version.txt
```
このコマンドは、現在利用可能なランタイムバージョン (例: `3.1.0-b3257-dev`) を出力します。
**注記**
`gapwalk.version` に `-dev` サフィックスを含めないでください。例えば、有効な値は `3.1.0-b3257` となります。
1. Eclipse で、**[ファイル]**、**[インポート]** の順に選択します。**[インポート]** ダイアログウィンドウで **Maven** を展開し、**[既存の Maven プロジェクト]** を選択します。**[次へ]** をクリックします。
1. **[Maven プロジェクトのインポート]** で、抽出したファイルの場所を指定し、**[完了]** を選択します。
次のポップアップは無視しても問題ありません。Maven は `node.js` のローカルコピーをダウンロードして、プロジェクトの Angular (\$1-web) 部分をビルドします。
![\[node.js が見つからないという警告メッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-node-warning.png)
ビルドが終了するまでお待ちください。**[進行状況]** ビューでビルドをフォローできます。
1. Eclipse では、プロジェクトを選択し、**[として実行]** を選択します。次に、**[Maven インストール]** を選択します。Maven のインストールが成功すると、`PlanetsDemoPom/PlanetsDemo-web/target/PlanetsDemo-web-1.0.0.war` の下に `war` ファイルが作成されます。
## ステップ 6: Tomcat サーバーを設定する
このステップでは、コンパイルしたアプリケーションをデプロイして起動する Tomcat サーバーを設定します。
1. Eclipse では、**[ウィンドウ] > [ビューを表示] > [サーバー]** を選択して **[サーバー]** ビューを表示します。
![\[AWS サーバービューが選択されたメインフレーム Eclipse の変換。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-servers.png)
1. **[利用可能なサーバーはありません] を選択します。このリンクをクリックして新しいサーバーを作成します...**。**新しいサーバー** ウィザードが表示されます。ウィザードの **[サーバーの種類の選択]** フィールドに「**tomcat v9**」と入力し、**[Tomcat v9.0 サーバー]** を選択します。次いで、**[次へ]** を選択します。
![\[[新しいサーバー] ダイアログボックス。Tomcat v9.0 サーバーが選択されています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-new-server.png)
1. **[閲覧]** を選択し、ホームフォルダのルートにある **[tomcat]** フォルダを選択します。JRE はデフォルト値のままにして、**[完了] **を選択します。
**Servers** プロジェクトがワークスペースに作成され、Tomcat v9.0 サーバーが **[サーバー]** ビューに表示されるようになりました。コンパイルされたアプリケーションはここでデプロイされ、起動されます。
![\[AWS 新しい Tomcat サーバーが一覧表示されたメインフレーム Eclipse Servers タブの変換。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-server-added.png)
## ステップ 7: Tomcat にデプロイする
このステップでは、Planets デモアプリケーションを Tomcat サーバーにデプロイして、アプリケーションを実行できるようにします。
1. `PlanetsDemo-web` ファイルを選択し、**[として実行] > [Maven インストール]** を選択します。`PlanetsDemo-web` をもう一度選択して **[更新]** を選択し、npm でコンパイルされたフロントエンドが .war に正しくコンパイルされ、Eclipse に認識されていることを確認します。
1. [PlanetsDemo-runtime.zip](https://d3lkpej5ajcpac.cloudfront.net/appstream/bluage/developer-ide/PlanetsDemo/PlanetsDemo-runtime.zip) をインスタンスにアップロードし、アクセス可能な場所でファイルを解凍します。これにより、デモアプリケーションは必要な設定フォルダとファイルにアクセスできるようになります。
1. `PlanetsDemo-runtime/tomcat-config` の内容を Tomcat サーバー用に作成した `Servers/Tomcat v9.0...` サブフォルダにコピーします。
![\[AWS メインフレーム Eclipse Tomcat v9.0 サブフォルダとそれに含まれるファイルの変換。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-tomcat-subfolder.png)
1. [サーバー] ビューで `tomcat v9.0` サーバーエントリを開きます。サーバープロパティエディタが表示されます。
![\[サーバープロパティエディタ。[概要] タブが選択されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-server-properties-editor.png)
1. 次に示すように、**[概要]** タブで、[開始] の **[タイムアウト]** の値を 450 秒、[停止] を 150 秒に増やします。
![\[開始タイムアウト値を 450 秒に設定します。停止タイムアウト値を 150 秒に設定します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-timeout-values.png)
1. **[起動設定を開く]** を選択します。ウィザードが表示されます。ウィザードで **[引数]** フォルダに移動し、**[作業ディレクトリ]** に **[その他]** を選択します。**[ファイルシステム]** を選択し、先ほど解凍した `PlanetsDemo-runtime` フォルダに移動します。このフォルダには、**config** という直接のサブフォルダが含まれています。
![\[[設定を編集] ダイアログボックスには、[その他] フィールドで指定された作業ディレクトリが表示されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-edit-configuration.png)
1. サーバープロパティエディタの **[モジュール]** タブを選択し、以下の変更を行います。
+ **[ウェブモジュールを追加]** を選択し、`PlanetsDemo-service` を追加します。
+ **[外部ウェブモジュールを追加]** を選択します。**[ウェブモジュールを追加]** ダイアログウィンドウが表示されます。以下の変更を加えます。
+ **[ドキュメントベース]** で、**[閲覧]** を選択し、`~/webapps/gapwalk-application...war` に移動します。
+ **[パス]** に、`/gapwalk-application` を入力します。
+ [OK] をクリックします。
+ もう一度 **[外部ウェブモジュールを追加]** を選択し、次の変更を行います。
+ **[ドキュメントベース]** には、フロントエンドの (`PlanetsDemo-web/target` にある) .war へのパスを入力します。
+ **[パス]** には、`/demo` を入力します。
+ [OK] をクリックします。
+ エディタの変更を保存します (Ctrl \$1 S)。
これで、エディタの内容は、以下のようになります。
![\[Tomcat サーバープロパティの [ウェブモジュール] タブに、モジュールが一覧表示されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-web-modules.png)
## ステップ 8: JICS データベースを作成する
このステップでは、[ステップ 1: データベースを作成する](#tutorial-ba-developer-create-db) で作成したデータベースに接続します。
1. WorkSpaces Applications インスタンスから、ターミナルで次のコマンドを発行して を起動します`pgAdmin`。
```
./pgadmin-start.sh
```
1. ログイン識別子として email アドレスとパスワードを選択します。提供された URL (通常は http://127.0.0.1:5050) をメモしておきます。インスタンスで Google Chrome を起動し、URL をコピーしてブラウザに貼り付け、ユーザーの ID を使用してログインします。
![\[pgAdmin ログインダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-pgadmin-login.png)
1. ログインしたら、**[新しいサーバーの追加]** を選択し、以前に作成したデータベースへの接続情報を次のように入力します。
![\[pgAdmin [サーバーの登録] ダイアログボックス。[接続] タブが選択されます。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-pgadmin-register-server.png)
1. データベースサーバーに接続したら、**[オブジェクト] > [作成] > [データベース]** を使用して、**jics** という名前の新しいデータベースを作成します。
1. デモアプリが使用したデータベース接続情報を編集します。この情報は `PlanetsDemo-runtime/config/application-main.yml` で定義されています。`jicsDs` エントリを検索します。`username` および `password` の値を取得するには、Amazon RDS コンソールでデータベースに移動します。**[設定]** タブの **[マスター認証情報 ARN]** で、**[Secrets Manager の管理]** を選択します。次に、Secrets Manager コンソールのシークレットで、**[シークレットの値を取得する]** を選択します。
## ステップ 8: アプリケーションの起動とテスト
このステップでは、Tomcat サーバーとデモアプリケーションを起動してテストできるようにします。
1. Tomcat サーバーと以前にデプロイしたアプリケーションを起動するには、「サーバー」ビューでサーバーエントリを選択し、**[開始]** を選択します。起動ログを表示するコンソールが表示されます。
1. **[サーバー]** ビューでサーバーの状態を確認するか、コンソールに「**[xxx] ミリ秒でサーバーが起動します**」というメッセージが表示されるまで待ちます。サーバーが起動したら、gapwalk-application が正しくデプロイされていることを確認します。そのためには、Google Chrome ブラウザで **http://localhost:8080/gapwalk-application** URL にアクセスします。次のように表示されます。
![\[jics アプリケーションが実行中であることを示す確認メッセージ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-jics-run-confirm.png)
1. デプロイされたアプリケーションのフロントエンドに Google Chrome の http://localhost:8080/demo からアクセスします。次の **[トランザクションランチャー]** ページが表示されます。
![\[[JICS トランザクションランチャー] ページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-jics-launcher.png)
1. アプリケーショントランザクションを開始するには、入力フィールドに `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)
## ステップ 10: アプリケーションをデバッグする
このステップでは、Eclipse の標準デバッグ機能を使用してテストします。これらの機能は、最新のアプリケーションを開発しているときに利用できます。
1. メインサービスクラスを開くには、Ctrl \$1 Shift \$1 T キーを押して `PlanetsinqProcessImpl` を入力します。
![\[PlanetSinqProcessImpl と入力された Eclipse の [オープンタイプ] ダイアログウィンドウ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ba-eclipse-open-type.png)
1. `searchPlanet` メソッドに移動し、そこにブレークポイントを設定します。
1. サーバー名を選択し、**[デバッグで再起動]** を選択します。
1. 前の手順を繰り返します。つまり、アプリケーションにアクセスし、惑星名を入力して Enter キーを押します。
Eclipse は `searchPlanet` メソッドのアプリケーションを停止します。これで調べることができます。
## リソースをクリーンアップする
このチュートリアル用に作成したリソースが不要になった場合は、追加料金の発生を避けるため、削除してください。以下のステップを実行します。
+ Planets アプリケーションがまだ実行中の場合は、終了させます。
+ [ステップ 1: データベースを作成する](#tutorial-ba-developer-create-db) で作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/USER_DeleteInstance.html)」を参照してください。