Depurar ASP.NET remotamente em um computador IIS remoto

Para depurar um aplicativo ASP.NET que foi implantado no IIS, instale e execute as ferramentas remotas no computador em que você implantou seu aplicativo e anexe ao aplicativo em execução do Visual Studio.

componentes do depurador remoto

Este guia explica como configurar e configurar um aplicativo do Visual Studio ASP.NET MVC 4.8, implantá-lo no IIS e anexar o depurador remoto do Visual Studio.

Pré-requisitos

O Visual Studio 2019 ou uma versão posterior é necessário para seguir as etapas mostradas neste artigo.

Esses procedimentos foram testados nessas configurações de servidor:

• Windows Server 2022 e IIS 10
• Windows Server 2012 R2 e IIS 8 (para Windows Server 2008 R2, as etapas do servidor são diferentes)

Requisitos de rede

O depurador remoto é compatível com Windows Server a partir do Windows Server 2008 Service Pack 2. Para obter uma lista completa de requisitos, consulte Requirements.

O aplicativo já está em execução no IIS?

Este artigo inclui etapas para configurar uma configuração básica do IIS no servidor Windows e implantar o aplicativo no Visual Studio. Essas etapas são incluídas para garantir que o servidor tenha componentes necessários instalados, que o aplicativo possa ser executado corretamente e que você esteja pronto para depuração remota.

• Se o aplicativo estiver em execução no IIS e você quiser apenas baixar o depurador remoto e iniciar a depuração, acesse Baixar e instalar as ferramentas remotas no Windows Server.

• Se você quiser ajuda para garantir que seu aplicativo esteja configurado, implantado e executado corretamente no IIS para que possa depurar, siga todas as etapas neste artigo.

Criar o aplicativo ASP.NET 4.8 no computador do Visual Studio

1. Crie um novo aplicativo de ASP.NET MVC.

   No Visual Studio, escolha Arquivo>Janela de início para abrir a Janela de início e, em seguida, escolha Criar um novo projeto. Na caixa de pesquisa, digite framework asp.nete, em seguida, escolha Aplicativo Web ASP.NET (.NET Framework). Na caixa de diálogo exibida, nomeie o projeto MyASPApp, escolha ASP.NET Framework 4.8e escolha Criar.

   Selecione MVC e escolha Criar.

2. Abra o arquivo HomeController.cs na pasta Controladores e defina um ponto de interrupção na instrução return View; no método Privacy.

   Em modelos mais antigos, abra o arquivo Privacy.cshtml.cs e defina um ponto de interrupção no método OnGet.

Instalar e configurar o IIS no Windows Server

Essas etapas mostram apenas uma configuração básica do IIS. Para obter informações mais detalhadas ou instalar em um computador Windows Desktop, confira Como publicar no IIS ou IIS 8.0 usando ASP.NET 3.5 e ASP.NET 4.5.

Para sistemas operacionais do Windows Server, use o assistente Adicionar Funções e Recursos pelo link Gerenciar ou do link Painel no Gerenciador do Servidor. Na etapa Funções de Servidor, marque a caixa de Servidor Web (IIS).

(Windows Server 2022) Na caixa de diálogo exibida, escolha Adicionar Recursos para adicionar o Console de Gerenciamento do IIS.

Na etapa Serviços de função, selecione os serviços de função do IIS desejados ou aceite os serviços de função padrão fornecidos. Se você quiser habilitar a implantação usando as configurações de publicação e a Implantação da Web, verifique se os seguintes recursos estão selecionados:

• Scripts e Ferramentas de Gerenciamento do IIS
• Serviço de Gerenciamento
• console de gerenciamento do IIS

Prossiga pelas etapas de confirmação para instalar a função e os serviços do servidor Web. Uma reinicialização do servidor/IIS não é necessária após a instalação da função do Servidor Web (IIS).

Atualizar as configurações de segurança do navegador no Windows Server

