Depurar um serviço de nuvem do Azure no Visual Studio

O Visual Studio oferece a você opções diferentes de depuração das máquinas virtuais e dos Serviços de Nuvem do Azure

Pré-requisitos

• Uma conta do Azure. Se você não tiver uma conta do Azure, ative seus benefícios do Azure para assinantes do Visual Studio ou inscreva-se para uma avaliação gratuita.

Depurar o serviço de nuvem no computador local

Você pode economizar tempo e dinheiro usando o emulador de computação para depurar o serviço de nuvem em um computador local. Ao depurar um serviço localmente antes de implantá-lo, você pode aprimorar a confiabilidade e o desempenho sem pagar pelo tempo de computação. No entanto, alguns erros podem ocorrer somente quando você executa um serviço de nuvem no Azure em si. Você poderá depurar esses erros se habilitar a depuração remota quando publica o serviço e depois anexar o depurador a uma instância de função.

O emulador simula o serviço de computação do Azure e o executa no ambiente local para que você possa testar e depurar o serviço de nuvem antes de implantá-lo. O emulador trata o ciclo de vida das instâncias de função e fornece acesso a recursos simulados, como armazenamento local. Quando você depura ou executa seu serviço no Visual Studio, ele inicia automaticamente o emulador como um aplicativo em segundo plano e, em seguida, implanta o serviço para o emulador. É possível usar o emulador para exibir o serviço quando ele é executado no ambiente local. Você pode executar a versão completa ou a versão expressa do emulador. Consulte Usando o Emulator Expresso para executar e depurar um serviço de nuvem localmente.

Para depurar o serviço de nuvem no computador local

1. Na barra de menus, escolha Depurar>Iniciar depuração para executar o projeto de serviço de nuvem do Azure. Como alternativa, você pode pressionar F5. Será exibida uma mensagem informando que o Emulador de Computação está sendo iniciado. Quando o emulador é iniciado, o ícone da bandeja do sistema o confirma.

   

2. Exiba a interface do usuário do emulador de computação abrindo o menu de atalho do ícone do Azure na área de notificação e selecione Mostrar Interface do Usuário do Emulador de Computação.

   O painel esquerdo da IU usuário mostra os serviços que estão implantados no momento no emulador de computação e as instâncias de função que cada serviço está executando. É possível escolher o serviço ou as funções para exibir o ciclo de vida, o registro em log e as informações de diagnóstico no painel direito. Se você colocar o foco na margem superior de uma janela incluída, ela se expandirá, preenchendo o painel direito.

3. Percorra o aplicativo selecionando os comandos no menu Depurar e definindo pontos de interrupção no código. À medida que você percorre o aplicativo no depurador, os painéis são atualizados com o status atual do aplicativo. Quando você interrompe a depuração, a implantação do aplicativo é excluída. Se seu aplicativo incluir uma função Web e você tiver definido a propriedade de ação de Inicialização para iniciar o navegador da Web, o Visual Studio iniciará o aplicativo Web no navegador. Se você alterar o número de instâncias de uma função na configuração do serviço, deverá parar o serviço de nuvem e reiniciar a depuração de modo que você pode depurar essas novas instâncias da função.

   Observação

   Quando você interrompe a execução ou a depuração do serviço, o emulador de computação local e o emulador de armazenamento não são interrompidos. Também é preciso pará-los explicitamente na área de notificação.

Depurar um perfil de serviço de nuvem no Azure

Se você habilitar a depuração remota para um serviço de nuvem usando o procedimento descrito nesta seção, ela não mostrará degradação de desempenho nem incorrerá em cobranças adicionais. Não use a depuração remota em um serviço de produção, pois os clientes que usam o serviço podem ser prejudicados.

Observação

Ao publicar um serviço de nuvem no Visual Studio, você pode habilitar o IntelliTrace para qualquer função nesse serviço que se destine ao .NET Framework 4 ou .NET Framework 4.x. Usando o IntelliTrace, você pode examinar os eventos que ocorreram em uma instância de função no passado e reproduzir o contexto no tempo em que ocorreu. Consulte Depurando um serviço de nuvem publicado com o IntelliTrace e o Visual Studio e Usando o IntelliTrace.

Para habilitar a depuração remota para um serviço de nuvem (suporte estendido)

1. Adicione um ponto de extremidade ao ServiceDefinition.csdef para a porta msvsmon padrão. Para o Visual Studio 2022, isso é 4026; para Visual Studio 2019, é 4024.

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

   Observação

   Outras versões do Visual Studio têm portas diferentes de Atribuições de Porta do Depurador Remoto.

2. Se você estiver direcionando o .NET 4.8, abra o arquivo ServiceConfiguration.Cloud.cscfg e verifique o valor do atributo osFamily no elemento ServiceConfiguration ao publicar Serviços de Nuvem (suporte estendido). Para um projeto do .NET 4.8, use osFamily="7".

3. Abra o menu de atalho do projeto do Azure e selecione Publicar.

4. Selecione o ambiente de Preparo e a configuração de Depuração.

   Isso é apenas uma diretriz. Você pode optar por executar ambientes de teste em um ambiente de Produção. No entanto, você poderá afetar negativamente os usuários ao habilitar a depuração remota no ambiente de Produção. É possível escolher a configuração de Versão, mas a configuração de Depuração facilita a depuração.

   

