ASP.NET Core：アプリケーションのWebサービスフロントエンドの作成

ASP.NET Coreの使用に関する資料を引き続き共有します。 前の記事で、 IISを使用してNano ServerにASP.NET Coreアプリケーションを展開することについて説明しました 。 今日は、アプリケーションの外部Webサービスインターフェイスの作成について説明します。

ASP.NET Coreに関する記事の最初のシリーズ

1. Nano Server上のASP.NET Core 。

2. アプリケーションのWebサービスフロントエンドを作成します 。

3. ASP.NET Core MVCおよびVisual Studioを使用した最初のWeb APIの作成 。

4. Visual Studioを使用して、WebアプリケーションをAzure Application Serviceにデプロイします 。

5. Visual Studio Codeを使用した最初のMacアプリケーション 。



既定では、 Azure Service FabricはWebサービスのパブリックインターフェイスを提供しません。 アプリケーションをHTTPクライアントに対して機能させるには、エントリポイントとして機能し、個々のサービスとデータを交換するWebプロジェクトを作成する必要があります。



この記事では、ステートフルカウンターサービス用のWebサービスをVisual Studioアプリケーションに追加します。 Visual Studioでアプリケーションを作成する基本的なプロセスに慣れていない場合は、 こちらにアクセスしてください。

ASP.NET Coreサービスをアプリケーションに追加する

ASP.NET Coreは、最新のWebユーザーインターフェイスとWeb APIを作成できるシンプルなクロスプラットフォームWeb開発ツールです。 ASP.NET Web APIプロジェクトを既存のアプリケーションに追加しましょう。



1.ソリューションエクスプローラーでアプリケーションプロジェクトを開いた状態で、[ サービス ]を右クリックし、[ 追加]> [新しいService Fabric Service ]を選択します。







2. [ サービスの作成]ページで[ ASP.NET Core]を選択し、このサービスの名前を指定します。







3.次のページは、ASP.NET Coreプロジェクトテンプレートセットを示しています。 これらは、Service Fabricアプリケーションの外部でASP.NET Coreプロジェクトを作成するときに使用されるものと同じパターンであることに注意してください。 このガイドでは、 Web APIを使用します 。 ただし、これらのメソッドを使用して本格的なWebアプリケーションを作成できます。







注：さらに作業を進めるには、 .NET Core 1.0をインストールする必要があります 。



Web APIを作成した後、アプリケーションには2つのサービスがあります。 アプリケーションを改良するときに、同じ方法で新しいサービスを追加できます。 これらの各サービスは、特定のバージョンを含め、個別に更新できます。



注：ASP.NET Coreサービスの作成の詳細については、ASP.NET Coreのドキュメントを参照してください。

アプリケーションの起動

実行した手順をよりよく理解するために、新しいアプリケーションをデプロイし、ASP.NET Core Web APIテンプレートの使用に関連するデフォルトの動作を見てみましょう。



1.アプリケーションをデバッグするには、Visual StudioでF5を押します。



2.配置が完了すると、Visual StudioはASP.NET Web APIサービスのルートディレクトリ（たとえば、 localhost ：33003）でブラウザーを起動します。 ポート番号は任意に割り当てられ、異なる場合があります。 Web APIテンプレートは、ルートディレクトリのデフォルトの動作を提供しないため、ブラウザにエラーメッセージが表示されます。



3.ブラウザのアドレスにパス/api/values



を追加します。 これにより、Web APIテンプレートのValuesControllerオブジェクトのGet



メソッドが呼び出されます。 テンプレートによって提供されるデフォルトの応答、2行を含むJSON配列を返します。







このガイドの手順を完了すると、デフォルト値はステータスカウンターサービスカウンターの最後の値に置き換えられます。

サービス接続

Service Fabricを使用すると、Reliable Servicesと自由にやり取りできます。 1つのアプリケーションには、TCP経由で利用可能なサービスと、HTTP REST API経由で利用可能なサービス、およびWebソケット経由で利用可能なサービスがあります（可能なオプションと理想的な比率の選択については、 記事を参照してください ）。 ここでは、最も単純なアプローチの1つを使用し、SDKで提供されるServiceProxy/ServiceRemotingListener



クラスを使用します。



ServiceProxy



（リモートプロシージャコールまたはRPCに基づく）を使用するアプローチは、パブリックサービスコントラクトとして機能するインターフェイスを定義します。 次に、このインターフェイスを使用して、サービスと対話するためのプロキシクラスを作成します。

