Anexar o depurador remoto

Beta

Esta funcionalidade está sujeita aos "Termos de ofertas de pré-disponibilidade geral" na secção de Termos de Utilização Gerais dos Termos Específicos do Serviço. As funcionalidades de pré-DG estão disponíveis "tal como estão" e podem ter apoio técnico limitado. Para mais informações, consulte as descrições das fases de lançamento.

Este documento descreve como anexar o depurador remoto do Visual Studio a processos numa máquina virtual do Compute Engine que executa o Windows.

Pré-requisitos

Antes de começar, certifique-se de que a máquina virtual cumpre os seguintes pré-requisitos:

• Executar o sistema operativo Windows

• Tem um endereço IP público

• Tem o PowerShell remoto instalado e ativado

  • Se não quiser ativar a ligação remota do PowerShell ou se não estiver instalada na VM, pode encontrar os passos para instalar as ferramentas remotas do depurador do Visual Studio manualmente pesquisando MSDN Visual Studio Remote Debugging.

  • Também pode adicionar regras de firewall para desbloquear a porta da ferramenta remota do depurador.

Pode implementar uma imagem do framework ASP.NET que cumpra todos estes pré-requisitos.

Anexar o depurador remoto

Para anexar o depurador remoto:

1. Selecione Ferramentas > Ferramentas do Google Cloud > Mostrar explorador do Google Cloud para iniciar o Cloud Explorer.

2. Clique com o botão direito do rato na instância de VM do Compute Engine à qual quer anexar o depurador remoto e selecione Anexar depurador.

   É apresentado o assistente de anexação do depurador.

3. Clique em OK quando lhe for pedido para adicionar regras de firewall para permitir tráfego para as portas necessárias.

   1. O link Saber mais na caixa de diálogo direciona para a secção Abrir portas da firewall para mais informações.

4. Selecione o processo a depurar e clique em OK.

Tenha em conta o seguinte:

• Quando se liga a uma instância de VM remota pela primeira vez, o assistente instala as ferramentas remotas do depurador do Visual Studio. Esta instalação pode demorar algum tempo se a VM estiver numa região diferente.

• As ferramentas de depuração estão instaladas em Program Files\VisualStudioRemoteTools na máquina de destino.

• Tem de carregar símbolos manualmente se otimizar a versão de lançamento:

  1. Enquanto depura a sua aplicação, selecione Depurar > Janelas > Módulos.

  2. Localize o assembly do debuggee.

  3. Clique com o botão direito do rato na entrada adequada e selecione Carregar símbolos.

Abertura de portas de firewall

Para ativar a depuração remota, tem de adicionar regras de firewall para permitir o tráfego para o computador de destino e ativar a ligação às ferramentas remotas de depuração. Para o Visual Studio 2017, a porta é 4022.

O Cloud Tools for Visual Studio pode instalar e iniciar ferramentas remotas para si através de uma ligação remota do PowerShell. Primeiro, tem de ativar a porta HTTPs do PowerShell remoto 5986.

Quando terminar a depuração, remova as regras da firewall:

1. Selecione Ferramentas > Ferramentas do Google Cloud > Mostrar explorador do Google Cloud para iniciar o Cloud Explorer.

2. Clique com o botão direito do rato na instância de VM do Compute Engine e selecione Opções de firewall….

3. Desmarque as caixas de verificação das regras de firewall Allow Visual Studio Debugger connections to the instance e Allow Remote PowerShell HTTPs traffic to the instance.

4. Clique em Guardar para remover as regras da firewall.