

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)」を参照してください。

翻訳は機械翻訳により提供されています。提供された翻訳内容と英語版の間で齟齬、不一致または矛盾がある場合、英語版が優先します。

# Rocket Software (旧 Micro Focus) のチュートリアル
<a name="tutorials-mf"></a>

このセクションのチュートリアルは、 AWS Mainframe Modernization サービスの Rocket Software ランタイムエンジンでさまざまなタスクの設定を開始するのに役立ちます。これらのチュートリアルは、Rocket Enterprise Developer で テンプレートを使用してサンプルアプリケーションを設定し、Enterprise Analyzer を設定するためのものです。

**Topics**
+ [

# チュートリアル: BankDemo サンプルアプリケーションの Rocket Software (旧 Micro Focus) ビルドのセットアップ
](tutorial-build-mf.md)
+ [

# チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする
](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) ビルドのセットアップ
<a name="tutorial-build-mf"></a>

AWS Mainframe Modernization では、移行したアプリケーションのビルドと継続的インテグレーション/継続的デリバリー (CI/CD) パイプラインを設定できます。これらのビルドとパイプラインは AWS CodeBuild AWS CodeCommit、 と AWS CodePipeline を使用してこれらの機能を提供します。CodeBuild は完全マネージド型の構築サービスです。ソースコードのコンパイル、ユニットテストの実行、すぐにデプロイできるアーティファクトの生成を行います。CodeCommit は、Git リポジトリを AWS クラウドにプライベートに保存および管理できるようにするバージョン管理サービスです。CodePipeline は、ソフトウェアをリリースするために必要な手順のモデル化、視覚化、および自動化ができる継続的なデリバリーサービスです。

このチュートリアルでは、 AWS CodeBuild を使用して Amazon S3 から BankDemo サンプルアプリケーションのソースコードをコンパイルし、コンパイルしたコードを Amazon S3 にエクスポートする方法を示します。 Amazon S3 

AWS CodeBuild は、ソースコードをコンパイルし、テストを実行し、デプロイ可能なソフトウェアパッケージを生成するフルマネージドの継続的統合サービスです。CodeBuild では、パッケージ済みのビルド環境を使用するか、ご自分のビルドツールを使用するカスタムビルド環境を作成することができます。このデモシナリオでは 2 つ目のオプションを使用します。あらかじめパッケージ化された 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)

## 前提条件
<a name="tutorial-build-mf-prerequisites"></a>

このチュートリアルを開始する前に、次の前提条件を完了してください。
+ [BankDemo サンプルアプリケーション](https://d3lkpej5ajcpac.cloudfront.net/demo/mf/BANKDEMO-build.zip)をダウンロードし、フォルダに解凍します。ソースフォルダには、COBOL プログラム、コピーブック、定義が含まれています。JCL をビルドする必要はありませんが、参照用の JCL フォルダも含まれています。このフォルダには、ビルドに必要なメタファイルも含まれています。
+  AWS Mainframe Modernization コンソールで、**ツール** を選択します。**[分析、開発、およびアセットの構築]** で、**[ アカウントとアセットを共有する]** を選択します。

## ステップ 1: ビルドアセットを AWS アカウントと共有する
<a name="tutorial-build-mf-assets"></a>

このステップでは、特にアセットが使用されているリージョンで、ビルドアセットを AWS アカウントと共有します。

1. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) で AWS Mainframe Modernization コンソールを開きます。

1. 左側のナビゲーションで、**[ツール]** を選択します。

1. **分析、開発、アセットの構築**で、**アセットを自分の AWS アカウントと共有**を選択します。

**重要**  
ビルドを実行する予定のすべての AWS リージョンで、このステップを 1 回実行する必要があります。

## ステップ 2: Amazon S3 バケットを作成する
<a name="tutorial-build-mf-s3"></a>

