Depuração remota do ASP.NET Core no Serviço de Aplicativo do Azure (Windows)
Este artigo descreve como anexar o depurador do Visual Studio a um aplicativo do ASP.NET Core em execução no Serviço de Aplicativo do Azure. As etapas a seguir permitem que você depure o aplicativo como se ele estivesse em execução localmente.
Pré-requisitos
Visual Studio 2022 com as cargas de trabalho Desenvolvimento do ASP.NET e da Web e Desenvolvimento do Azure.
Primeiro, você deve implantar um aplicativo do ASP.NET Core para o Serviço de Aplicativo do Azure (Windows) no Visual Studio, e o aplicativo deve estar em execução.
Para obter treinamento prático que inclui a implantação de Serviço de Aplicativo, consulte Depuração remota do ASP.NET Core no Azure.
Habilitar depuração remota
Antes de depurar esse problema com o Visual Studio, você precisa habilitar o recurso de depuração remota no Serviço de Aplicativo. Essa configuração permitirá que o depurador do Visual Studio se conecte ao processo de hospedagem da Web do Serviço de Aplicativo principal.
Entre no seu próprio portal do Azure.
Localize o aplicativo implantado no portal do Azure. Para encontrar o aplicativo, navegue até a página dos Serviços de Aplicativos e selecione a instância do Serviço de Aplicativo. Você também pode pesquisar a instância do Serviço de Aplicativo diretamente pelo nome na barra de pesquisa na parte superior. (Neste exemplo, a instância do Serviço de Aplicativo é denominada GitHubBrowser123.)
Na página de configurações da instância do Serviço de Aplicativo, selecione Configuração na navegação à esquerda e, em seguida, escolha a guia Configurações gerais.
Na parte inferior da página, defina o recurso de Depuração Remota como Ativado e selecione Visual Studio 2022 como a versão Remota do Visual Studio.
Selecione Salvar na parte superior da página para manter suas alterações.
A instância do serviço de aplicativo agora dá suporte à depuração remota por meio do Visual Studio.
Definir configurações de depuração
Verifique se você concluiu as etapas a seguir no Visual Studio antes de depurar um aplicativo no Azure para garantir o sucesso.
Primeiro, verifique se você compilou o projeto com êxito pelo menos uma vez. Uma compilação bem-sucedida garante que o código-fonte e os arquivos compilados necessários estejam prontos. Se o aplicativo estiver em execução localmente, interrompa-o.
Observação
Verifique se o estado do código local corresponde ao que foi implantado no Azure. Isso garante que os arquivos de símbolo locais e o código-fonte estejam alinhados com o aplicativo implantado.
Selecione Depurar > Opções no menu superior do Visual Studio. Certifique-se de que a opção Habilitar apenas o meu código esteja desmarcada (conforme mostrado abaixo) e selecione OK.
Alterar essa configuração permite que o Visual Studio depure o código otimizado implantado no Azure usando os arquivos de símbolo necessários da pasta de compartimento local. Os arquivos de símbolo são usados pelo depurador como uma ponte entre o código compilado em execução e o código-fonte no Visual Studio, por isso é importante que o código-fonte local corresponda ao aplicativo de implantação.
Anexar o depurador ao Serviço de Aplicativo
No menu principal na parte superior do Visual Studio, selecione Depurar –> Anexar ao processo para abrir a caixa de diálogo correspondente. Usando essa janela, você pode se conectar a destinos diferentes e anexar a eles. Nesse caso, você se conectará à instância do Serviço de Aplicativo criada na etapa anterior.
Selecione a lista suspensa Tipo de Conexão e escolha a opção Serviços de Aplicativos do Microsoft Azure.
Selecione Localizar... ao lado do campo Destino de Conexão para abrir uma caixa de diálogo que permite navegar por suas assinaturas e serviços de aplicativo do Azure.
Localize e selecione a instância do Serviço de Aplicativo que você criou na etapa anterior e escolha OK.
O processo
w3wp.exe
deve aparecer na lista de processos disponíveis para se conectar, sendo o principal processo do Serviço de Aplicativo do Azure que hospeda o aplicativo implantado. Selecione esse processo e escolha Anexar na parte inferior direita para conectar o depurador do Visual Studio.No
Index.cshtml.cs
ou em um arquivo de aplicativo C# diferente, defina um ponto de interrupção clicando na margem esquerda. (Ou, então, clique com o botão direito do mouse e escolha Ponto de interrupção>Inserir ponto de interrupção.)Opcionalmente, você também pode verificar se o Visual Studio carregou os arquivos de símbolo da sua sessão de depuração. Navegue até Depurar > Windows > Módulos para abrir a janela de módulos. Essa janela deve indicar que os arquivos de símbolo foram carregados com êxito após as alterações na configuração Apenas meu código feitas anteriormente.
Comentários
https://aka.ms/ContentUserFeedback.
Brevemente: Ao longo de 2024, vamos descontinuar progressivamente o GitHub Issues como mecanismo de feedback para conteúdos e substituí-lo por um novo sistema de feedback. Para obter mais informações, veja:Submeter e ver comentários