5. Siga as etapas usuais descritas em Serviços de Nuvem (suporte estendido), mas marque a caixa de seleção Habilitar Área de Trabalho Remota para todas as funções.

   Você será solicitado a criar um nome de usuário e uma senha para o usuário da área de trabalho remota, que você precisará mais tarde para entrar nessa máquina virtual.

6. Avance para a próxima tela, examine suas configurações e, quando estiver pronto, clique em Publicar e aguarde a conclusão da implantação.

7. Entre no portal do Azure e navegue até o Serviço de Nuvem (suporte estendido) que você deseja depurar.

8. Escolha Funções e Instâncias no painel esquerdo e escolha a função que você está interessado em depurar remotamente.

9. Clique em Conectar no pop-out instância de função à direita e escolha o botão Conectar para baixar um arquivo de área de trabalho remota que permitirá que você entre na máquina virtual. Entre usando as credenciais que você criou quando habilitou a área de trabalho remota em uma etapa anterior.

   

10. Na máquina virtual remota do Azure, instale as ferramentas remotas do Visual Studio 2022, conforme descrito em Depuração remota.

11. Na área de trabalho na máquina virtual, execute o comando D:\Program Files\Microsoft Visual Studio 17.0\Common7\IDE\Remote Debugger\x64\msvsmon.exe. Não se esqueça de executar como Administrador.

12. Aceite prompts para permitir o acesso por meio do firewall. Você deverá ver uma mensagem indicando que msvsmon.exe começou a escutar conexões.

    

13. No Portal do Azure, abra o grupo de recursos e pegue o endereço IP público para o Serviço de Nuvem (suporte estendido).

    

Para anexar o depurador a um serviço de nuvem (suporte estendido) no Azure

Observação

Sempre que possível, você deve depurar com a configuração de Depuração escolhida no processo Publicar , mas se você estiver depurando uma configuração de Versão, no Visual Studio, use Ctrl+Q para pesquisar "Apenas Meu Código" e desmarque Habilitar Apenas Meu Código em Ferramentas>Opções>Depurador>Geral. Os builds de versão são otimizados e, portanto, não são considerados "Meu código".

1. Selecione Depurar>Anexar ao Processo )ou pressione Ctrl+Alt+P).

2. Mantenha o tipo de conexão em Padrão.

3. Insira o destino de conexão usando o endereço IP e a porta: {ipaddress}:4026.

4. Defina Anexar a como Automático.

5. Entre usando as mesmas credenciais que o usuário da área de trabalho remota.

6. Selecione Mostrar processo para todos os usuários. Se você estiver depurando uma função de trabalho, anexe a WaWorkerHost.exe; se você estiver depurando uma função Web, anexe ao processo dew3wp.exe; para uma função de API Web, é WaIISHost.exe.

7. Defina pontos de interrupção (navegue até a linha e pressione F9), acesse a URL pública do site e reproduza o cenário para depuração.

Limitações da depuração remota no Azure

A depuração remota apresenta as seguintes limitações:

• Com a depuração remota habilitada, você não pode publicar um serviço de nuvem no qual qualquer função tenha mais de 25 instâncias.

• O depurador usa as portas 30400 a 30424, 31400 a 31424 e 32400 a 32424. Se você tentar usar algumas delas, não será possível publicar o serviço e uma das seguintes mensagens de erro aparecerá no log de atividades do Azure:

  • Erro ao validar o arquivo .cscfg em relação ao arquivo .csdef. O intervalo de portas reservado 'intervalo' para o ponto de extremidade Microsoft.WindowsAzure.PlugIns.RemoteDebugger.Connector da função 'função' se sobrepõe a uma porta ou intervalo já definido.
  • Falha na alocação. Tente novamente mais tarde, reduzindo o tamanho da VM ou o número de instâncias de função, ou tente implantar em uma região diferente.

Depuração Serviço de Aplicativo do Azure

Você pode depurar programas executados no Serviço de Aplicativo do Azure usando a caixa de diálogo Anexar ao Processo no Visual Studio.

Observação

IIsso só está disponível para o Serviço de Aplicativo do Azure a partir do Visual Studio 2022 17.1.

Para depurar uma Serviço de Aplicativo do Azure do Windows

1. Em Depurar, selecione Anexar ao Processo.

2. Altere o Tipo de conexão para Microsoft Azure App Services e selecione Localizar....

3. Na caixa de diálogo que é aberta, selecione o Nome da assinatura.

   

   Observação

   Você precisa estar conectado a uma conta Microsoft com acesso à assinatura que contém sua Serviço de Aplicativo do Azure.

4. Filtre a exibição por Grupo de Recursos ou Tipo de Recurso ou pesquise por nome.

5. Em seguida, selecione o Serviço de Aplicativo deseja depurar e selecione Ok.

   Isso permite a depuração remota em seu Serviço de Aplicativo e mostra uma lista de processos disponíveis a serem anexados.

   

6. Selecione o processo ao qual você deseja anexar e escolha Anexar para iniciar a depuração.

Conteúdo relacionado

• Use o IntelliTrace para coletar um log de chamadas e eventos de um servidor de versão. Consulte Depurando um serviço de nuvem publicado com o IntelliTrace e o Visual Studio.

• Use o Diagnóstico do Azure para registrar em log informações detalhadas do código em execução nas funções, estejam elas em execução no ambiente de desenvolvimento ou no Azure. Consulte Coletando dados de log usando o Diagnóstico do Azure.

• Para outros cenários de depuração remota, consulte Depuração remota.