このステップでは、2 つの Amazon S3 バケットを作成します。1 つ目はソースコードを保持する入力バケットで、もう 1 つはビルド出力を保持する出力バケットです。詳細については、「*Amazon S3 ユーザーガイド*」の「[Amazon S3 バケットの作成、設定、操作](https://docs.aws.amazon.com/AmazonS3/latest/userguide/creating-buckets-s3.html)」を参照してください。

1. 入力バケットを作成するには、Amazon S3 コンソールにログインし、**[バケットの作成]** を選択します。

1. **全般設定**で、バケットの名前を指定し、バケットを作成する AWS リージョン を指定します。名前の例は で`codebuild-regionId-accountId-input-bucket`、 `regionId`はバケット AWS リージョン の 、 `accountId`は ID AWS アカウント です。
**注記**  
米国東部 (バージニア北部) 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: ビルド仕様ファイルを作成する
<a name="tutorial-build-mf-spec"></a>

このステップでは、ビルド仕様ファイルを作成します。このファイルには、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_BUILD_ARN`、`$CODEBUILD_SRC_DIR/source`、`$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: ソースファイルをアップロードする
<a name="tutorial-build-mf-upload"></a>

このステップでは、BankDemo サンプルアプリケーションのソースコードを Amazon S3 入力バケットにアップロードします。

1. Amazon S3 コンソールにログインし、ナビゲーションペインで、**[バケット]** を選択します。次に、以前に作成した入力バケットを選択します。

1. **[オブジェクト]** で **[アップロード]** を選択します。

1. **[ファイルとフォルダ]** セクションで、**[ファイルを追加]** を選択します。

1. `BankDemo.zip` ファイルに移動して、選択します。

1. **アップロード** を選択します。

## ステップ 5: IAM ポリシーを作成する
<a name="tutorial-build-mf-IAM-policy"></a>

このステップでは、2 つの [IAM ポリシー](https://docs.aws.amazon.com/IAM/latest/UserGuide/access_policies.html)を作成します。1 つのポリシーは、 AWS Mainframe Modernization が Rocket Software ビルドツールを含む Docker イメージにアクセスして使用するためのアクセス許可を付与します。このポリシーはお客様向けにカスタマイズされていません。もう 1 つのポリシーは、 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-*-<region>-prod"
           }
       ]
   }
   ```

------

1. ポリシーの名前を指定します (`m2CodeBuildPolicy` など)。

**AWS Mainframe Modernization がバケットとログとやり取りできるようにするポリシーを作成するには**

1. IAM コンソールで、次のポリシー文書をコピーしてポリシーエディタに貼り付けます。を `regionId`に AWS リージョン、 を `accountId`に更新してください AWS アカウント。

1. ポリシーの名前を指定します (`BankdemoCodeBuildRolePolicy` など)。

## ステップ 6: IAM ロールを作成する
<a name="tutorial-build-mf-IAM-role"></a>

このステップでは、以前に作成した [IAM ポリシーをこの新しい IAM ロール](https://docs.aws.amazon.com/IAM/latest/UserGuide/id_roles.html)に関連付けた後、CodeBuild が AWS リソースとやり取りできるようにする新しい IAM ロールを作成します。

サービスロールの作成の詳細については、*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. **[アクセス許可を追加]** ページで **[次へ]** を選択してください。後でロールにポリシーを割り当てます。

1. **[ロールの詳細]** に、ロールの名前 (例: `BankdemoCodeBuildServiceRole`) を入力します。

1. **[信頼されたエンティティを選択]** で、ポリシードキュメントが以下のようになっていることを確認します。

------
#### [ JSON ]

****  

   ```
   {
             "Version":"2012-10-17",		 	 	 
             "Statement": [
               {
                 "Effect": "Allow",
                 "Principal": {
                   "Service": "codebuild.amazonaws.com"
                 },
                 "Action": "sts:AssumeRole"
               }
             ]
           }
   ```

------

1. [**ロールの作成**] を選択してください。

## ステップ 7: IAM ポリシーを IAM ロールにアタッチする
<a name="tutorial-build-mf-attach"></a>

このステップでは、前に作成した IAM ポリシーを `BankdemoCodeBuildServiceRole` IAM ロールにアタッチします。

1. IAM コンソールにログインし、左のナビゲーションペインで、**[ロール]** を選択します。

1. **[ロール]** で、前に作成したロールを選択します (`BankdemoCodeBuildServiceRole` など)。

1. **[アクセス許可ポリシー]** で、**[アクセス許可を追加]**、**[ポリシーをアタッチします]** の順に選択します。

1. **[その他の許可ポリシー]** で、以前に作成したポリシー (例: `m2CodeBuildPolicy` と `BankdemoCodeBuildRolePolicy`) を選択します。

1. **ポリシーのアタッチ** を選択します。

## ステップ 8: CodeBuild プロジェクトを作成する
<a name="tutorial-build-mf-create-project"></a>

このステップでは、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 Software v9 の場合: と入力します`673918848628.dkr.ecr.us-west-1.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`。Rocket Software v9 で別の AWS リージョンを使用している場合は、 を指定することもできます。<m2-region> は ` 673918848628.dkr.ecr.<m2-region>.amazonaws.com/m2-enterprise-build-tools:9.0.7.R1`Mainframe Modernization AWS サービスが利用可能な AWS リージョンです (例: `eu-west-3`)。
   + Rocket Software v8 の場合: Enter `673918848628.dkr.ecr.us-west-2.amazonaws.com/m2-enterprise-build-tools:8.0.9.R1`
   + Rocket Software v7 の場合: Enter `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: ビルドを開始する
<a name="tutorial-build-mf-start"></a>

このステップでは、ビルドを開始します。

1. CodeBuild コンソールにログインします。

1. ナビゲーションペインで、**[ビルドプロジェクト]** を選択します。

1. 以前に作成したビルドプロジェクト (例: `codebuild-bankdemo-project`) を選択します。

1. [**Start build**] を選択します。

