Partilhar via


Usar o Emulator Express para executar e depurar serviços de nuvem Azure com suporte estendido numa máquina local.

Observação

Este artigo aplica-se aos Serviços de Nuvem do Azure Azure (suporte estendido). Em 31 de março de 2027, o modelo de implantação de Serviços em Nuvem (Suporte Estendido) será desativado. Como resultado, as ferramentas de serviços de nuvem de suporte não estarão disponíveis no Visual Studio mais recente após essa data. As ferramentas dos Serviços de Nuvem (Suporte Estendido) continuarão a funcionar no Visual Studio 2022, com manutenção geral ocorrendo até 31 de março de 2027. Recomendamos iniciar seu planejamento de migração agora para garantir uma transição suave. Consulte o anúncio oficial para obter mais informações, incluindo orientações detalhadas sobre como migrar seus aplicativos para serviços modernos do Azure.

Os Serviços de Nuvem do Azure dependem de cadeias de conexão para autenticação em alguns casos, como para contas de armazenamento. Cadeias de conexão e senhas são inerentemente inseguras devido ao risco de exposição não intencional ou comprometimento. A Microsoft recomenda o uso de identidades gerenciadas para autenticação e serviços como clusters gerenciados do Service Fabric.

Usando o Emulator Express, você pode testar e depurar um serviço de nuvem sem executar o Visual Studio como administrador. Você pode definir as configurações do projeto para usar o Emulator Express ou o emulador completo, dependendo dos requisitos do seu serviço de nuvem. Para obter mais informações sobre o emulador completo, consulte executar um aplicativo do Azure no emulador de computação.

Usando o Emulator Express no Visual Studio

Quando você cria um projeto do Azure, o Emulator Express é usado automaticamente. Para projetos existentes que foram criados com uma versão anterior do SDK do Azure, use as seguintes etapas para selecionar Emulator Express:

  1. Crie ou abra um projeto dos Serviços de Nuvem do Azure (suporte estendido) no Visual Studio.

  2. No Gerenciador de Soluções, clique com o botão direito do mouse no projeto e, no menu de contexto, selecione Propriedades.

  3. Nas páginas de propriedades dos projetos, selecione a guia Web.

    Propriedades de um projeto dos Serviços de Nuvem do Azure (suporte estendido)

  4. Na secção Servidor de Desenvolvimento Local, selecione a opção Usar Serviços de Informações da Internet (IIS) Express.

  5. Em Emulador, selecione Usar o Emulador Express.

  6. Para iniciar o Emulator Express, execute o seguinte comando em um prompt de comando:

    csrun.exe /useemulatorexpress

Limitações do Emulator Express

Os seguintes problemas são limitações conhecidas do Emulator Express:

  • O Emulator Express não é compatível com o IIS Web Server.
  • Seu serviço de nuvem pode conter várias funções, mas cada função é limitada a uma instância.
  • Não é possível aceder a números de porta inferiores a 1000. Se você usar um provedor de autenticação que normalmente usa uma porta abaixo de 1000, talvez seja necessário alterar esse valor para um número de porta acima de 1000.
  • Quaisquer limitações que se apliquem ao Emulador de Computação do Azure também se aplicam ao Emulator Express. Por exemplo, você não pode ter mais de 50 instâncias de função por implantação. Para obter mais informações sobre o Emulador de Computação do Azure, consulte Executar um Aplicativo do Azure no Emulador de Computação.

Depuração dos Serviços de Nuvem do Azure (suporte estendido)