Se você estiver usando uma versão mais antiga do Windows Server, talvez seja necessário adicionar alguns domínios como sites confiáveis para permitir que você baixe alguns dos componentes do servidor Web. Adicione os sites confiáveis acessando Opções da Internet > Segurança > Sites Confiáveis > Sites. Adicione os domínios a seguir.

• microsoft.com
• go.microsoft.com
• download.microsoft.com
• iis.net

Ao baixar o software, você pode receber solicitações para conceder permissão para carregar vários scripts e recursos do site. Alguns desses recursos não são necessários, mas para simplificar o processo, selecione Adicionar quando solicitado.

Instalar o ASP.NET 4.8 no Windows Server

Se você quiser mais informações detalhadas para instalar o ASP.NET no IIS, consulte IIS 8.0 Usando ASP.NET 3.5 e ASP.NET 4.5.

1. No painel esquerdo do Gerenciador do Servidor, selecione do IIS. Clique com o botão direito do mouse no servidor e selecione Adicionar Funções e Recursos.

2. No assistente, avance para a seção Recursos e instale ASP.NET 4.8.

   

   Nota

   Se você estiver usando o Windows Server 2008 R2, instale ASP.NET 4 usando este comando:

   C:\Windows\Microsoft.NET\Framework64\v4.0.30319\aspnet_regiis.exe -ir

3. Reinicie o sistema (ou execute net stop was /y seguido por net start w3svc em um prompt de comando para reconhecer uma alteração no PATH do sistema).

Escolher uma opção de implantação

Se você precisar de ajuda para implantar o aplicativo no IIS, considere estas opções:

• Implante criando um arquivo de configurações de publicação no IIS e importando as configurações no Visual Studio. Em alguns cenários, essa é uma maneira rápida de implantar seu aplicativo. Quando você cria o arquivo de configurações de publicação, as permissões são configuradas automaticamente no IIS.

• Implante publicando em uma pasta local e copiando a saída por um método preferencial para uma pasta de aplicativo preparada no IIS.

(Opcional) Implantar usando um arquivo de configurações de publicação

Você pode usar essa opção para criar um arquivo de configurações de publicação e importá-lo para o Visual Studio.

Instalar e configurar o Web Deploy no Windows Server

Web Deploy fornece recursos de configuração adicionais que permitem a criação do arquivo de configurações de publicação pela interface do usuário.

1. Se você ainda não instalou as Ferramentas e Scripts de Gerenciamento do IIS, instale-as agora.

   Vá para Selecionar funções de servidor>Servidor Web (IIS)>Ferramentas de Gerenciamento, e então selecione as funções Scripts de Gerenciamento do IIS e Ferramentas, clique em Avançare instale a função.

   

   Os scripts e as ferramentas são necessários para habilitar a geração do arquivo de configurações de publicação.

   Certifique-se de também instalar o Serviço de Gerenciamento e o Console de Gerenciamento do IIS (eles podem já estar instalados).

2. No Windows Server, baixe a Implantação da Web 4.0.

3. Execute o programa de instalação da Implantação da Web e selecione instalação Completa em vez de uma instalação normal.

   Com uma instalação completa, você obtém os componentes necessários para gerar um arquivo de configurações de publicação. (Se selecionar Personalizado, é possível ver a lista de componentes, conforme mostrado na ilustração a seguir.)

   captura de tela

4. (Opcional) Verifique se o Web Deploy está sendo executado corretamente abrindo Painel de Controle > Sistema e Segurança > Ferramentas Administrativas > Serviços, e verifique se:

   • Serviço do Agente de Implantação Web está em execução (o nome do serviço é diferente em versões mais antigas).

   • O Serviço de Gerenciamento da Web está em execução.

   Se um dos serviços do agente não estiver em execução, reinicie o serviço Agente de Implantação Web .

   Se o Serviço do Web Deployment Agent não estiver presente, acesse Painel de Controle > Programas > Desinstalar um programa, localize Implantação da Web da Microsoft <versão>. Escolha Alterar a instalação e confirme se escolhe a opção Será instalado na unidade de disco rígido local para os componentes de Implantação da Web. Conclua as etapas de instalação da mudança.