このコマンドはビルドを開始します。ビルドは非同期で実行されます。コマンドの出力は、属性 ID を含む JSON です。この属性 ID は、開始したばかりのビルドの CodeBuild ビルド ID への参照です。コンソールで、ビルドのステータスを表示することができます。ビルド実行に関する詳細なログをコンソールで確認することもできます。詳細については、「*AWS CodeBuild ユーザーガイド*」の「[詳細なビルド情報を表示する](https://docs.aws.amazon.com/codebuild/latest/userguide/getting-started-build-log-console.html)」を参照してください。

現在のフェーズが完了すると、ビルドが正常に終了し、コンパイルされたアーティファクトが Amazon S3 で準備できたことを意味します。

## ステップ 10: 出力アーティファクトをダウンロードする
<a name="tutorial-build-mf-download-output"></a>

このステップでは、Amazon S3 から出力アーティファクトをダウンロードします。Rocket Software ビルドツールは、いくつかの異なる実行可能ファイルタイプを作成できます。このチュートリアルでは、共有オブジェクトを生成します。

1. Amazon S3 コンソールにログインします。

1. **[バケット]** role="bold"> セクションで、出力バケットの名前を選択します (例: `codebuild-regionId-accountId-output-bucket`)。

1. **[ダウンロード]** role="bold" を選択します。

1. ダウンロードした ファイルを解凍します。ターゲットフォルダに移動して、ビルドアーティファクトを確認します。これには `.so` Linux 共有オブジェクトが含まれます。

## リソースをクリーンアップする
<a name="tutorial-build-mf-clean"></a>

このチュートリアルのために作成したリソースが不要になった場合は、追加料金が発生しないように削除します。そのためには、以下のステップを実行します。
+ このチュートリアル用に作成した 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 ユーザーガイド*」の「[Delete a build project in CodeBuild](https://docs.aws.amazon.com/codebuild/latest/userguide/delete-project.html)」を参照してください。

# チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする
<a name="set-up-appstream-mf"></a>

AWS Mainframe Modernization は、Amazon WorkSpaces アプリケーションを通じていくつかのツールを提供します。WorkSpaces Applications は、フルマネージド型の安全なアプリケーションストリーミングサービスで、アプリケーションを書き換えることなくデスクトップアプリケーションをユーザーにストリーミングできます。WorkSpaces アプリケーションを使用すると、ユーザーは必要なアプリケーションにすぐにアクセスでき、選択したデバイスで応答性が高く滑らかなユーザーエクスペリエンスが得られます。WorkSpaces アプリケーションを使用してランタイムエンジン固有のツールをホストすると、お客様のアプリケーションチームはウェブブラウザから直接ツールを使用して、Amazon S3 バケットまたは CodeCommit リポジトリに保存されているアプリケーションファイルを操作できます。

WorkSpaces アプリケーションのブラウザサポートの詳細については、Amazon WorkSpaces アプリケーション管理ガイドの[「システム要件と機能サポート (Web ブラウザ)](https://docs.aws.amazon.com/appstream2/latest/developerguide/requirements-and-features-web-browser-admin.html)」を参照してください。 *Amazon WorkSpaces * 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 ツールをホストするように Amazon WorkSpaces アプリケーションフリートとスタックを設定する方法について説明します。Rocket Enterprise Analyzer は通常、評価フェーズで使用され、Rocket Enterprise Developer は通常、 AWS Mainframe Modernization アプローチの移行とモダナイズフェーズで使用されます。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)

## 前提条件
<a name="tutorial-aas-prerequisites"></a>
+ テンプレート [cfn-m2-appstream-fleet-ea-ed.yml](https://drm0z31ua8gi7.cloudfront.net/tutorials/mf/appstream/cfn-m2-appstream-fleet-ea-ed.yml) をダウンロードしてください。
+ デフォルト VPC とセキュリティグループの ID を取得します。詳細については、「*Amazon VPC ユーザーガイド*」の「[デフォルト VPC とデフォルトサブネット](https://docs.aws.amazon.com/vpc/latest/userguide/default-vpc.html)」を参照してください。デフォルトのセキュリティグループの詳細については、「*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 アプリケーションイメージを取得する
<a name="tutorial-aas-step1"></a>

このステップでは、Enterprise Analyzer および Enterprise Developer の WorkSpaces アプリケーションイメージを AWS アカウントと共有します。

1. [https://console.aws.amazon.com/m2/](https://us-west-2.console.aws.amazon.com/m2/home?region=us-west-2#/) で AWS Mainframe Modernization コンソールを開きます。

1. 左側のナビゲーションで、**[ツール]** を選択します。

1. **分析、開発、アセットの構築**で、**アセットを自分の AWS アカウントと共有**を選択します。

## ステップ 2: CloudFormation テンプレートを使用してスタックを作成する
<a name="tutorial-aas-step2"></a>

このステップでは、ダウンロードした CloudFormation テンプレートを使用して、Rocket Enterprise Analyzer を実行するための WorkSpaces アプリケーションスタックとフリートを作成します。後でこのステップを繰り返して、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 Mainframe Modernization pricing](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/ja_jp/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/ja_jp/m2/latest/userguide/images/cfn-specify-stack-details.png)

1. すべてをデフォルトのままにし、**[次へ]** を選択します。

1. **[レビュー]** で、すべてのパラメータが意図したとおりであることを確認します。

1. 一番下までスクロールし、**[AWS CloudFormation によって IAM リソースが作成される場合があることを承認します]** を選択し、**[スタックの作成]** を選択します。

スタックとフリートが作成されるまで 20～30 分かかります。**更新**を選択すると、発生した CloudFormation イベントを表示できます。

## ステップ 3: WorkSpaces アプリケーションでユーザーを作成する
<a name="tutorial-aas-step3"></a>

がスタックの作成を完了する CloudFormation のを待っている間に、WorkSpaces アプリケーションで 1 人以上のユーザーを作成できます。これらのユーザーは、WorkSpaces アプリケーションで Enterprise Analyzer を使用するユーザーです。各ユーザーの E メールアドレスを指定し、各ユーザーが Amazon S3 でバケットを作成し、バケットにファイルをアップロードし、バケットにリンクして内容をマッピングするための十分なアクセス許可を持っていることを確認する必要があります。

1. WorkSpaces アプリケーションコンソールを開きます。

1. 左側のナビゲーションで、**[ユーザープール]** を選択します。

1. **[ユーザーの作成]** を選択します。

1. ユーザーが WorkSpaces アプリケーションを使用するための招待メールを受信できる E メールアドレス、姓と名を入力し、**ユーザーの作成**を選択します。

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**] を選択します。  
![\[ユーザーと割り当てられた Enterprise Analyzer スタックを示す WorkSpaces アプリケーション割り当てスタックページ。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-assign-stack.png)

スタックにユーザーを割り当てると、WorkSpaces アプリケーションは指定したアドレスのユーザーに E メールを送信します。この E メールには、WorkSpaces アプリケーションログインページへのリンクが含まれています。

## ステップ 4: WorkSpaces アプリケーションにログインする
<a name="tutorial-aas-step4"></a>

このステップでは、WorkSpaces アプリケーションから で作成したユーザーに送信される E メールのリンクを使用して WorkSpaces アプリケーションにログインします[ステップ 3: WorkSpaces アプリケーションでユーザーを作成する](#tutorial-aas-step3)。

1. WorkSpaces Applications から送信された E メールに記載されているリンクを使用して WorkSpaces アプリケーションにログインします。

1. プロンプトが表示されたら、パスワードを変更します。表示される WorkSpaces アプリケーション画面は次のようになります。  
![\[デスクトップアイコンを示す WorkSpaces Applications ログイン画面の例。\]](http://docs.aws.amazon.com/ja_jp/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 のバケットを確認する (オプション)
<a name="tutorial-aas-step5"></a>

スタックの作成に使用した CloudFormation テンプレートで完了したタスクの 1 つは、Amazon S3 に 2 つのバケットを作成することでした。これは、作業セッション全体でユーザーデータとアプリケーション設定を保存および復元するために必要です。これらのバケットは以下のとおりです。
+ 名前は `appstream2-` で始まります。このバケットは、WorkSpaces アプリケーション () のホームフォルダにデータをマッピングします`D:\PhotonUser\My Files\Home Folder`。
**注記**  
ホームフォルダは、特定の E メールアドレスに対して一意であり、特定の AWS アカウントのすべてのフリートとスタックで共有されます。ホームフォルダの名前は、ユーザーのメールアドレスの 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 コンソールに移動し、スタック作成メッセージを確認します。

## 次の手順
<a name="tutorial-aas-next-steps"></a>

WorkSpaces アプリケーションインフラストラクチャがセットアップされたので、Enterprise Analyzer をセットアップして使用を開始できます。詳細については、「[チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする](set-up-ea.md)」を参照してください。Enterprise Developer をセットアップすることもできます。詳細については、「[チュートリアル: WorkSpaces アプリケーションで Rocket Enterprise Developer をセットアップする](set-up-ed.md)」を参照してください。

## リソースをクリーンアップする
<a name="tutorial-aas-cleanup"></a>

作成されたスタックとフリートをクリーンアップする手順については、[WorkSpaces アプリケーションフリートとスタックの作成](https://docs.aws.amazon.com/appstream2/latest/developerguide/set-up-stacks-fleets.html)」を参照してください。

WorkSpaces アプリケーションオブジェクトが削除されると、アカウント管理者は、必要に応じて、アプリケーション設定とホームフォルダの Amazon S3 バケットをクリーンアップすることもできます。

**注記**  
特定のユーザーのホームフォルダはすべてのフリートで一意であるため、他の WorkSpaces アプリケーションスタックが同じアカウントでアクティブになっている場合は、保持する必要がある場合があります。

最後に、WorkSpaces Applications では現在、コンソールを使用してユーザーを削除することはできません。代わりに、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) で テンプレートを使用する
<a name="tutorial-templates-ed"></a>

このチュートリアルでは、Rocket Enterprise Developer でテンプレートと事前定義されたプロジェクトを使用する方法について説明します。3 つのユースケースについて説明します。すべてのユースケースでは、BankDemo サンプルで提供されているサンプルコードを使用しています。サンプルをダウンロードするには、[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) を選択します。

**重要**  
Enterprise Developer for Windows を使用している場合、コンパイラによって生成されたバイナリは、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 プロジェクトテンプレートの使用
<a name="tutorial-templates-ed-step1"></a>

このユースケースでは、デモの事前セットアップ手順の一環として、ソースコンポーネントをテンプレートのディレクトリ構造にコピーする必要があります。[https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip](https://d1vi4vxke6c2hu.cloudfront.net/demo/bankdemo.zip) では、ソースのコピーを 2 つ必要としないように、元の配布物 `AWSTemplates.zip` から変更されている箇所があります。

1. Enterprise Developer を起動し、選択済みのワークスペースを指定します。  
![\[ワークスペースが選択された状態の Eclipse ランチャー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step1.png)

1. **アプリケーションエクスプローラービュー** の **[Enterprise Development プロジェクト]** ツリービュー項目で、コンテキストメニューから **[テンプレートから新規プロジェクト]** を選択します。  
![\[[Enterprise Development プロジェクト] ツリービュー項目のコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step2.png)

1. 表示されているとおりに、テンプレートのパラメータを入力してください。
**注記**  
テンプレートパスは ZIP が抽出された場所を参照します。  
![\[[テンプレートパラメータの入力] ボックスに、パスとプロジェクト名を入力します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step3.png)

1. [OK] を選択すると、提供されたテンプレートに基づき、ソースと実行環境構造が完全な、ローカル開発用 Eclipse プロジェクトが作成されます。  
![\[ローカル開発用 Eclipse プロジェクトがこの構造を示しています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc1-step4.png)

   この `System` 構造には、BANKDEMO に必要なエントリを含む完全なリソース定義ファイル、エントリが追加された必須カタログ、対応する ASCII データファイルが含まれています。

   ソーステンプレート構造にはすべてのソース項目が含まれているため、これらのファイルはローカルプロジェクトにコピーされ、Enterprise Developer で自動的に構築されます。

## ユースケース 2 - ソースコンポーネントなしで COBOL プロジェクトテンプレートを使用
<a name="tutorial-templates-ed-step2"></a>

ステップ 1 から 3 は [ユースケース 1 - ソースコンポーネントを含む COBOL プロジェクトテンプレートの使用](#tutorial-templates-ed-step1) と同様です。

このユースケースにおける `System` 構造にも、BankDemo に必要なエントリを含む完全なリソース定義ファイル、エントリが追加された必須カタログ、対応する ASCII データファイルが含まれています。

ただし、テンプレートソース構造にはコンポーネントは含まれていません。使用しているソースリポジトリからこれらのコンポーネントをプロジェクトにインポートする必要があります。

1. プロジェクトの名前を選択します。関連するコンテキストメニューから **[インポート]** を選択します。  
![\[[インポート] が選択された状態のプロジェクトのコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step4.png)

1. ダイアログが表示されたら、**[一般]** セクションで **[ファイルシステム]** を選択し、[次へ] を選択します。  
![\[ファイルシステムを選択した状態の [インポート] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step5.png)

1. ファイルシステムを参照した状態でリポジトリフォルダを指定して、**[差出人ディレクトリ]** フィールドに入力します。`sources` などのインポート先フォルダをすべて選択します。`Into folder` フィールドは、事前入力されています。[**Finish**] を選択してください。  
![\[BankDemo ディレクトリが展開された状態のファイルシステムボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc2-step6.png)

   ソーステンプレート構造にすべてのソーステンプレートが含まれた後、これらの項目は Enterprise Developer で自動的に構築されます。

## ユースケース 3 - ソースフォルダにリンクする事前定義済みの COBOL プロジェクトを使用
<a name="tutorial-templates-ed-step3"></a>

1. Enterprise Developer を起動し、選択済みのワークスペースを指定します。  
![\[ワークスペースが選択された状態の Eclipse ランチャー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step1.png)

1. **[ファイル]** メニューから **[インポート]** を選択します。  
![\[[インポート] を選択した状態の [ファイル] メニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step2.png)

1. 表示されたダイアログの **[一般]** で、**[フォルダまたはアーカイブからのプロジェクト]** を選択し、**[次へ]** を選択します。  
![\[[フォルダまたはアーカイブからのプロジェクト] を選択した状態の [インポート] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step3.png)

1. **[ソースをインポート]** を選択し、**[ディレクトリ]** を選択し、ファイルシステムを参照して事前定義済みのプロジェクトフォルダを選択します。この中に含まれるプロジェクトには、同じリポジトリ内のソースフォルダへのリンクがあります。  
![\[[ファイルシステムまたはアーカイブからプロジェクトをインポート] ボックスに、インポートソースへのパスが入力されています。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-uc3-step4.png)

   [**Finish**] を選択してください。

   プロジェクトにはソースフォルダへのリンクが入力されるため、コードは自動的に構築されます。

## リージョン定義 JSON テンプレートを使用する
<a name="tutorial-templates-ed-step4"></a>

1. Server Explorer ビューに切り替えます。関連するコンテキストメニューから **[管理ページを開く]** を選択すると、デフォルトのブラウザが起動します。  
![\[[管理ページを開く] を選択した状態の Server Explorer のコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-admin-page.png)

1. 表示された Server Explorer 共通 Web 管理 (ESCWA) 画面から、**[インポート]** を選択します。  
![\[[インポート] を選択した状態の [Enterprise Server 共通 Web 管理] 画面。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-import.png)

1. **JSON** インポートタイプを選択し、**[次へ]** を選択します。  
![\[JSON を選択した状態の [インポートタイプの選択] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-import-type.png)

1. 指定した `BANKDEMO.JSON` ファイルをアップロードします。  
![\[BANKDEMO ファイルを選択した状態の [アップロードするファイルを選択] ボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-upload.png)

   選択したら、**[次へ]** を選択します。  
![\[エンドポイントのクリアポートが表示された [リージョンの選択] ボックスは選択されていません。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-next.png)

   **[リージョンの選択]** パネルで、**[エンドポイントからポートをクリア]** オプションが未選択であることを確認してから、**[インポートの実行]** パネルが表示されるまで各パネルで **[次へ]** を選択します。左側のナビゲーションペインで、**[バケット]** を選択します。

   最後に **[完了]** をクリックします。この流れで、BANKDEMO リージョンがサーバーリストに追加されます。  
![\[BankDemo が追加されたリージョンとサーバーリスト。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-server-list.png)

1. BANKDEMO リージョンの **[一般プロパティ]** に移動します。

1. **[設定]** セクションにスクロールします。

1. 前のステップで作成した Eclipse プロジェクトに関連する `System` フォルダに ESP 環境変数を設定する必要があります。これは `workspacefolder/projectname/System` に設定されている必要があります。  
![\[ESP 変数が表示された状態の構成セクション。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-ESP.png)

1. [**適用**] をクリックします。

   これで、このリージョンが Eclipse COBOL プロジェクトと連携して動作するように設定が完了しました。

1. 最後に、Enterprise Developer に戻り、インポートしたリージョンをプロジェクトに関連付けます。  
![\[[プロジェクトに関連付け] を選択した状態のプロジェクトのコンテキストメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ed-json-associate.png)

   これで、Enterprise Developer 環境が使用可能になり、BankDemo の完全版が完成しました。設定済みのリージョンにおいてコードを編集、コンパイル、デバッグできます。
**重要**  
Enterprise Developer for Windows を使用している場合、コンパイラによって生成されたバイナリは、Enterprise Developer が提供する Enterprise Server でのみ実行できます。Linux に基づく AWS Mainframe Modernization ランタイムでは実行できません。

# チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする
<a name="set-up-ea"></a>

このチュートリアルでは、1 つ以上のメインフレームアプリケーションを分析するために 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 Mainframe Modernization が顧客 と共有している WorkSpaces Applications Windows イメージに基づいています。セットアップは、「」で説明されているように、WorkSpaces アプリケーションフリートとスタックの作成にも基づいています[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](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 アプリケーションを設定することを前提としています。詳細については、「[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)」を参照してください。  
このチュートリアルのステップを実行するには、Enterprise Analyzer フリートとスタックを設定済みで、それらが実行中である必要があります。

Enterprise Analyzer の機能と成果物の詳細については、Rocket Software (旧 Micro Focus) ウェブサイトの [Enterprise Analyzer ドキュメント](https://www.microfocus.com/documentation/enterprise-analyzer/)を参照してください。

## イメージのコンテンツ
<a name="set-up-ea-image-contents"></a>

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` 内のライブラリ
+ Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義: `m2-bankdemo-template.zip`。
+ メインフレーム用の MFA インストールパッケージ: `mfa.zip`。詳細については、「*Micro Focus Enterprise Developer* ドキュメント」の「[Mainframe Access Overview](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)

## 前提条件
<a name="tutorial-ea-prerequisites"></a>
+ 分析する顧客アプリケーションのソースコードとシステム定義を S3 バケットにアップロードします。システム定義には、CICS CSD、DB2 オブジェクト定義などが含まれます。バケット内には、アプリケーションのアーティファクトをどのように整理するかに合わせたフォルダ構造を作成できます。例えば、BankDemo サンプルを解凍すると、次の構造になります。

  ```
  demo
       |--> jcl
       |--> RDEF
       |--> transaction
       |--> xa
  ```
+ PostgreSQL を実行している Amazon RDS インスタンスを作成して開始する このインスタンスには、Enterprise Analyzer によって生成されたデータと結果が保存されます。このインスタンスは、アプリケーションチームのすべてのメンバーと共有できます。また、`m2_ea` (またはその他の適切な名前) という名前の空のスキーマをデータベースに作成します。権限のあるユーザーがこのスキーマの項目を作成、挿入、更新、削除できるようにする認証情報を定義します。データベース名、サーバーエンドポイント URL、TCP ポートは Amazon RDS コンソールまたはアカウント管理者から取得できます。
+ へのプログラムによるアクセスが設定されていることを確認します AWS アカウント。詳細については、「*Amazon Web Services 全般のリファレンス*」の「[プログラム的なアクセス](https://docs.aws.amazon.com/general/latest/gr/aws-sec-cred-types.html#access-keys-and-secret-access-keys)」を参照してください。

## ステップ 1: セットアップ
<a name="tutorial-ea-step1"></a>

1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。

1. E メールをユーザー ID として使用し、永久パスワードを定義します。

1. Enterprise Analyzer スタックを選択します。

1. WorkSpaces アプリケーションメニューページで、**デスクトップ**を選択して、フリートがストリーミングしている Windows デスクトップにアクセスします。

## ステップ 2: Windows 用の Amazon S3 ベースの仮想フォルダを作成する
<a name="tutorial-ea-step2"></a>

**注記**  
 AWS Mainframe Modernization プレビュー中に Rclone を既に使用している場合は、 にある新しいバージョン`m2-rclone.cmd`に更新する必要があります`C:\Users\Public`。

1. `C:\Users\Public` で提供されている `m2-rclone.conf` ファイルと `m2-rclone.cmd` ファイルを、ファイルエクスプローラーを使用してホームフォルダ `C:\Users\PhotonUser\My Files\Home Folder` にコピーします。

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. Windows コマンドプロンプトを開き、必要に応じて cd コマンドで `C:\Users\PhotonUser\My Files\Home Folder` に変更し、`m2-rclone.cmd` を実行します。このコマンドスクリプトは連続ループを実行し、Amazon S3 バケットとキーを 10 秒ごとにローカルフォルダに同期します。タイムアウトは、必要に応じて調整できます。Windows ファイルエクスプローラーの Amazon S3 バケットにあるアプリケーションのソースコードが表示されます。

作業中のセットに新しいファイルを追加したり、既存のファイルを更新したりするには、ファイルを Amazon S3 バケットにアップロードします。そうすれば、`m2-rclone.cmd` で定義した次のイテレーションでディレクトリに同期されます。同様に、ファイルを削除する場合は Amazon S3 バケットから削除します。次の同期オペレーションでは、ローカルディレクトリから削除されます。

## ステップ 3: Amazon RDS インスタンス用の ODBC ソースを作成する
<a name="tutorial-ea-step3"></a>

1. EA\$1Admin ツールを開始するには、ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、**[MF EA\$1Admin]** を選択します。

1. **[管理]** メニューから、**[ODBC データソース]** を選択し、**[ユーザー DSN]** タブから **[追加]** を選択します。

1. [新しいデータソースを作成] ダイアログボックスで、**[PostgreSQL Unicode]** ドライバーを選択し、**[終了]** を選択します。

1. **[PostgreSQL Unicode ODBC ドライバー (psqlODBC) のセットアップ]** ダイアログボックスで、目的のデータソース名を定義し、書き留めておきます。以前に作成した RDS インスタンスの値を使用して、次のパラメータを入力します。  
**説明**  
このデータベース接続をすばやく識別するのに役立つ説明 (オプション)。  
**データベース**  
以前に作成した Amazon RDS データベース。  
**サーバー**  
Amazon RDS エンドポイント。  
**ポート**  
Amazon RDS ポート。  
**ユーザー名**  
Amazon RDS インスタンスで定義されているとおり。  
**[パスワード]**  
Amazon RDS インスタンスで定義されているとおり。

1. **[テスト]** を選択して Amazon RDS への接続が成功したことを確認し、**[保存]** を選択して新しいユーザー DSN を保存します。

1. 適切なワークスペースが作成されたことを確認するメッセージが表示されるまで待ってから、**[OK]** を選択して ODBC データソースを終了し、EA\$1Admin ツールを閉じます。

1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。**[新規作成]** を選択します。

1. ワークスペース設定ウィンドウで、ワークスペース名を入力し、その場所を定義します。ワークスペースは、この設定で作業する場合は Amazon S3 ベースのディスクにすることも、必要に応じてホームフォルダにすることもできます。

1. **[他のデータベースを選択]** を選択して、Amazon RDS インスタンスに接続します。

1. オプションから **[Postgre]** アイコンを選択し、**[OK]** を選択します。

1. Windows 設定の **[オプション - 接続パラメータの定義]** に、作成したデータソースの名前を入力します。データベース名、スキーマ名、ユーザー名、パスワードも入力します。[**OK**] を選択してください。

1. Enterprise Analyzer が結果を保存するために必要なテーブル、インデックスなどをすべて作成するまでお待ちください。このステップには数分かかる場合があります。Enterprise Analyzer は、データベースとワークスペースが使用できる状態になったことを確認します。

1. アプリケーションセレクタメニューに再度移動し、[Enterprise Analyzer] を選択してツールを開始します。

1. Enterprise Analyzer のスタートアップウィンドウが、新しく選択したワークスペースの場所に表示されます。[**OK**] を選択してください。

1. 左ペインのリポジトリに移動し、リポジトリ名を選択し、**[ファイル/フォルダをワークスペースに追加]** を選択します。アプリケーションコードが保存されているフォルダを選択して、ワークスペースに追加します。必要であれば、以前の BankDemo サンプルコードを使用できます。Enterprise Analyzer からこれらのファイルの検証を求めるメッセージが表示されたら、**[検証]** を選択して最初の Enterprise Analyzer 検証レポートを開始します。アプリケーションのサイズによっては、完了するまで数分かかる場合があります。

1. ワークスペースを展開すると、ワークスペースに追加したファイルとフォルダが表示されます。オブジェクトタイプと循環的複雑度レポートは、**[チャートビューアー]** ペインの上部にも表示されます。

これで、必要なすべてのタスクに Enterprise Analyzer を使用できるようになりました。

## 以降のセッション
<a name="tutorial-ea-step4"></a>

1. WorkSpaces アプリケーションからのウェルカム E メールメッセージで受信した URL を使用して WorkSpaces アプリケーションとのセッションを開始します。

1. E メールと永久パスワードを使用してログインします。

1. Enterprise Analyzer スタックを選択します。

1. このオプションを使用してワークスペースファイルを共有する場合は、`Rclone` を起動して Amazon S3 バックアップディスクに接続します。

1. Enterprise Analyzer を起動してタスクを行います。

## ワークスペース接続のトラブルシューティング
<a name="tutorial-ea-step5"></a>

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?
```

この問題を解決するには、**[OK]** を選択してメッセージをクリアし、次の手順を実行します。

1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA\$1Admin** を選択して Enterprise Analyzer 管理ツールを起動します。  
![\[Rocket Enterprise Developer 管理ツールが選択された WorkSpaces アプリケーション起動セレクタメニュー。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-selector.png)

1. **[管理]** メニューから **[ワークスペースパスを更新...]** を選択します。  
![\[更新 Workspace パスを選択して、Rocket Enterprise Analyzer 管理ツールのメニューを管理します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-administer-refresh.png)

1. **[ワークスペースを選択]** で、目的のワークスペースを選択し、**[OK]** を選択します。  
![\[プロジェクトを選択した Rocket Enterprise Analyzer 管理ツールのワークスペースの選択ダイアログボックス。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/ea_admin-select-workspace.png)

1. **[OK]** を選択してエラーメッセージを確認します。  
![\[Enterprise Analyzer エラーメッセージ。[OK] が選択されているワークスペースディレクトリにはアクセスできません。\]](http://docs.aws.amazon.com/ja_jp/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/ja_jp/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/ja_jp/m2/latest/userguide/images/ea_admin-close.png)

1. WorkSpaces Applications で、ツールバーの**アプリケーション起動**アイコンを選択し、**EA** を選択して Micro Focus Enterprise Analyzer を起動します。  
![\[WorkSpaces アプリケーションは、EA が選択された状態でアプリケーションを起動します。\]](http://docs.aws.amazon.com/ja_jp/m2/latest/userguide/images/aas-launch-ea.png)

1. ステップ 3～5 を繰り返します。

これで、Micro Focus Enterprise Analyzer が既存のワークスペースで開かれるはずです。

## リソースをクリーンアップする
<a name="tutorial-ea-clean"></a>

このチュートリアル用に作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
+ **[EA\$1Admin]** ツールを使用してワークスペースを削除します。
+ このチュートリアル用に作成した S3 バケットを削除します。詳細については、「*Amazon S3 ユーザーガイド*」の「[バケットの削除](https://docs.aws.amazon.com/AmazonS3/latest/userguide/delete-bucket.html)」を参照してください。
+ このチュートリアル用に作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)」を参照してください。

# チュートリアル: WorkSpaces アプリケーションで Rocket Enterprise Developer をセットアップする
<a name="set-up-ed"></a>

このチュートリアルでは、1 つ以上のメインフレームアプリケーション用に Rocket Enterprise Developer (以前の Micro Focus Enterprise Developer) をセットアップして、Enterprise Developer 機能を使用してメンテナンス、コンパイル、テストする方法について説明します。セットアップは、 AWS Mainframe Modernization がお客様と共有する WorkSpaces Applications Windows イメージと、「」で説明されている WorkSpaces Applications フリートとスタックの作成に基づいています[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](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 アプリケーションを設定することを前提としています。詳細については、「[チュートリアル: Rocket Enterprise Analyzer と Rocket Enterprise Developer で使用する WorkSpaces アプリケーションをセットアップする](set-up-appstream-mf.md)」を参照してください。  
このセットアップのステップは、Enterprise Developer フリートとスタックが稼働しているときに実行する必要があります。

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>

イメージには、Enterprise Developer 自体に加えて、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` 内のライブラリ
+ Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義: `m2-bankdemo-template.zip`。
+ メインフレーム用の MFA インストールパッケージ: `mfa.zip`。詳細については、「*Micro Focus Enterprise Developer* ドキュメント」の「[Mainframe Access Overview](https://www.microfocus.com/documentation/enterprise-developer/30pu12/ED-VS2012/BKMMMMINTRS001.html)」を参照してください。
+ Rclone のコマンドファイルおよび設定ファイル (使用方法はチュートリアルに記載されています): `m2-rclone.cmd` と `m2-rclone.conf`。

CodeCommit リポジトリにまだロードされていないが、Amazon S3 バケットにあるソースコードにアクセスする必要がある場合 (例えば、ソースコードを Git に最初にロードする場合など) は、[チュートリアル: WorkSpaces アプリケーションで Enterprise Analyzer をセットアップする](set-up-ea.md) で説明されている手順に従って仮想 Windows ディスクを作成します。

**Topics**
+ [

## イメージのコンテンツ
](#set-up-ed-image-contents)
+ [

## 前提条件
](#tutorial-ed-prerequisites)
+ [

## ステップ 1: 個々の Enterprise Developer ユーザーによる設定
](#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>
+ 保守対象のアプリケーションのソースコードがロードされた 1 つ以上の CodeCommit リポジトリ。リポジトリのセットアップは、両方のツールを組み合わせてシナジーを作成するために、上記のCI/CDパイプラインの要件と一致する必要があります。
+ 各ユーザーは、「[AWS CodeCommit の認証とアクセスコントロール](https://docs.aws.amazon.com/codecommit/latest/userguide/auth-and-access-control.html)」の情報に従って、アカウント管理者が定義した CodeCommit リポジトリまたはリポジトリへの認証情報を持っている必要があります。これらの認証情報の構造については、「[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: 個々の Enterprise Developer ユーザーによる設定
<a name="tutorial-ed-step1"></a>

1. IAM 認証情報の取得:

   1. [https://console.aws.amazon.com/iam/](https://console.aws.amazon.com/iam/) で AWS コンソールに接続します。

   1. *AWS CodeCommit ユーザーガイド*の「[Git 認証情報を使用する HTTPS ユーザーのセットアップ](https://docs.aws.amazon.com/codecommit/latest/userguide/setting-up-gc.html)」のステップ 3 で説明されている手順に従います。

   1. IAM が生成した CodeCommit 固有のサインイン認証情報をコピーするには、この情報を表示して、ローカルコンピュータ上の安全なファイルにコピーアンドペーストするか、**[認証情報のダウンロード]** を選択して .CSV ファイルとしてこの情報をダウンロードします。CodeCommit に接続するには、この情報が必要です。

1. ウェルカム E メールで受信した URL に基づいて WorkSpaces アプリケーションとのセッションを開始します。E メールをユーザー名として使用し、パスワードを作成します。

1. Enterprise Developer スタックを選択します。

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\Public` で提供されている `m2-rclone.conf` ファイルと `m2-rclone.cmd` ファイルを、ファイルエクスプローラーを使用してホームフォルダ `C:\Users\PhotonUser\My Files\Home Folder` にコピーします。

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. Windows コマンドプロンプトを開き、必要に応じて cd コマンドで `C:\Users\PhotonUser\My Files\Home Folder` に変更し、`m2-rclone.cmd` を実行します。このコマンドスクリプトは連続ループを実行し、Amazon S3 バケットとキーを 10 秒ごとにローカルフォルダに同期します。タイムアウトは、必要に応じて調整できます。Windows ファイルエクスプローラーの Amazon S3 バケットにあるアプリケーションのソースコードが表示されます。

作業中のセットに新しいファイルを追加したり、既存のファイルを更新したりするには、ファイルを Amazon S3 バケットにアップロードします。そうすれば、`m2-rclone.cmd` で定義した次のイテレーションでディレクトリに同期されます。同様に、ファイルを削除する場合は Amazon S3 バケットから削除します。次の同期オペレーションでは、ローカルディレクトリから削除されます。

## ステップ 3: リポジトリのクローンを作成する
<a name="tutorial-ed-step3"></a>

1. ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、[Enterprise Developer] を選択します。

1. ワークスペースの場所として `C:\Users\PhotonUser\My Files\Home Folder` (別名`D: \PhotonUser\My Files\Home Folder`) を選択して、Enterprise Developer が必要とするワークスペースの作成をホームフォルダで完了します。

1. Enterprise Developer で、プロジェクトエクスプローラーに移動し、右クリックして **[インポート]**、**[インポート...]**、**[Git]**、**[Git]** **[クローン URI]** からの **[プロジェクト]** を選択して CodeCommit リポジトリのクローンを作成します。次に、CodeCommit 固有のサインイン認証情報を入力し、Eclipse ダイアログに入力してコードをインポートします。

これで、CodeCommit の git リポジトリがローカルワークスペースに複製されました。

これで、Enterprise Developer ワークスペースでアプリケーションのメンテナンス作業を開始する準備ができました。特に、Enterprise Developer と統合された Enterprise Server (ES) のローカルインスタンスを使用して、アプリケーションをインタラクティブにデバッグして実行し、変更をローカルで検証できます。

**注記**  
ローカル Enterprise Server インスタンスを含むローカル Enterprise Developer 環境は Windows で実行され、 AWS Mainframe Modernization は Linux で実行されます。新しいアプリケーションを CodeCommit にコミットし、このターゲット用に再構築した後、新しいアプリケーションを本番環境にロールアウトする前に、 AWS Mainframe Modernization が提供する Linux 環境で補完テストを実行することをお勧めします。

## 以降のセッション
<a name="tutorial-ed-step4"></a>

CodeCommit リポジトリのクローン作成用のホームフォルダなど、WorkSpaces アプリケーション管理下にあるフォルダを選択すると、セッション間で透過的に保存および復元されます。次回、アプリケーションを操作する必要が生じたときには、次のステップを実行してください。

1. ウェルカム E メールで受信した URL に基づいて WorkSpaces アプリケーションとのセッションを開始します。

1. E メールと永久パスワードを使用してログインします。

1. Enterprise Developer スタックを選択します。

1. このオプションを使用してワークスペースファイルを共有する場合は、`Rclone` を開始して Amazon S3 ベースのディスクに接続します (上を参照)。

1. Enterprise Developer を起動して作業を行います。

## リソースをクリーンアップする
<a name="tutorial-ed-clean"></a>

このチュートリアルで作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
+ このチュートリアル用に作成した CodeCommit リポジトリを削除します。詳細については、「*AWS CodeCommit ユーザーガイド*」の「[CodeCommit リポジトリを削除する](https://docs.aws.amazon.com/codecommit/latest/userguide/how-to-delete-repository.html)」を参照してください。
+ このチュートリアル用に作成したデータベースを削除します。詳細については、「[DB インスタンスの削除](https://docs.aws.amazon.com/AmazonRDS/latest/UserGuide/CHAP_GettingStarted.CreatingConnecting.PostgreSQL.html#CHAP_GettingStarted.Deleting.PostgreSQL)」を参照してください。