インターフェイス作成

ASP.NET Coreプロジェクトを含む、ステートフルサービスとそのクライアント間のコントラクトとして機能するインターフェイスを作成することから始めましょう。



1.ソリューションエクスプローラーで、ソリューションを右クリックし、[ 追加]> [新しいプロジェクト ]を選択します。



2.左側のナビゲーションペインで、[ Visual C＃]を選択し、 クラスライブラリテンプレートを選択します。 .NET Framework 4.5.2バージョンが選択されていることを確認します 。







3. ServiceProxy



が使用するインターフェイスについては、IServiceインターフェイスから派生する必要があります。 このインターフェイスは、NuGet Service Fabricパッケージの1つに含まれています。 パッケージを追加するには、クラスライブラリプロジェクトを右クリックし、 [NuGetパッケージの管理 ]を選択します。



4. Microsoft.ServiceFabric.Servicesパッケージを見つけてインストールします。







5.クラスライブラリで、単一のGetCountAsync



インターフェイスを使用してインターフェイスを作成し、IServiceからインターフェイスを拡張します。

 namespace MyStatefulService.Interfaces { using Microsoft.ServiceFabric.Services.Remoting; public interface ICounter: IService { Task<long> GetCountAsync(); } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ステートフルサービスでのインターフェイスの実装

インターフェースが定義されたので、ステートフルサービスに実装する必要があります。



1.ステートフルサービスで、このインターフェイスを含むクラスライブラリプロジェクトへのリンクを追加します。







2. StatefulService



から継承するクラス（ MyStatefulService



など）をMyStatefulService



、それを拡張してICounter



インターフェイスを実装します。

 using MyStatefulService.Interfaces; ... public class MyStatefulService : StatefulService, ICounter { // ... }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

3. ICounter



インターフェイスで指定された単一メソッドGetCountAsync



ICounter



ます。

 public async Task<long> GetCountAsync() { var myDictionary = await this.StateManager.GetOrAddAsync<IReliableDictionary<string, long>>("myDictionary"); using (var tx = this.StateManager.CreateTransaction()) { var result = await myDictionary.TryGetValueAsync(tx, "Counter"); return result.HasValue ? result.Value : 0; } }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

サービスリモーティングリスナーによるステートフルサービスの提供

ICounter



インターフェイスを実装した後、他のサービスから状態を監視してサービスを呼び出すことを可能にする最後の手順は、通信チャネルを開くことです。 ステートフルサービスの場合、Service FabricはCreateServiceReplicaListeners



と呼ばれるオーバーライドメソッドを提供します。 このメソッドを使用すると、サービスで使用する通信のタイプに基づいて1つ以上の通信リスナーを指定できます。



注：ステートレスサービスの通信チャネルを開くためのメソッドに相当するものはCreateServiceInstanceListeners



です。



この例では、既存のCreateServiceReplicaListeners



メソッドを置き換えて、 ServiceProxy



を使用してクライアントが呼び出すRPCエンドポイントを作成するServiceRemotingListener



インスタンスを使用します。

 using Microsoft.ServiceFabric.Services.Remoting.Runtime; ... protected override IEnumerable<ServiceReplicaListener> CreateServiceReplicaListeners() { return new List<ServiceReplicaListener>() { new ServiceReplicaListener( (context) => this.CreateServiceRemotingListener(context)) }; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

ServiceProxyクラスを使用してサービスと対話する

準備した状態追跡サービスは、他のサービスからトラフィックを受信する準備ができています。 したがって、ASP.NET Webサービスから対話するコードを追加するだけです。



1. ASP.NETプロジェクトで、 ICounter



インターフェイスを含むクラスライブラリへの参照を追加します。



2. [ ビルド ]メニューから、 構成マネージャーを開きます。 次のようなものが表示されるはずです。







MyStatefulService.Interfaceクラスライブラリプロジェクトでは、任意のCPUが選択されていることに注意してください。 Service Fabricで正しく動作するには、64ビットプラットフォームを使用する必要があります。 [プラットフォーム]ドロップダウンメニューを開き、[ 新規 ]を選択して64ビットプラットフォームを構成します。







3.以前にクラスライブラリプロジェクトで行ったように、Microsoft.ServiceFabric.ServicesパッケージをASP.NETプロジェクトに追加します。 ServiceProxy



クラスが追加されます。



4. Controllersフォルダーで、 ValuesController



クラスを開きます。 現時点では、 Get



メソッドは、ブラウザーで前に見たものに対応する、values1とvalue2のインライン文字列配列を返すことに注意してください。 この実装を次のコードに置き換えます。

 using MyStatefulService.Interfaces; using Microsoft.ServiceFabric.Services.Remoting.Client; ... public async Task<IEnumerable<string>> Get() { ICounter counter = ServiceProxy.Create<ICounter>(new Uri("fabric:/MyApplication/MyStatefulService"), new ServicePartitionKey(0)); long count = await counter.GetCountAsync(); return new string[] { count.ToString() }; }
      
      

        
        
        
      

    
        
        
        
      
      

        
        
        
      

    
     

コードの最初の行はキーです。 ステートフルサービスにICounterプロキシを追加するには、セクション識別子とサービス名の2種類のデータを提供する必要があります。



パーティショニングを使用して、状態追跡サービスをスケーリングできます。たとえば、顧客IDや郵便番号など、指定したキーに基づいて、状態を異なるセグメントに分割できます。 このアプリケーションでは、ステートフルサービスにはパーティションが1つしかないため、キーは関係ありません。 指定されたキーはすべて同じセクションになります。 パーティション作成の詳細については、 記事を参照してください 。



サービス名は、fabric：/ <application_name> / <service_name>という形式の一意のリソースコードです。



この情報を使用して、Service Fabricは要求の送信先のコンピューターを正確に識別できます。 また、 ServiceProxy



クラスは、状態監視サービスパーティションをホストするコンピューターで障害が発生した場合、一貫して操作を別のコンピューターに切り替えます。 この抽象化により、他のサービスと連携するためのクライアントコードを簡単に記述できます。



プロキシサーバーを作成したら、GetCountAsyncメソッドを呼び出して結果を取得します。



5. F5キーを押して、変更したアプリケーションを起動します。 前回と同様に、ブラウザが自動的に起動し、Webプロジェクトのルートディレクトリがロードされます。 パス「api / values」を追加すると、カウンターの現在の戻り値が表示されます。







ブラウザを更新して、カウンター読み取り値の変更を追跡します。



テンプレートで指定され、Kestrelとして知られるASP.NET Core Webサーバーは、直接インターネットトラフィックの処理をサポートしていないことを覚えておくことが重要です。 運用シナリオでは、ASP.NET CoreエンドポイントをAPI Managementサービスまたはインターネットアクセスを備えた他のゲートウェイの背後に配置することを検討してください。 IISでの展開では、Service Fabricはサポートされていないことに注意してください。

被験者とのデータ交換

ここでは、ステートフルサービスとの通信を提供するWebインターフェイスの追加について説明します。 ただし、同様のモデルを使用して、被験者とデータを交換できます。 さらに簡単です。



Visual Studioでサブジェクトプロジェクトを作成すると、インターフェイスプロジェクトが自動的に作成されます。 このインターフェイスを使用して、Webプロジェクトにサブジェクトと対話するためのサブジェクトのプロキシサーバーを作成できます。 通信チャネルは自動的に提供されます。 したがって、 ServiceRemotingListener



サービスの場合のように、 ServiceRemotingListener



を構成するためのアクションを実行する必要はありません。

ローカルクラスタでのWebサービスの動作

ローカルクラスターに展開されたService Fabricは、通常、複数のコンピューターを含むクラスターに展開できます。 このアプリは正常に動作します。 これは、ローカルクラスターが同じコンピューター上にある5ノード構成であるためです。



ただし、1つの重要な機能がWebサービスに関連付けられています。 Azure環境で提供されているようにクラスターがロードバランサーに含まれていない場合は、Webサービスが各コンピューターに展開されていることを確認する必要があります。 これは、ロードバランサーがコンピューター間のトラフィックを単純にループするために必要です。 これを行うには、サービスのInstanceCount



パラメーターに特別な値「-1」を指定します。



それどころか、Webサービスをローカルで実行する場合、サービスのインスタンスが1つだけ実行されていることを確認する必要があります。 そうしないと、同じパスとポートでリッスンしている複数のプロセスと競合します。 したがって、ローカル展開では、Webサービスインスタンスカウンターを「1」に設定する必要があります。



さまざまな環境にさまざまな値を設定する方法の詳細については、 記事を参照してください 。