チュートリアル: AppStream 2.0 で Micro Focus Enterprise Developer をセットアップする
このチュートリアルでは、1 つ以上のメインフレームアプリケーションに Micro Focus Enterprise Developer をセットアップし、Enterprise Developer 機能を使用してそれらのアプリケーションを保守、コンパイル、テストする方法について説明します。セットアップは、AWS Mainframe Modernization がお客様と共有する AppStream 2.0 Windows イメージと、チュートリアル: Micro Focus Enterprise Analyzer と Micro Focus Enterprise Developer で使用するための AppStream 2.0 のセットアップ で説明されている AppStream 2.0 のフリートとスタックの作成に基づいています。
重要
このチュートリアルのステップは、ダウンロード可能な AWS CloudFormation テンプレート cfn-m2-appstream-fleet-ea-ed.yaml
このセットアップのステップは、Enterprise Developer フリートとスタックが稼働しているときに実行する必要があります。
Enterprise Developer v7 の機能と成果物の詳細については、Micro Focus サイトにある最新のオンラインドキュメント (v7.0)
イメージのコンテンツ
イメージには、Enterprise Developer 自体に加えて、Rumba (TN3270 エミュレータ) を含むイメージが含まれています。次のツールとライブラリも含まれています。
サードパーティー製ツール
C:\Users\Public
内のライブラリ
-
Enterprise Developer 向けの BankDemo ソースコードとプロジェクト定義:
m2-bankdemo-template.zip
。 -
メインフレーム用の MFA インストールパッケージ:
mfa.zip
。詳細については、「Micro Focus Enterprise Developer ドキュメント」の「Mainframe Access Overview」を参照してください。 -
Rclone のコマンドファイルおよび設定ファイル (使用方法はチュートリアルに記載されています):
m2-rclone.cmd
とm2-rclone.conf
。
CodeCommit リポジトリにまだロードされていないが、Amazon S3 バケットにあるソースコードにアクセスする必要がある場合 (例えば、ソースコードを Git に最初にロードする場合など) は、チュートリアル: AppStream 2.0 での Enterprise Analyzer のセットアップ で説明されている手順に従って仮想 Windows ディスクを作成します。
トピック
前提条件
-
保守対象のアプリケーションのソースコードがロードされた 1 つ以上の CodeCommit リポジトリ。両方のツールを組み合わせて相乗効果を生み出すには、リポジトリの設定が上記の CI/CD パイプラインの要件と一致している必要があります。
-
各ユーザーは、「AWS CodeCommit の認証とアクセスコントロール」の情報に従って、アカウント管理者が定義した CodeCommit リポジトリまたはリポジトリへの認証情報を持っている必要があります。これらの認証情報の構造については、「AWS CodeCommit の認証とアクセスコントロール」を参照してください。CodeCommit の IAM 承認に関する完全なリファレンスは、CodeCommit アクセス許可リファレンスにあります。管理者は、各リポジトリのロールに固有の認証情報を持ち、ユーザーの承認を特定のリポジトリで実行する必要がある特定のタスクセットに限定して、個別のロールに対して個別の IAM ポリシーを定義できます。そのため、アカウント管理者は CodeCommit リポジトリ管理者ごとにプライマリユーザーを生成し、適切な IAM ポリシーまたは CodeCommit アクセス用のポリシーを選択して、必要なリポジトリにアクセスするアクセス許可をこのユーザーに付与します。
ステップ 1: 個々の Enterprise Developer ユーザーによる設定
-
IAM 認証情報の取得:
-
AWS コンソール (https://console.aws.amazon.com/iam/
) に接続します。 -
AWS CodeCommit ユーザーガイドの「Git 認証情報を使用する HTTPS ユーザーのセットアップ」のステップ 3 で説明されている手順に従います。
-
IAM が生成した CodeCommit 固有のサインイン認証情報をコピーするには、この情報を表示して、ローカルコンピュータ上の安全なファイルにコピーアンドペーストするか、[認証情報のダウンロード] を選択して .CSV ファイルとしてこの情報をダウンロードします。CodeCommit に接続するには、この情報が必要です。
-
-
ウェルカムメールで受信した URL に基づいて、AppStream 2.0 でセッションを開始します。E メールをユーザー名として使用し、パスワードを作成します。
-
Enterprise Developer スタックを選択します。
-
メニューページで、左側のナビゲーションで [デスクトップ] を選択すると、フリートによってストリーミングされている Windows デスクトップに移動します。
ステップ 2: Windows で Amazon S3 ベースの仮想フォルダを作成する (オプション)
Rclone (上を参照) が必要な場合は、Windows に Amazon S3 ベースの仮想フォルダを作成します (すべてのアプリケーションアーティファクトが CodeCommit アクセスからのみ取得される場合はオプション)。
注記
AWS Mainframe Modernization プレビュー中に既に Rclone を使用していた場合は、m2-rclone.cmd
を C:\Users\Public
にある新しいバージョンに更新する必要があります。
-
C:\Users\Public
で提供されているm2-rclone.conf
ファイルとm2-rclone.cmd
ファイルを、ファイルエクスプローラーを使用してホームフォルダC:\Users\PhotonUser\My Files\Home Folder
にコピーします。 -
AWS アクセスキーと対応するシークレット、および AWS リージョン を使用して
m2-rclone.conf
設定パラメータを更新します。[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
-
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
と指定します。AppStream 2.0 がセッションの開始時と終了時に適切にバックアップおよび復元するには、この同期されたディレクトリをホームフォルダのサブディレクトリにする必要があります。
: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 -
-
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: リポジトリのクローンを作成する
-
ブラウザウィンドウの左上隅にあるアプリケーションセレクタメニューに移動し、[Enterprise Developer] を選択します。
-
ワークスペースの場所として
C:\Users\PhotonUser\My Files\Home Folder
(別名D: \PhotonUser\My Files\Home Folder
) を選択して、Enterprise Developer が必要とするワークスペースの作成をホームフォルダで完了します。 -
Enterprise Developer で、プロジェクトエクスプローラーに移動し、右クリックして [インポート]、[インポート...]、[Git]、[Git] [クローン URI] からの [プロジェクト] を選択して CodeCommit リポジトリのクローンを作成します。次に、CodeCommit 固有のサインイン認証情報を入力し、Eclipse ダイアログに入力してコードをインポートします。
これで、CodeCommit の git リポジトリがローカルワークスペースに複製されました。
これで、Enterprise Developer ワークスペースでアプリケーションのメンテナンス作業を開始する準備ができました。特に、Enterprise Developer と統合された Microfocus Enterprise Server (ES) のローカルインスタンスを使用して、アプリケーションをインタラクティブにデバッグおよび実行し、変更をローカルで検証できます。
注記
ローカルのエンタープライズサーバーインスタンスを含むローカルの Enterprise Developer 環境は Windows で実行され、AWS Mainframe Modernization は Linux で実行されます。新しいアプリケーションを CodeCommit にコミットしてこのターゲット用に再構築した後、新しいアプリケーションを本番環境にロールアウトする前に、AWS Mainframe Modernization が提供する Linux 環境で補完的なテストを実行することをお勧めします。
以降のセッション
CodeCommit リポジトリのクローニング用のホームフォルダなど、AppStream 2.0 の管理下にあるフォルダを選択すると、そのフォルダはセッション間で透過的に保存および復元されます。次回、アプリケーションを操作する必要が生じたときには、次のステップを実行してください。
-
ウェルカムメールで受信した URL に基づいて、AppStream 2.0 でセッションを開始します。
-
E メールと永久パスワードを使用してログインします。
-
Enterprise Developer スタックを選択します。
-
このオプションを使用してワークスペースファイルを共有する場合は、
Rclone
を開始して Amazon S3 ベースのディスクに接続します (上を参照)。 -
Enterprise Developer を起動して作業を行います。
リソースをクリーンアップする
このチュートリアルで作成したリソースが不要になった場合は、追加料金の発生を避けるため、それらを削除してください。以下のステップを実行します。
-
このチュートリアル用に作成した CodeCommit リポジトリを削除します。詳細については、「AWS CodeCommit ユーザーガイド」の「CodeCommit リポジトリを削除する」を参照してください。
-
このチュートリアル用に作成したデータベースを削除します。詳細については、「DB インスタンスの削除」を参照してください。