を使用して CardDemo メインフレームアプリケーションをモダナイズする AWS Transform - AWS 規範ガイダンス
概要前提条件と制限アーキテクチャツールベストプラクティスエピックトラブルシューティング関連リソース

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

を使用して CardDemo メインフレームアプリケーションをモダナイズする AWS Transform

Amazon Web Services、Santosh Kumar Singh、Cheryl du Preez

概要

AWS Transform は、メインフレームアプリケーションのモダナイズの迅速化を目的に設計されています。生成 AI を使用することでメインフレームのモダナイズプロセスを合理化します。レガシーコード分析、メインフレームドキュメント、ビジネスルールの抽出、モノリシックアプリケーションのビジネスドメインへの分解、コードリファクタリングなどの複雑なタスクを自動化します。アプリケーション分析や移行シーケンス計画などの複雑なタスクを自動化することで、モダナイズプロジェクトを迅速に実行します。モノリシックアプリケーションを分解する場合、 はメインフレームアプリケーションの変換 AWS Transform をインテリジェントにシーケンスします。これにより、ビジネス機能を並行して変換できます。 AWS Transform は意思決定を加速し、運用の俊敏性と移行効率を向上させることができます。

このパターンでは、オープンソースのメインフレームアプリケーションのサンプルである CardDemo AWS Transform を使用して、 のメインフレームモダナイゼーション機能をテストするのに役立つstep-by-stepの手順を示します。

前提条件と制限

前提条件

  • アクティブな AWS アカウント

  • 有効なAWS IAM アイデンティティセンター

  • 管理者が を有効にできるようにするアクセス許可 AWS Transform

  • 管理者が AWS Transform ウェブアプリケーションの Amazon Simple Storage Service (Amazon S3) 接続リクエストを受け入れることを許可するアクセス許可

制限事項

  • AWS Transform は一部の でのみ使用できます AWS リージョン。対応リージョンのリスト全文は「Supported Regions for AWS Transform」よりご確認ください。

  • AWS Transform は、共通ビジネス指向言語 (COBOL) から Java へのコード分析、ドキュメント生成、ビジネスルールの抽出、分解、リファクタリングをサポートしています。詳しくは「Capabilities and key features」および「Supported file types for transformation of mainframe applications」をご確認ください。

  • AWS Transformのメインフレーム変換機能では Service Quota があります。詳細については、「AWS Transformのクォータ」を参照してください。

  • 共有ワークスペースでコラボレーションするには、すべてのユーザーが、 AWS Transform ウェブアプリケーションのインスタンス AWS IAM アイデンティティセンター に関連付けられている の同じインスタンスの登録済みユーザーである必要があります。

  • Amazon S3 バケット と は、同じ AWS アカウント とリージョンにある AWS Transform 必要があります。

アーキテクチャ

このパターンで構築するアーキテクチャを次の図に示します。

AWS Transform を使用して、Amazon S3 バケットに保存されているメインフレームアプリケーションをモダナイズします。

