附加遠端偵錯工具

本文介紹如何將 Visual Studio 遠端偵錯工具附加到在 Windows 上執行的 Compute Engine 虛擬機器。

事前準備

在開始之前，請確認您的虛擬機器是否滿足下列必備條件：

  • 執行 Windows 作業系統

  • 擁有公開 IP 位址

  • 已安裝並啟用遠端 PowerShell

    • 如果您不想啟用遠端 PowerShell 連線，或者 VM 上並未安裝，您可以搜尋 MSDN Visual Studio 遠端偵錯，瞭解如何手動安裝 Visual Studio 遠端偵錯工具。

    • 或者也可以新增防火牆規則，藉此解除對遠端偵錯工具通訊埠的封鎖。

您可以部署 ASP.NET Framework 映像檔以滿足所有必備條件。

附加遠端偵錯工具

附加遠端偵錯工具：

  1. 依序選取 [Tools] (工具) > [Google Cloud Tools] > [Show Google Cloud Explorer] (顯示 Google Cloud Explorer)，啟動 Cloud Explorer。

  2. 以滑鼠右鍵按一下您想附加遠端偵錯工具的 Compute Engine VM 執行個體，並選取 [Attach debugger] (附加偵錯工具)。

    畫面上隨即顯示附加偵錯工具精靈。

  3. 在系統提示新增防火牆規則以允許必要的通訊埠傳輸流量時，按一下 [OK] (確定)。

    1. 對話方塊中的「Learn more」(瞭解詳情) 連結會帶您到「Opening firewall ports」一節，以取得更多資訊。

  4. 選擇要偵錯的程序，然後按一下 [OK] (確定)。

注意事項：

  • 第一次連結到遠端 VM 執行個體時，精靈會為您安裝 Visual Studio 遠端偵錯工具。如果 VM 位於不同的地區，則安裝作業可能需要一些時間。

  • 偵錯工具安裝在目標機器的 Program Files\VisualStudioRemoteTools 中。

  • 如果您對發佈的版本進行最佳化，則必須手動載入符號：

    1. 在為您的應用程式偵錯時，依序選取 [Debug] (偵錯) > [Windows] > [Modules] (模組)。

    2. 找到您的偵錯目標組件。

    3. 以滑鼠右鍵按一下合適的索引項目並選取 [Load Symbols] (載入符號)。

打開防火牆通訊埠

如要啟用遠端除錯，您需要新增防火牆規則以允許流量傳輸到目標機器，並且啟用連到除錯遠端工具的連線。如果採用 Visual Studio 2017，則通訊埠為 4022。

Cloud Tools for Visual Studio 可以使用遠端 PowerShell 連線為您安裝並啟動遠端工具。首先必須啟用遠端 PowerShell HTTPs 通訊埠 5986。

在您完成除錯後，請將防火牆規則移除。

  1. 依序選取 [Tools] (工具) > [Google Cloud Tools] > [Show Google Cloud Explorer] (顯示 Google Cloud Explorer)，啟動 Cloud Explorer。

  2. 以滑鼠右鍵按一下 Compute Engine VM 執行個體，並選取 [Firewall Options...] (防火牆選項…)。

  3. 取消勾選「Allow Visual Studio Debugger connections to the instance」(允許 Visual Studio 偵錯工具連線至執行個體) 與「Allow Remote PowerShell HTTPs traffic to the instance」(允許遠端 PowerShell HTTPs 至執行個體的流量) 防火牆規則的核取方塊。

  4. 按一下 [Save] (儲存)，移除防火牆規則。