方法: Visual Studio 2019 を使用して Azure Service Fabric で Windows コンテナーをデバッグする

[アーティクル]
10/15/2024

Visual Studio 2019 では、Service Fabric サービスとしてコンテナー内の .NET アプリケーションをデバッグすることができます。この記事では、ご利用の環境を構成し、ローカルの Service Fabric クラスターで実行されているコンテナー内の .NET アプリケーションをデバッグする方法について説明します。

前提条件

Windows 10 では、このクイックスタートに従って Windows コンテナーを実行するように Windows 10 を構成します。
Windows Server 2016 では、このクイックスタートに従って Windows コンテナーを実行するように Windows 2016 を構成します。
「Windows で開発環境を準備する」に従って、ローカルの Service Fabric 環境を設定します。

コンテナーをデバッグするように開発者環境を構成する

次の手順に進む前に、Docker for Window サービスが実行されていることを確認します。
コンテナー間での DNS 解決をサポートするには、マシン名を使用して、ローカルの開発クラスターを設定する必要があります。リバースプロキシ経由でサービスに対応する場合は、以下の手順も必要です。
1. PowerShell を管理者として開きます。
2. SDK クラスターのセットアップフォルダー (通常は C:\Program Files\Microsoft SDKs\Service Fabric\ClusterSetup) に移動します。
3. スクリプト DevClusterSetup.ps1 を実行する
```
  C:\Program Files\Microsoft SDKs\Service Fabric\ClusterSetup\DevClusterSetup.ps1
```
  Note
  
  -CreateOneNodeCluster を使用して、1 ノードクラスターを設定することができます。既定では、ローカルの 5 ノードクラスターが作成されます。
  
  Service Fabric の DNS サービスの詳細については、「Azure Service Fabric の DNS サービス」を参照してください。コンテナーで実行されているサービスから Service Fabric リバースプロキシを使用する方法の詳細については、コンテナーで実行されているサービスに対するリバースプロキシの特別な処理に関する記事をご覧ください。

Service Fabric でコンテナーをデバッグする場合の既知の制限事項

Service Fabric でコンテナーをデバッグする場合の既知の制限事項と考えられる解決策を以下にリストします。

ClusterFQDNorIP の localhost を使用する場合、コンテナーでの DNS 解決はサポートされません。
- 解決策: コンピューター名を使用して、ローカルクラスターを設定します (上記参照)。
仮想マシンで Windows 10 を実行している場合、コンテナーに DNS 応答が返されません。
- 解決策: Virtual Machines NIC で UDP チェックサムオフロード (IPv4 ) を無効にします。
- Windows 10 を実行すると、マシン上のネットワークパフォーマンスが低下します。
- https://github.com/Azure/service-fabric-issues/issues/1061
アプリケーションが Docker Compose を使用してデプロイされた場合、Windows 10 では DNS サービス名を使用して同じアプリケーション内のサービスを解決できません
- 解決策: servicename.applicationname を使用して、サービスエンドポイントを解決します。
- https://github.com/Azure/service-fabric-issues/issues/1062
ClusterFQDNorIP の IP アドレスを使用する場合、ホスト上のプライマリ IP を変更すると、DNS 機能が中断されます。
- 解決策: ホスト上に新しいプライマリ IP を使用してクラスターを再作成するか、コンピューター名を使用します。この中断は仕様です。
ネットワーク上でクラスターの作成時に使用された FQDN を解決できない場合、DNS が失敗します。
- 解決策: ホストのプライマリ IP を使用して、ローカルクラスターを再作成します。このエラーは仕様です。
コンテナーをデバッグする場合、Docker ログは、Service Fabric Explorer を含む、Service Fabric API ではなく、Visual Studio の出力ウィンドウでのみ使用できます。

Service Fabric の Docker コンテナーで実行されている .NET アプリケーションをデバッグする

Visual Studio を管理者として実行します。
既存の .NET アプリケーションを開くか、新しいものを作成します。
プロジェクトを右クリックし、[追加] -> [コンテナーオーケストレーターサポート] -> [Service Fabric] の順に選択します。
F5 キーを押してアプリケーションのデバッグを開始します。

Visual Studio では、.NET および .NET Core のコンソールと ASP.NET プロジェクトタイプがサポートされています。

次のステップ

Service Fabric とコンテナーの機能の詳細については、Service Fabric コンテナーの概要に関するページを参照してください。

次の方法で共有