この図表は、次のワークフローを示しています:

  1. AWS Transform はコネクタを使用して、Amazon S3 バケットに保存されている CardDemo メインフレームアプリケーションにアクセスします。

  2. AWS Transform は AWS IAM アイデンティティセンター を使用してユーザーアクセスと認証を管理します。システムは、認証、認可、暗号化、アクセス管理のための複数のセキュリティコントロールを実行し、処理中のコードとアーティファクトを保護します。ユーザーはチャットインターフェイスを介して AWS Transform エージェントとやり取りします。特定のタスクに関する指示を AI エージェントに英語で提供できます。詳細については、 AWS Transform ドキュメントの「Human in the loop (HITL)」を参照してください。

  3. AI エージェントは、ユーザーの指示を解釈し、ジョブプランを作成し、ジョブを実行可能なタスクに分割して、自律的にアクションを実行します。ユーザーは変換を確認して承認できます。変換タスクには以下が含まれます。

    • コード分析 – ファイル名、ファイルタイプ、コード行、パスなどの詳細について、各ファイルのコードを AWS Transform 分析します。エージェントはソースコードを分析し、分類の実行、依存関係マッピングの作成、欠落しているアーティファクトの特定を行います。また、重複するコンポーネントも識別します。

    • ドキュメント生成 – メインフレームアプリケーションのドキュメント AWS Transform を生成します。コードを分析することで、レガシーシステムに存在するビジネスロジック、フロー、統合、依存関係の説明など、アプリケーションプログラムの詳細なドキュメントを自動的に作成できます。

    • ビジネスロジック抽出 – COBOL プログラム AWS Transform を分析してコアビジネスロジックを文書化し、基本的なビジネスロジックを理解するのに役立ちます。

    • コード分解 – プログラムとコンポーネント間の依存関係を考慮したドメインにコードを AWS Transform 分解します。同じドメイン内で関連ファイルとプログラムをグループ化すると、組織が改善され、より小さなコンポーネントに分割するときにアプリケーションの論理構造が保持されます。

    • 移行ウェーブ計画 – 分解フェーズで作成したドメインに基づいて、 は推奨されるモダナイゼーション順序で移行ウェーブ計画 AWS Transform を生成します。

    • コードリファクタリング – すべてのドメインファイルまたは選択したドメインファイルのコードを Java コードに AWS Transform リファクタリングします。この動作は、アプリケーションの重要なビジネスロジックを維持しながら、モダナイズされたクラウド最適化 Java アプリケーションにリファクタリングすることを目的としています。

  4. AWS Transform は、リファクタリングされたコード、生成されたドキュメント、関連するアーティファクト、ランタイムライブラリを Amazon S3 バケットに保存します。以下を行うことができます。

    • Amazon S3 バケットのランタイムフォルダにアクセスします。

    • AWS Transform ドキュメントの「モダナイズされたアプリケーションのリファクタリング後のビルドとデプロイ」に従って、アプリケーションをビルドおよびデプロイします。

    • チャットインターフェイスを使用して、サンプル AWS CloudFormation AWS Cloud Development Kit (AWS CDK)、または Hashicorp Terraform テンプレートをリクエストしてダウンロードします。これらのテンプレートは、リファクタリングされたアプリケーションをサポートするために必要な AWS リソースをデプロイするのに役立ちます。

    • リフォージを使用すると、大規模言語モデル (LLM) を利用してリファクタリング済みのコード品質が向上します。リファクタリングエンジンは、COBOL を Java コードに変換しながら、COBOL の機能的同等性を維持します。リフォージは、変換後に実行できるオプション手順です。このステップでは LLM を使用してネイティブ Java とよく似たコードを再構築します。これにより、可読性と保守性が向上します。リフォージは、コードの理解に役立つ人間が読めるコメントを追加し、最新のコーディングパターンとベストプラクティスを実行します。

ツール

AWS のサービス

  • AWS Transform はエージェンティック AI を使用して、.NET、メインフレーム、VMware ワークロードなどのレガシーワークロードのモダナイズを加速します。

  • AWS IAM アイデンティティセンター を使用すると、 AWS アカウント およびクラウドアプリケーションへのシングルサインオン (SSO) アクセスを一元管理できます。

  • Amazon Simple Storage Service (Amazon S3) は、あらゆる量のデータを保存、保護、取得できるクラウドベースのオブジェクトストレージサービスです。

コードリポジトリ

オープンソースの AWS CardDemo メインフレームアプリケーションをサンプルアプリケーションとして使用して、メインフレームのモダナイゼーションを開始できます。

ベストプラクティス

  • 小規模から始める – メインフレームアプリケーションの AWS Transform 分析と変換の方法を理解するために、小規模で複雑ではないコード (15,000～20,000 行のコード) から始めます。

  • 人間の専門知識と組み合わせる – 人間の専門知識を適用して最適な結果を得ると同時に、アクセラレータ AWS Transform ーとして使用します。

  • レビューとテストを徹底する – 変換されたコードを注意深く確認し、包括的なテストを実行して、変換後の機能同等性を検証します。

  • フィードバックを提供する – 改善のためのフィードバックと提案を提供するには、 のフィードバックを送信するボタンを使用する AWS マネジメントコンソール か、 でケースを作成しますAWS サポート。詳細については、「サポートケースの作成」を参照してください。いただいたフィードバックを元に、サービス改善と将来的な開発を行います。

エピック

タスク説明必要なスキル

バケットを作成します。

AWS Transform が有効になっているのと同じ AWS アカウント およびリージョンに Amazon S3 バケットを作成します。このバケットを使用してメインフレームアプリケーションコードを保存し、このバケット AWS Transform を使用して、生成されたドキュメント、リファクタリングされたコード、および変換に関連付けられたその他のファイルを保存します。手順については、Amazon S3 ドキュメントの「バケットの作成」を参照してください。

AWS 全般

サンプルメインフレームアプリケーションを準備します。

  1. 次のコマンドを入力し、CardDemo リポジトリをローカルのワークステーションにクローンします。

    git clone https://github.com/aws-samples/aws-mainframe-modernization-carddemo.git

  2. carddemo という名前のフォルダを新規作成します。

  3. メインフレームソースコードを含む app フォルダを、クローンされたリポジトリから carddemo フォルダにコピーします。

  4. cardemo フォルダを ZIP ファイルに圧縮します。

  5. 作成した Amazon S3 バケットに ZIP ファイルをアップロードします。手順については、Amazon S3 ドキュメントの「オブジェクトのアップロード」を参照してください。

