

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 アプリケーションで 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)」を参照してください。