Criar o arquivo de configurações de publicação no IIS no Windows Server

1. Feche e reabra o Console de Gerenciamento do IIS para mostrar as opções de configuração atualizadas na interface do usuário.

2. No IIS, clique com o botão direito do mouse em Site Padrão, escolha Implantar>Configurar publicação da Implantação da Web.

   

   Se você não vir o menu Deploy, consulte a seção anterior para verificar se o Web Deploy está em execução.

3. Na caixa de diálogo Configurar publicação da Implantação da Web, examine as configurações.

4. Clique em Configuração.

   No painel Resultados, a saída mostra que os direitos de acesso são concedidos ao usuário especificado e que um arquivo com a extensão .publishsettings foi gerado no local mostrado na caixa de diálogo.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   Dependendo da configuração do Windows Server e do IIS, você verá valores diferentes no arquivo XML. Aqui estão alguns detalhes sobre os valores que você vê:

   • O arquivo msdeploy.axd referenciado no atributo publishUrl é um arquivo de manipulador HTTP gerado de forma dinâmica para o Web Deploy. (Para fins de teste, http://myhostname:8172 geralmente funciona também.)

   • A porta publishUrl é configurada para a porta 8172, que é o padrão para Web Deploy.

   • A porta destinationAppUrl é definida como a porta 80, que é o padrão para o IIS.

   • Se, em etapas posteriores, você não conseguir se conectar ao host remoto do Visual Studio usando o nome do host, teste o endereço IP do servidor no lugar do nome do host.

     Nota

     Se você estiver publicando no IIS em execução em uma VM do Azure, deverá abrir uma porta de entrada para o Web Deploy e o IIS no grupo de segurança de rede. Para obter informações detalhadas, consulte Abrir portas para uma máquina virtual.

5. Copie esse arquivo para o computador no qual você está executando o Visual Studio.

Importar as configurações de publicação no Visual Studio e implantar

1. No computador em que você tem o projeto ASP.NET aberto no Visual Studio, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e escolha Publicar.

   Se você tiver configurado anteriormente quaisquer perfis de publicação, o painel Publicar será exibido. Clique em Novo ou Criar perfil.

2. Selecione a opção para importar um perfil.

   Na caixa de diálogo Publicar, clique em Importar perfil.

   

3. Navegue até o local do arquivo de configurações de publicação que você criou na seção anterior.

4. Na caixa de diálogo Importar Arquivo de Configurações de Publicação, navegue até o perfil que você criou na seção anterior e selecione-o, depois clique em Abrir.

   Clique em Concluir para salvar o perfil de publicação e clique em Publicar.

   O Visual Studio inicia o processo de implantação e a janela Saída mostra o progresso e os resultados.

   Se você receber erros de implantação, clique em Mais Ações>Editar para editar as configurações. Modifique as configurações e clique em Validar para testar novas configurações. Se o nome do host não for encontrado, tente o endereço IP em vez do nome do host nos campos do Servidor e URL de Destino.

   

Depois que o aplicativo for implantado com êxito, ele deverá ser iniciado automaticamente. Se o aplicativo não for iniciado após a implantação, inicie o aplicativo no IIS para verificar se ele é executado corretamente.

Quando você estiver pronto, alterne para uma configuração de depuração.

(Opcional) Implantar publicando em uma pasta local

Você pode usar essa opção para implantar seu aplicativo se quiser copiar o aplicativo para o IIS usando o PowerShell, o RoboCopy ou quiser copiar manualmente os arquivos.

Configurar o site ASP.NET no computador do Windows Server

1. Abra o Windows Explorer e crie uma nova pasta, C:\Publicar, em que posteriormente você implantará o projeto ASP.NET.

2. Se ainda não estiver aberto, abra o Gerenciador de Serviços de Informações da Internet (IIS) . (No painel esquerdo do Gerenciador do Servidor, selecione IIS. Clique com o botão direito do mouse no servidor e selecione Gerenciador dos Serviços de Informações da Internet (IIS).)

3. Em Conexões no painel esquerdo, acesse Sites.

4. Selecione o Site Padrão, escolha Configurações Básicas e defina o Caminho físico como C:\Publish.

5. Clique com o botão direito do mouse no nó Site Padrão e selecione Adicionar Aplicativo.

6. Defina o campo Alias como MyASPApp, aceite o pool de aplicativos padrão (DefaultAppPool) e defina o caminho físico como C:\Publish.

7. Em Conexões, selecione Pools de Aplicativos. Abra DefaultAppPool e defina o campo pool de aplicativos como ASP.NET v4.0 (ASP.NET 4.5 não é uma opção para o pool de aplicativos).

8. Com o site selecionado no Gerenciador do IIS, escolha Editar Permissões e confirme se IUSR, IIS_IUSRS ou o usuário configurado para o Pool de Aplicativos é um usuário autorizado com direitos de execução e de leitura.

   Se você não vir um desses usuários com acesso, siga as etapas para adicionar o IUSR como um usuário com direitos de Leitura e Execução.

Publicar e implantar o aplicativo publicando em uma pasta local do Visual Studio

Você também pode publicar e implantar o aplicativo usando o sistema de arquivos ou outras ferramentas.

Para ASP.NET 4.8, verifique se o arquivo web.config lista a versão correta do .NET.

• Se você estiver almejando o ASP.NET 4.8, verifique se esse valor de versão está listado no arquivo web.config:

      <system.web>
        <compilation debug="true" targetFramework="4.8" />
        <httpRuntime targetFramework="4.8" />
        <httpModules>
          <add name="ApplicationInsightsWebTracking" type="Microsoft.ApplicationInsights.Web.ApplicationInsightsHttpModule, Microsoft.AI.Web" />
        </httpModules>
      </system.web>
      ```
  
  

• Se você instalar ASP.NET 4 em vez de 4.8, o valor da versão deverá ser especificado como 4.0 no arquivo web.config.

Siga estas etapas para publicar e implantar o aplicativo:

1. No Gerenciador de Soluções, clique com o botão direito do mouse no nó do projeto e selecione Publicar (para o Web Forms, Publicar Aplicativo Web).

   Se você tiver configurado anteriormente quaisquer perfis de publicação, o painel Publicar será exibido. Clique em Novo perfil.

2. Na caixa de diálogo Publicar, selecione Pasta, clique em Procurare crie uma nova pasta, C:\Publicar.

   

   Clique em Concluir para salvar o perfil de publicação.

   

   Clique em Concluir para salvar o perfil de publicação.

3. Alterne para uma configuração de depuração.

   Escolha Editar para editar o perfil e depois Configurações. Escolha uma configuração de Depuração e, em seguida, escolha Remover arquivos adicionais no destino nas opções de Publicação do Arquivo.

   

   Nota

   Se você usar um build de Versão, desabilite a depuração no arquivo web.config depois da publicação.

4. Clique em Publicar.

   O aplicativo publica uma configuração Debug do projeto na pasta local. O progresso aparece na janela Saída.

5. Copie o diretório do projeto ASP.NET do computador do Visual Studio para o diretório local configurado para o aplicativo ASP.NET (neste exemplo, C:\Publicar) no computador do Windows Server. Neste tutorial, presumimos que você esteja copiando manualmente, mas pode usar outras ferramentas como PowerShell, Xcopy ou Robocopy.

   Cuidado

   Se você precisar fazer alterações no código ou recompilar, será necessário republicar e repetir esta etapa. O executável copiado para o computador remoto deve corresponder exatamente à origem e aos símbolos locais. Se você não fizer isso, receberá um aviso de cannot find or open the PDB file no Visual Studio ao tentar depurar o processo.

6. No Windows Server, verifique se você pode executar o aplicativo corretamente abrindo o aplicativo no navegador.

   Se o aplicativo não for executado corretamente, pode haver uma incompatibilidade entre a versão do ASP.NET instalada no servidor e no computador do Visual Studio, ou você pode ter um problema com a configuração do IIS ou do site. Verifique novamente as etapas anteriores.

Baixar e instalar as ferramentas remotas no Windows Server

Baixe a versão das ferramentas remotas que correspondem à sua versão do Visual Studio.

No dispositivo ou servidor remoto no qual você deseja depurar, em vez do computador do Visual Studio, baixe e instale a versão correta das ferramentas remotas dos links na tabela a seguir.

• Baixe as ferramentas remotas com a mesma arquitetura do computador em que você as está instalando. Por exemplo, se você quiser depurar aplicativos x86 em um computador remoto executando um sistema operacional x64, instale as ferramentas remotas x64. Para depurar aplicativos x86, ARM ou x64 em um sistema operacional ARM64, instale as ferramentas remotas ARM64.

Você pode executar o depurador remoto copiando msvsmon.exe para o computador remoto, em vez de instalar as ferramentas remotas. No entanto, o Assistente de Configuração do Depurador Remoto (rdbgwiz.exe) só está disponível quando você instala as ferramentas remotas. Talvez seja necessário usar o assistente de configuração se desejar executar o depurador remoto como um serviço. Para obter mais informações, confira (Opcional) Configurar o depurador remoto como um serviço.

Configurar o depurador remoto no Windows Server

1. No computador remoto, localize e inicie o Depurador Remoto no menu Iniciar.

   Se você não tiver permissões administrativas no computador remoto, clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Caso contrário, basta iniciá-lo normalmente.

   Se você estiver planejando anexar a um processo que está em execução como administrador ou estiver em execução em outra conta de usuário (como o IIS), clique com o botão direito do mouse no aplicativo Depurador Remoto e selecione Executar como administrador. Para obter mais informações, confira Executar o depurador remoto como administrador.

2. Na primeira vez que você iniciar o depurador remoto (ou antes de configurá-lo), o assistente de Configuração de Depuração Remota aparece.

   Na maioria dos cenários, escolha Avançar até chegar à página do assistente Configurar o Firewall do Windows.

   

   

   Se a API dos Serviços Web do Windows não estiver instalada, o que acontece apenas no Windows Server 2008 R2, selecione o botão Instalar.

3. Selecione pelo menos um tipo de rede em que você deseja usar as ferramentas remotas. Se os computadores estiverem conectados por meio de um domínio, você deverá escolher o primeiro item. Se os computadores estiverem conectados por meio de um grupo de trabalho ou homegroup, escolha o segundo ou terceiro item conforme apropriado.

   Depois, selecione Concluir para iniciar o depurador remoto.

   Em seguida, selecione Configurar depuração remota para iniciar o depurador remoto.

4. Quando a configuração for concluída, a janela Depurador Remoto será exibida.

   

   

   Agora o depurador remoto está aguardando uma conexão. Use o nome do servidor e o número da porta mostrados para definir a configuração de conexão remota no Visual Studio.

Para interromper o depurador remoto, selecioneArquivo>Sair. Você pode reiniciá-lo no menu Iniciar ou na linha de comando:

<Remote debugger installation directory>\msvsmon.exe

Para obter informações sobre como executar o depurador remoto como um serviço, consulte Executar o depurador remoto como um serviço.

Conectar ao aplicativo ASP.NET a partir do computador com Visual Studio

4. Selecione Atualizar.

   Você deverá ver alguns processos aparecerem na janela Processos Disponíveis.

   Se você não vir nenhum processo, tente usar o endereço IP em vez do nome do computador remoto (a porta é necessária). Você pode usar ipconfig em uma linha de comando para obter o endereço IPv4.

   Se você quiser usar o botão Localizar, talvez seja necessário abrir a porta UDP de saída 3702 no servidor.

5. Verifique Mostrar processos de todos os usuários.

6. Digite a primeira letra de um nome de processo para localizar rapidamente w3wp.exe para ASP.NET 4.5.

   Se você tiver vários processos mostrando w3wp.exe, verifique a coluna Nome de Usuário. Em alguns cenários, a coluna Nome de Usuário mostra o nome do pool de aplicativos, como IIS APPPOOL\DefaultAppPool. Se você vir o Pool de Aplicativos, uma maneira fácil de identificar o processo correto é criar um novo Pool de Aplicativos nomeado para a instância do aplicativo que você deseja depurar e, em seguida, você pode encontrá-lo facilmente na coluna Nome de Usuário.

   

   

7. Selecione Anexar.

8. Abra o site do computador remoto. Em um navegador, acesse http://<nome do computador remoto>.

   Você deverá ver a página da web ASP.NET.

9. No aplicativo ASP.NET em execução, selecione o link para a página Privacidade.

   O ponto de interrupção deve ser atingido no Visual Studio.

   Se você não conseguir anexar nem atingir o ponto de interrupção, confira Solucionar problemas de depuração remota.

Solução de problemas de implantação do IIS

• Se você não conseguir se conectar ao host usando o nome do host, tente o endereço IP.
• Verifique se as portas necessárias estão abertas no servidor remoto.
• Verifique se a versão de ASP.NET usada em seu aplicativo é a mesma que a versão instalada no servidor. Para o aplicativo, confira e defina a versão na página Propriedades. Para definir o aplicativo como uma versão diferente, essa versão deve ser instalada.
• Se o aplicativo tentou abrir, mas você vê um aviso de certificado, escolha confiar no site. Se você já fechou o aviso, poderá editar o perfil de publicação, um arquivo *.pubxml, em seu projeto e adicionar o seguinte elemento (somente para teste): <AllowUntrustedCertificate>true</AllowUntrustedCertificate>
• Depois de implantado, inicie o aplicativo no IIS para testar se ele foi implantado corretamente.
• Verifique a janela Saída no Visual Studio para obter informações de status e verifique as mensagens de erro.

Abrir portas necessárias no Windows Server

Na maioria das configurações, as portas necessárias são abertas pela instalação do ASP.NET e do depurador remoto. No entanto, talvez seja necessário verificar se as portas estão abertas.

Portas obrigatórias:

• 80: Necessário para o IIS.

• 4024: necessário para depuração remota do Visual Studio 2019 (consulte Atribuições de porta do depurador remoto para obter mais informações).

• UDP 3702: (Opcional) a porta de descoberta permite que você use o botão Localizar ao anexar ao depurador remoto no Visual Studio.

Além disso, essas portas já devem ser abertas pela instalação do ASP.NET:

• 8172: (Opcional) Necessário para que o Web Deploy implante o aplicativo a partir do Visual Studio.

Abrir uma porta

1. Para abrir uma porta no Windows Server, abra o menu iniciar, pesquise por Windows Defender Firewall ou Windows Firewall com Segurança Avançada.

   Em Windows Defender Firewall, escolha Configurações avançadas.

2. Em seguida, escolha Regras de Entrada > Nova Regra> Porta. Escolha Avançar e, em Portas Locais Específicas, insira o número da porta, selecione Avançare, em seguida, Permitir a Conexão, selecione Avançar e adicione o nome (IIS, Web Deployou msvsmon) para a Regra de Entrada.

   Se você quiser mais detalhes sobre como configurar o Firewall do Windows, consulte Configurar o Firewall do Windows para Depuração Remota.

3. Crie mais regras para as outras portas necessárias.