アプリ開発者、DevOps エンジニア
タスク説明必要なスキル

IAM アイデンティティセンターにユーザーを追加します。

IAM アイデンティティセンターに見込みユーザーを追加します。 AWS Transform ドキュメントの「IAM Identity Center でのユーザーの追加」の手順に従います。

AWS 管理者

ユーザーを有効に AWS Transform して追加します。

  1. 有効にします AWS Transform。「Enable AWS Transform」の手順に従います。

  2. ユーザーを に追加します AWS Transform。「ユーザーの追加 AWS Transform」の手順に従います。

AWS 管理者

AWS Transform ウェブアプリケーションへのユーザーアクセスを設定します。

各ユーザーは、 AWS Transform ウェブアプリケーションにアクセスするための招待を受け入れる必要があります。 AWS Transform ドキュメントの「招待を受け入れる」の手順に従います。

アプリ開発者、アプリオーナー

AWS Transform ウェブアプリケーションにログインします。

「 にサインインする AWS Transform」の手順に従います。

アプリ開発者、アプリオーナー

ワークスペースをセットアップします。

ユーザーが AWS Transform ウェブアプリケーションでコラボレーションできるワークスペースを設定します。 AWS Transform ドキュメントの「ワークスペースのセットアップ」の手順に従います。

AWS 管理者
タスク説明必要なスキル

変換ジョブを作成します。

CardDemo メインフレームアプリケーションをモダナイズする変換ジョブを作成します。手順については、 AWS Transform ドキュメントの「ジョブの作成と開始」を参照してください。 AWS Transform チャットインターフェイスで目標を設定するように求められたら、メインフレームモダナイゼーションの実行 (IBM z/OS から へ AWS) を選択し、コードの分析、技術ドキュメントの生成、ビジネスロジック、コードの分解、移行シーケンスの計画、コードを Java に変換を選択します。

アプリ開発者、アプリオーナー

コネクタをセットアップします。

CardDemo メインフレームアプリケーションを含む Amazon S3 バケットへのコネクタを構築します。このコネクタにより AWS Transform 、 はバケット内のリソースにアクセスし、連続する変換関数を実行できます。手順については、 AWS Transform ドキュメントの「コネクタのセットアップ」を参照してください。

AWS 管理者

コード分析を実行します。

  1. [アセットの場所を指定] ページで、アップロードした carddemo ZIP ファイルの Amazon S3 バケットパスを入力します。

  2. 承認と送信を選択します AWS Transform。コード分析が開始されます。

  3. [Worklog] タブからステータスがモニタリングできます。

  4. 分析が完了したら、左側のナビゲーションペインの [コードの分析] で、[コード分析結果の表示] を選択します。

  5. (オプション) [ダウンロード] を選択して、完全なアセットリスト、欠落しているソースコード、依存関係ファイルをダウンロードします。

詳細については、 AWS Transform ドキュメントの「コード分析」を参照してください。

アプリ開発者、アプリオーナー

技術ドキュメントを生成します。

  1. 左側のナビゲーションペインの [技術ドキュメントの生成] から [ファイルの選択と設定] を選択します。

  2. COBOL または JCL を展開し、1 つ以上のファイルを選択します。

  3. ドキュメントの詳細レベルを選択します。

    • 概要 – スコープ内の各ファイルの概要を示します。また、各ファイルの概要を 1 行で提供します。

    • 機能仕様の詳細 – メインフレームアプリケーション変換スコープ内の各ファイルの包括的な詳細を提供します。詳細には、ロジックとフロー、特定されたビジネスルール、データフロー、依存関係、入出力処理、およびさまざまなトランザクションの詳細が含まれます。

  4. 送信先 AWS Transformを選択します。

  5. [Worklog] タブで進行状況をモニタリングします。

    注記

    ドキュメントの生成時間は、ファイルの数とコード行に応じて数分から数時間まで異なります。

  6. 完了したら、[ドキュメント結果の確認] を選択します。

  7. ウェブアプリケーションから生成されたドキュメントにアクセスするか、ダウンロードします。生成されたドキュメントは Amazon S3 バケットにも保存されます。

  8. チャットインターフェイスで質問をして、生成されたドキュメントを調べます。例えば、「CBACT01C の機能を教えてください」などの質問ができます。

詳細については、 ドキュメントの「技術ドキュメントの生成」を参照してください。 AWS Transform

