Depurar um serviço dos Serviços de Nuvem do Azure (suporte estendido) no Visual Studio

O Visual Studio oferece opções diferentes para depurar os Serviços de Nuvem do Azure (suporte estendido) e máquinas virtuais.

Pré-requisitos

• Visual Studio (confira [Downloads do Visual Studio] (https://visualstudio.microsoft.com/downloads/?cid=learn-onpage-download-cta)) com a carga de trabalho de Desenvolvimento do Azure instalada e o Componente Individual modelos de projeto e item do .NET Framework instalados. Confira Modificar o Visual Studio.
• Uma conta do Azure. Se você não tem 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 do Azure para depurar seu serviço de nuvem em um computador local. Ao depurar um serviço localmente antes de implantá-lo, você pode melhorar 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 próprio Azure. Você poderá depurar esses erros se habilitar a depuração remota ao publicar seu serviço e anexar o depurador a uma instância de função.

O emulador simula o serviço de Computação do Azure e é executado em seu ambiente local para que você possa testar e depurar seu serviço de nuvem antes de implantá-lo. O emulador manipula o ciclo de vida de suas 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 seu serviço no emulador. Você pode usar o emulador para exibir seu 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 Express 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, selecione Depurar>Iniciar Depuração para executar o projeto dos Serviços de Nuvem do Azure (suporte estendido). Como alternativa, você pode pressionar F5. Você verá 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, em seguida, selecione Mostrar interface do usuário do Emulador de Computação.

   O painel esquerdo da interface do usuário mostra os serviços que estão atualmente implantados no emulador de computação e as instâncias de função que cada serviço está executando. Você pode 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, ele se expandirá para preencher o painel direito.

3. Percorra o aplicativo selecionando os comandos no menu Depurar e definindo pontos de interrupção no código. Conforme 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 o aplicativo incluir uma função Web e você definir a propriedade de ação de inicialização para iniciar o navegador da Web, o Visual Studio iniciará seu aplicativo Web no navegador. Se você alterar o número de instâncias de uma função na configuração de serviço, deverá interromper o serviço de nuvem e reiniciar a depuração para que possa depurar essas novas instâncias da função.

   Nota

   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. Você deve parar as notificações explicitamente na área de notificação.

Depurar um serviço de nuvem no Azure

Se você habilitar a depuração remota para um serviço de nuvem usando o procedimento nesta seção, ele não exibirá desempenho degradado nem incorrerá em encargos 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 afetados negativamente.

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, é 4026; para Visual Studio 2019, é 4024.

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

   Nota

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

2. Se seu alvo é 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 .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.

   Essa é apenas uma diretriz. Você pode optar por executar seus ambientes de teste em um ambiente de produção. No entanto, ao habilitar a depuração remota no ambiente de produção, você poderá afetar negativamente os usuários. É 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 selecione 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 msvsmon.exe na pasta de instalação do Visual Studio em Common7\IDE\Remote Debugger\x64. Certifique-se de executar como Administrador.

12. Aceite as solicitações 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 obtenha 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

Nota

Sempre que possível, depure 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. As versões de lançamento são otimizadas e, portanto, não são consideradas "Meu código".

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

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

3. Insira o destino da 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 WaWorkerHost.exe; se estiver depurando uma função Web, anexe ao processo w3wp.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 depurar.

Depurando 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.

Nota

Isso 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 Serviços de Aplicativos do Microsoft Azure e selecione Localizar....

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

   

   Nota

   Você precisa estar conectado a uma conta da Microsoft com acesso à assinatura que contém o 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 que você 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 Diagnóstico do Azure para registrar informações detalhadas do código em execução nas funções, no Azure. Confira Coleta de dados de log usando o Diagnóstico do Azure.

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