ASP.NET ウェブフォームアプリケーションを AWS で最新化

.NET Framework のレガシーアプリケーションを.NET 5 にアップグレードします。

Porting Assistant for .NET で、従来の ASP.NET Web フォームアプリケーションを.NET 5 以降に変換できます。「Porting Assistant for .NET のドキュメント」の指示に従ってください。

NDepend レポートを生成します。

ASP.NET Web フォームアプリケーションをマイクロサービスに分解して最新化すると、レガシーアプリケーションのすべての［.cs］ファイルが必要なくなる場合があります。NDepend を使用すると、任意のコードビハインド (.cs) ファイルのレポートを生成して、すべての呼び出し元と呼び出し先を取得できます。このレポートは、マイクロサービス内の必要なファイルのみを特定して使用するのに役立ちます。

NDepend をインストールしたら (「前提条件」セクションを参照)、Visual Studio でレガシーアプリケーションのソリューション (.sln ファイル) を開き、次の手順に従います。

このプロセスにより、すべての呼び出し元と呼び出し先を一覧表示するコードビハインドファイルのレポートが生成されます。ディペンデンシーグラフについて、詳細は、「NDepend のドキュメント」を参照してください。

新しい .NET 5 ソリューションを作成します。

最新の ASP.NET Core web API 用の新しい .NET 5 (またはそれ以降) 構造を作成するには:

プロジェクトとソリューションの作成について、詳細は、「Visual Studio のドキュメント」を参照してください。

ASP.NET Core でウェブ API を実装します。

従来のモノリスショッピングカートアプリケーションで特定したマイクロサービスの 1 つが製品だと仮定しましょう。前のエピックで製品用の ASP.NET Core Web API プロジェクトを新規作成しました。このステップでは、製品に関連するすべての Web フォーム (.aspx ページ) を識別して最新化します。前述の「アーキテクチャ」セクションで説明したように、［製品］が 4 つのウェブフォームで構成されていると仮定します。

各 ウェブフォームを分析し、何らかのロジックを実行するためにデータベースに送信されるすべてのリクエストを識別し、応答を取得する必要があります。各リクエストをウェブ API エンドポイントとして実装できます。ウェブフォームを考慮すると、製品には以下のエンドポイントを設定できます。

前述のように、ビジネスロジック、データアクセス、共有/共通プロジェクトなど、.NET 5 にアップグレードした他のすべてのプロジェクトを再利用できます。

Amazon CloudWatch Logs を設定します。

「Amazon CloudWatch Logs」を使用して、アプリケーションのログのモニタリング、保存、アクセスを行うことができます。AWS SDK で Amazon CloudWatch Logs にデータを記録できます。また、「NLog」、「Log4Net」、「ASP.NET Core ロギングフレームワーク」など一般的な.NET ロギングフレームワークを使用して、.NET アプリケーションを CloudWatch Logs と統合することもできます。

このステップの詳細については、ブログ記事の「Amazon CloudWatch Logs と.NET ロギングフレームワーク」を参照してください。

AWS Systems Manager Parameter Store を設定します。

「AWS Systems Manager Parameter Store」で、接続文字列などのアプリケーション設定をアプリケーションコードとは別に保存できます。NuGet パッケージ「Amazon.Extensions.Configuration.SystemsManager」を使用すると、アプリケーションがこれらの設定を AWS Systems Manager Parameter Store から .NET Core 設定システムにロードする方法が簡単になります。 

このステップの詳細については、ブログ記事の「AWS Systems Manager向けの.NET Core 設定」を参照してください。

認証には共有 Cookie を使用してください。

従来のモノリスアプリケーションの最新化は反復的なプロセスであり、モノリスと最新化されたバージョンが共存する必要があります。共有 Cookie を使用すると、2 つのバージョン間でシームレスな認証を実現できます。最新の ASP.NET Core アプリケーションが Cookie を検証している間、従来の ASP.NET アプリケーションは引き続きユーザーの認証情報を検証して Cookie を発行します。 

手順とサンプルコードについては、「サンプル GitHub プロジェクト」を参照してください。

Visual Studio を使用して Docker イメージを作成します。

このステップでは、Visual Studio for .NET Core web API を使用して Docker ファイルを作成します。

Visual Studio はお客様のプロジェクト用の Docker ファイルを作成します。サンプル Docker ファイルについては、Microsoft のウェブサイトで「Docker 用 Visual Studio Container Tools」を参照してください。

Docker Desktop を使用してコンテナを構築して実行します。

これで Docker Desktop でコンテナを構築、作成、実行できるようになりました。