Visual Studio で Azure クラウド サービスをデバッグする

Visual Studio には、Azure Cloud Services と仮想マシンのデバッグに役立つさまざまなオプションがあります。

前提条件

• Azure アカウント。 Azure アカウントがない場合は、Visual Studio サブスクライバー向けの Azure の特典を有効にするか、無料試用版にサインアップします。

ローカル コンピューターでクラウド サービスをデバッグする

Azure コンピューティング エミュレーターを使用してローカル コンピューターでクラウド サービスをデバッグすれば、時間とコストの節約になります。 サービスをデプロイする前にローカルでデバッグすると、コンピューティング時間の料金を支払うことなく、信頼性とパフォーマンスを改善できます。 ただし、一部には Azure でクラウド サービスを実行した場合にのみ発生するエラーもあります。 サービスを発行し、デバッガーをロール インスタンスにアタッチするときに、リモート デバッグを有効にすると、このようなエラーをデバッグできます。

エミュレーターは、Azure コンピューティング サービスをシミュレートし、ローカル環境で動作するので、クラウド サービスのテストとデバッグを行ってからデプロイすることができます。 エミュレーターでは、ロール インスタンスのライフサイクルが処理され、ローカル ストレージなどのシミュレートされるリソースにアクセスできます。 Visual Studio でサービスをデバッグまたは実行すると、エミュレーターがバックグラウンド アプリケーションとして自動的に起動され、サービスがエミュレーターにデプロイされます。 エミュレーターを使用すると、ローカル環境で実行されているサービスを表示できます。 完全バージョンまたは Express バージョンのエミュレーターを実行できます 「Emulator Express を使用したローカルでのクラウド サービス実行とデバッグ」を参照してください。

ローカル コンピューターでクラウド サービスをデバッグするには

1. メニュー バーで、 [デバッグ]>[デバッグの開始] の順に選択し、Azure クラウド サービス プロジェクトを実行します。 または、F5 キーを押します。 コンピューティング エミュレーターが起動することを示すメッセージが表示されます。 エミュレーターが起動すると、システム トレイ アイコンでそのことを確認できます。

   

2. 通知領域にある Azure アイコンのショートカット メニューを開いて [コンピューティング エミュレーターの UI を表示]を選択し、コンピューティング エミュレーターのユーザー インターフェイスを表示します。

   UI の左側にあるウィンドウには、現在コンピューティング エミュレーターにデプロイされているサービスと各サービスが実行しているロール インスタンスが表示されます。 サービスまたはロールを選択すると、右ペインにライフサイクル情報、ログ情報、および診断情報を表示できます。 含まれているウィンドウの上部余白にフォーカスを置くと、ウィンドウが右ペイン全体に拡大します。

3. [デバッグ] メニューのコマンドを選択し、コードにブレークポイントを設定して、アプリケーションをステップ実行します。 デバッガーでのアプリケーションのステップ実行に合わせてウィンドウが更新され、アプリケーションの現在の状態が表示されます。 デバッグを停止すると、アプリケーションのデプロイは削除されます。 アプリケーションに Web ロールが含まれていて、スタートアップ アクション プロパティで Web ブラウザーを起動するように設定している場合は、Visual Studio によってブラウザーで Web アプリケーションが起動されます。 サービス構成でロールのインスタンス数を変更する場合は、ロールのこれらの新しいインスタンスをデバッグできるように、クラウド サービスを停止してからデバッグを再開する必要があります。

   注意

   サービスの実行またはデバッグを停止しても、ローカルのコンピューティング エミュレーターとストレージ エミュレーターは停止されません。 これらは、通知領域から明示的に停止する必要があります。

Azure でクラウド サービスをデバッグする

このセクションの手順を使用してクラウド サービスのリモート デバッグを有効にしても、パフォーマンスが低下したり、追加料金が発生したりすることはありません。 運用サービスでは、サービスを利用するクライアントに悪影響が生じる可能性があるため、リモート デバッグを使用しないでください。

Note

Visual Studio からクラウド サービスを発行する場合、.NET Framework 4 または .NET Framework 4.x を対象とするサービスのどのロールに対しても IntelliTrace を有効にできます。 IntelliTraceを使用すると、過去にロール インスタンスで発生したイベントを調べ、そのときのコンテキストを再現できます。 IntelliTrace および Visual Studio を使用した発行済みのクラウド サービスのデバッグに関するページ、および「IntelliTrace の使用」を参照してください。

クラウド サービスのリモート デバッグを有効にする (延長サポート)

1. 既定の msvsmon ポートの ServiceDefinition.csdef にエンドポイントを追加します。 Visual Studio 2022 の場合は 4026 で、Visual Studio 2019 の場合は 4024 です。

   <Endpoints>
      <InputEndpoint name="RemoteDebug" protocol="tcp" port="4026" localPort="4026" />
   </Endpoints>
   

   注意

   Visual Studio の他のバージョンでは、異なるポートが割り当てられます (「リモート デバッガーのポートの割り当て」)。

2. .NET 4.8 を対象としている場合、Cloud Services (延長サポート) を発行するときに必ず ServiceConfiguration.Cloud.cscfg ファイルを開き、ServiceConfiguration 要素の osFamily 属性の値を確認してください。 .NET 4.8 プロジェクトの場合は、osFamily="7" を使用します。

3. Azure プロジェクトのショートカット メニューを開き、 [発行]を選択します。

4. [ステージング] 環境と [デバッグ] 構成を選択します。

   これは、単なるガイドラインです。 運用環境でテスト環境を実行することもできます。 ただし、運用環境でリモート デバッグを有効にすると、ユーザーに悪影響が生じる可能性があります。 リリース構成も選択できますが、デバッグ構成の方がデバッグは簡単です。

   

