Problemas comuns que causam a reciclagem de funções do Serviço de Nuvem do Azure (clássico)

Importante

Os Serviços de Nuvem (clássicos) estão obsoletos para todos os clientes desde 1º de setembro de 2024. Todas as implantações em execução existentes serão interrompidas e encerradas pela Microsoft e os dados serão perdidos permanentemente a partir de outubro de 2024. As novas implantações devem usar o novo modelo de implantação baseado no Azure Resource Manager Serviços de Nuvem do Azure (suporte estendido) .

Este artigo discute algumas das causas comuns dos problemas de implantação e fornece dicas de solução de problemas para ajudá-lo a resolvê-los. Uma indicação de que existe um problema com um aplicativo é quando há uma falha na inicialização da instância de função ou se ela alterna entre os estados inicializando, ocupado e parando.

Caso o seu problema do Azure não seja abordado neste artigo, visite os fóruns do Azure no Microsoft Q&A e no Stack Overflow. Você pode postar seu problema nesses fóruns ou enviar para@AzureSupport no Twitter. Você também pode enviar uma solicitação de suporte do Azure. Para enviar uma solicitação de suporte na página Suporte do Azure, selecione Obter suporte.

Dependências de runtime ausentes

Se uma função em seu aplicativo depender de um assembly que não faça parte do .NET Framework ou da biblioteca gerenciada pelo Azure, você deverá incluir explicitamente esse assembly no pacote de aplicativos. Tenha em mente que outras estruturas da Microsoft não estão disponíveis no Azure por padrão. Se a sua função depender de uma estrutura desse tipo, você deverá adicionar esses assemblies ao pacote de aplicativos.

Antes de compilar e empacotar seu aplicativo, verifique se as seguintes afirmações são verdadeiras:

• Se estiver usando o Visual Studio, certifique-se de que a propriedade Copy Local esteja definida como True para cada assembly mencionado no seu projeto que não faça parte do SDK do Azure ou do .NET Framework.
• Verifique se o arquivo web.config não faz referência a nenhum assembly não usado no elemento de compilação.
• A Ação de Compilação de cada arquivo .cshtml é definida como Conteúdo. Essa configuração garante que os arquivos sejam exibidos corretamente no pacote e permite que outros arquivos referenciados apareçam nele.

Plataforma incorreta de destinos de assembly

O Azure é um ambiente de 64 bits. Portanto, os assemblies .NET compilados para um destino de 32 bits não são compatíveis com o Azure.

A função gera exceções sem tratamento durante a inicialização ou interrupção

Todas as exceções geradas pelos métodos da classe RoleEntryPoint, que inclui os métodos OnStart, OnStop e Run, são exceções sem tratamento. Se ocorrer uma exceção sem tratamento em um desses métodos, a função será reciclada. Se a função estiver sendo reciclada repetidamente, ela poderá gerar uma exceção sem tratamento a cada tentativa de inicialização.

A função é retornada do método Run

O método Run se destina a ser executado por tempo indeterminado. Se o seu código substituir o método Run , ele deverá ser suspenso por tempo indeterminado. Se o método Run for retornado, a função será reciclada.

Configuração incorreta de DiagnosticsConnectionString

Se o aplicativo usar o Diagnóstico do Azure, o arquivo de configuração de serviço deverá especificar a definição de configuração DiagnosticsConnectionString . Essa configuração deve especificar uma conexão HTTPS à sua conta de armazenamento no Azure.

Para garantir que a configuração DiagnosticsConnectionString esteja correta antes de implantar seu pacote de aplicativos no Azure, verifique se as seguintes afirmações são verdadeiras:

• A configuração DiagnosticsConnectionString aponta para uma conta de armazenamento válida no Azure.
  Por padrão, essa configuração aponta para a conta de armazenamento emulada, portanto você deve alterar explicitamente essa configuração antes de implantar o pacote de aplicativos. Se você não alterar essa configuração, uma exceção será gerada quando a instância de função tentar iniciar o monitor de diagnóstico. Esse evento poderá fazer com que a instância de função seja reciclada por tempo indeterminado.
• A cadeia de conexão é especificada no formatoa seguir. (O protocolo deve ser especificado como HTTPS). Substitua MyAccountName pelo nome da sua conta de armazenamento e MyAccountKey pela sua chave de acesso:

DefaultEndpointsProtocol=https;AccountName=MyAccountName;AccountKey=MyAccountKey

Se estiver desenvolvendo seu aplicativo com as Ferramentas do Azure para o Microsoft Visual Studio, você poderá usar as páginas de propriedade para definir esse valor.

O certificado exportado não inclui a chave privada

Para executar uma função Web por meio do protocolo TLS, você precisa garantir que o certificado de gerenciamento exportado inclua a chave privada. Se você usar o Gerenciador de Certificados do Windows para exportar o certificado, selecione Sim para a opção Exportar a chave privada. O certificado precisa ser exportado no formato pfx, que é o único formato atualmente com suporte.

Próximas etapas

Confira mais artigos sobre solução de problemas para serviços de nuvem.

Veja mais cenários de reciclagem da função na Série de blogs de Kevin Williamson.