アプリ開発者、アプリオーナー

ビジネスロジックを抽出します。

  1. 左側のナビゲーションペインで [ビジネスロジックを抽出] を展開し、[ビジネスロジック抽出を行うファイルを選択] を選択します。

  2. COBOL または JCL を展開し、1 つ以上のファイルを選択します。

  3. 送信先 AWS Transformを選択します。

  4. [Worklog] タブで進行状況をモニタリングします。

    注記

    ビジネスロジックの抽出時間は、ファイル数とコード行に応じて数分から数時間まで異なります。

  5. 抽出が完了したら、[ビジネスロジック抽出結果の確認] を選択します。

  6. COBOL または JCL ファイルを選択し、[表示] を選択します。

  7. [フロー図と機能ルール] の範囲を変更して、サポートコードを含む各レベルのフローチャートを確認します。

  8. (オプション) Amazon S3 バケットに JSON 形式で保存されている、生成されたビジネスロジックを確認します。

詳細については、 AWS Transform ドキュメントの「Extract business logic」を参照してください。

アプリ開発者、アプリオーナー

コードを分解します。

  1. 左側のナビゲーションペインで、[コードを分解] を展開し、[ドメインに分解] を選択します。

  2. [Actions] リストから [ドメインを作成] を選択します。

  3. 新規ドメインの名称 (Bill payment など) を入力します。

  4. (オプション) 説明文を入力します。

  5. [ファイルを見つける] の検索バーで CB00 を見つけ、ファイルを選択します。

  6. [シードとしてマーク] を選択します。

  7. シードフラグが [いいえ] から [はい] に変わることを確認します。

  8. [作成] を選択します。

  9. [保存] を選択します。

  10. [分解] を選択します。

  11. ドメイン名を選択して分解出力を確認します。

  12. 分解が完了したら、送信先 AWS Transformを選択します。

分解とシードの詳細については、 AWS Transform ドキュメントの「分解」を参照してください。

アプリ開発者、アプリオーナー

移行ウェーブを計画する

CardDemo アプリケーションの移行ウェーブを計画します。「 AWS Transform ドキュメント」の「移行ウェーブ計画」の指示に従って、ウェーブ計画を確認して編集します。

アプリ開発者、アプリオーナー

コードをリファクタリングします。

  1. CardDemo メインフレームアプリケーションを、すべてまたは選択したドメインファイルの Java コードにリファクタリングします。 AWS Transform ドキュメントの「リファクタリングコード」の手順に従います。

  2. リファクタリングプロセスが完了したら、モダナイズされた Java アプリケーションを構築してデプロイします。 AWS Transform ドキュメントの「モダナイズされたアプリケーションのリファクタリング後のビルドとデプロイ」の手順に従います。

アプリ開発者、アプリオーナー

(オプション) Reforge を使用して Java コードを改善します。

  1. 新規ジョブを作成し、Reforge the code の目的を入力します。

  2. モダナイズされたプロジェクトの を入力します AWS Transform。このプロジェクトは Amazon S3 バケットにある必要があります。

  3. どのサービスクラスを再フォージするかを指定する Java クラスリストを入力します。

  4. Amazon S3 バケットで生成された出力を確認します。

詳細については、 AWS Transform ドキュメントの「リフォージ」を参照してください。

アプリ開発者、アプリオーナー

デプロイを合理化します。

AWS Transform は、CloudFormation、 AWS CDK、または Terraform の infrastructure as code (IaC) テンプレートを提供できます。これらのテンプレートは、コンピューティング、データベース、ストレージ、セキュリティリソースなどのコアコンポーネントをデプロイするのに役立ちます。

  1. AWS Transform チャットインターフェイスで、 と入力してテンプレートをリクエストします。ここでShare the mainframe refactor <service> templates、 <service>はサポートされている IaC サービスの 1 つです。

  2. 任意のサービスを使用してテンプレートをデプロイします。以下のリソースを参照してください。

詳細については、 AWS Transform ドキュメントの「デプロイ機能」を参照してください。

アプリ開発者、アプリオーナー

トラブルシューティング

問題ソリューション

AWS Transform ウェブアプリケーションでソースコードまたは生成されたドキュメントを表示することはできません。

Amazon S3 バケットの CORS アクセス許可にポリシーを追加して、 をオリジン AWS Transform として許可します。詳細については、 AWS Transform ドキュメントのS3 バケット CORS アクセス許可」を参照してください。

関連リソース

AWS ドキュメント

その他の AWS リソース

動画とチュートリアル

注記

AWS Transform は、以前はメインフレームの Amazon Q Developer 変換と呼ばれていました。