5. Cloud Services (延長サポート) に関する記事で説明されている通常の手順に従います。ただし、[すべてのロールに対してリモート デスクトップを有効にする] チェックボックスをオンにします。

   リモート デスクトップ ユーザーのユーザー名とパスワードを作成するように求められます。これらは後でその仮想マシンにサインインするために必要です。

6. 次の画面に進み、設定を確認し、準備ができたら [発行] をクリックし、デプロイが完了するまで待ちます。

7. Azure portal にサインインし、デバッグするクラウド サービス (延長サポート) に移動します。

8. 左側のウィンドウで [ロールとインスタンス] を選択し、リモートでデバッグする対象のロールを選択します。

9. 右側の [ロール インスタンス] ポップアウトで [接続] をクリックし、[接続] ボタンを選択して、仮想マシンにサインインできるリモート デスクトップ ファイルをダウンロードします。 前の手順でリモート デスクトップを有効にしたときに作成した資格情報を使用してサインインします。

   

10. リモート Azure 仮想マシンで、「リモート デバッグ」の説明に従って Visual Studio 2022 をインストールします。

11. 仮想マシンのデスクトップから、コマンド D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe を実行します。 必ず管理者として実行してください。

12. ファイアウォール経由のアクセスを許可するように求めるメッセージに同意します。 msvsmon.exe で接続のリッスンが開始されたことを示すメッセージが表示されます。

    

13. Azure portal で、リソース グループを開き、クラウド サービス (延長サポート) のパブリック IP アドレスを取得します。

    

Azure でデバッガーをクラウド サービスにアタッチする (延長サポート)

注意

可能な限り、[発行] プロセスで選択した [デバッグ] 構成でデバッグする必要がありますが、[リリース] 構成をデバッグする場合は、Visual Studio で Ctrl+Q キーを使用して "マイ コードのみ" を検索し、[ツール]>[オプション]>[デバッガー]>[全般] で [マイ コードのみを有効にする] をオフにします。 リリース ビルドは最適化されているため、"マイ コード" とは見なされません。

1. [デバッグ]>[プロセスにアタッチ] を選択します (または Ctrl+Alt+P キーを押します)。

2. 接続の種類は [既定] のままにします。

3. IP アドレスとポートを使用して接続先を入力します ({ipaddress}:4026)。

4. [アタッチ先] を [自動] に設定します。

5. リモート デスクトップ ユーザーと同じ資格情報を使用してサインインします。

6. [すべてのユーザーのプロセスを表示する] を選択します。 worker ロールをデバッグする場合は、WaWorkerHost.exe にアタッチします。Web ロールをデバッグする場合は、w3wp.exe プロセスにアタッチします。Web API ロールの場合は、WaIISHost.exe です。

7. ブレークポイント (行に移動し、F9 キーを押します) を設定し、サイトのパブリック URL にアクセスし、デバッグするシナリオを再現します。

Azure でのリモート デバッグの制限

リモート デバッグには次の制限があります。

• リモート デバッグを有効にすると、インスタンス数が 25 を超えるロールではクラウド サービスを発行できません。

• デバッガーで使用されるポートは、30400 ～ 30424、31400 ～ 31424、および 32400 ～ 32424 です。 これらのポートを使用しようとすると、サービスの発行はできず、次のいずれかのエラー メッセージが Azure のアクティビティ ログに出力されます。

  • .csdef ファイルに対して .cscfg ファイルを検証しているときにエラーが発生しました。 ロール 'ロール' エンドポイント Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector の予約されたポート範囲 '範囲' は、定義済みのポートまたは範囲と重複しています。
  • 割り当てに失敗しました。 後で再試行するか、VM のサイズまたはロール インスタンスの数を減らすか、別のリージョンにデプロイしてください。

Azure App Service のデバッグ

Azure App Service で実行しているプログラムをデバッグするには、Visual Studio の [プロセスにアタッチ] ダイアログを使用できます。

Note

これは、Visual Studio 2022 17.1 以降の Azure App Service でのみ使用できます。

Windows Azure App Service をデバッグするには

1. [デバッグ] の下の [プロセスにアタッチ] を選択します。

2. [接続の種類] を [Microsoft Azure App Service] に変更してから、 [検索..] を選択します。

3. 表示されるダイアログ ボックスで、 [サブスクリプション名] を選択します。

   

   Note

   Azure App Service を含むサブスクリプションへのアクセス権を持つ Microsoft アカウントにサインインしている必要があります。

4. [リソース グループ] または [リソースの種類] でビューをフィルター処理するか、名前で検索します。

5. 次に、デバッグする App Service を選択し、 [OK] を選択します。

   これにより、App Service に対するリモート デバッグが有効になり、アタッチできるプロセスの一覧が表示されます。

   

6. アタッチするプロセスを選択した後、 [アタッチ] を選択してデバッグを開始します。

関連するコンテンツ

• IntelliTrace を使用して、リリース サーバーから呼び出しおよびイベントのログを収集します。 IntelliTrace および Visual Studio を使用した発行済みのクラウド サービスのデバッグに関するページを参照してください。

• Azure Diagnostics を使用して、ロールが開発環境と Azure のどちらで実行されているかにかかわらず、ロール内で実行されているコードの詳細な情報をログに記録します。 「 Azure Diagnostics を使用したログ データの収集」を参照してください。

• リモート デバッグのその他のシナリオについては、「リモート デバッグ」をご覧ください。