O pacote de hospedagem do .NET Core

O pacote de Hospedagem do .NET Core é um instalador para o Runtime do .NET Core e o módulo ASP.NET Core. O pacote permite que ASP.NET Core aplicativos sejam executados com o IIS.

Instalar o pacote de hospedagem do .NET Core

Importante

Se o pacote de hospedagem for instalado antes do IIS, a instalação do pacote deverá ser reparada. Execute o instalador do pacote de hospedagem novamente depois de instalar o IIS.

Se o pacote de hospedagem for instalado após a instalação da versão de 64 bits (x64) do .NET Core, os SDKs poderão parecer estar ausentes (Nenhum SDK do .NET Core foi detectado). Para resolver o problema, consulte Solucionar problemas e depurar projetos do ASP.NET Core.

Alterações significativas e avisos de segurança são relatados no repositório Comunicados. Os comunicados podem ser limitados a uma versão específica selecionando um filtro de rótulo.

Download direto (versão atual)

Baixe o instalador usando o seguinte link:

Instalador de pacote de hospedagem do .NET Core atual (download direto)

Requisito de Pacote Redistribuível do Visual C++

Em versões mais antigas do Windows, por exemplo, Windows Server 2012 R2, instale o Visual Studio C++ 2015, 2017, 2019 Redistribuível. Caso contrário, uma mensagem de erro confusa no Log de Eventos do Windows informa que The data is the error.

Redistribuível atual x64 VS C++atual x86 VS C++ redistribuível

Versões anteriores do instalador

Para obter uma versão anterior do instalador:

  1. Navegue até a página Baixar o .NET Core.
  2. Selecione a versão desejada do .NET Core.
  3. Na coluna Executar aplicativos – runtime, localize a linha da versão de runtime do .NET Core desejada.
  4. Baixe o instalador usando o link Pacote de hospedagem.

Aviso

Alguns instaladores contêm versões de lançamento que atingiram o EOL (fim da vida útil) e não têm mais suporte da Microsoft. Para saber mais, confira a política de suporte.

Opções

  1. Os parâmetros a seguir estão disponíveis ao executar o instalador por meio de um shell de comando do administrador:

    • OPT_NO_ANCM=1: ignorar a instalação do Módulo do ASP.NET Core.
    • OPT_NO_RUNTIME=1: ignorar a instalação do runtime do .NET Core. Usado quando o servidor hospeda apenas implantações autossuficientes (SCD).
    • OPT_NO_SHAREDFX=1: ignorar a instalação da Estrutura Compartilhada do ASP.NET (runtime do ASP.NET). Usado quando o servidor hospeda apenas implantações autossuficientes (SCD).
    • OPT_NO_X86=1: ignorar a instalação dos runtimes x86. Use esse parâmetro quando você souber que não hospedará aplicativos de 32 bits. Se houver uma possibilidade de hospedar aplicativos de 32 bits e 64 bits no futuro, não use esse parâmetro e instale ambos os runtimes.
    • OPT_NO_SHARED_CONFIG_CHECK=1: desabilite a verificação para usar uma Configuração Compartilhada do IIS quando a configuração compartilhada (applicationHost.config) estiver no mesmo computador do que a instalação do IIS. Disponível somente para instaladores do ASP.NET Core 2.2 ou Hosting Bundler posterior. Para obter mais informações, consulte Configuração avançada.

Observação

Para obter informações sobre a Configuração Compartilhada do IIS, consulte Módulo do ASP.NET Core com a Configuração Compartilhada do IIS.

Observação

Ao executar o instalador do Pacote de Hospedagem com opções definidas, o valor de cada opção é salvo no registro. As instalações subsequentes da mesma banda de versão Major.Minor usam as mesmas opções, a menos que outro conjunto de opções seja explicitamente passado da linha de comando. Se a primeira instalação do pacote de hospedagem não tiver nenhuma opção passada, cada opção obterá um valor padrão de 0 gravação no registro. Um valor de 0 implica que a opção está desativada, o que significa que o usuário não está optando por não aceitar o componente fornecido.

Reiniciar o IIS

Depois que o Pacote de Hospedagem é instalado, uma reinicialização manual do IIS pode ser necessária. Por exemplo, as dotnet ferramentas da CLI (comando) podem não existir no PATH para executar processos de trabalho do IIS.

Para reiniciar manualmente o IIS, interrompa o WAS (Serviço de Ativação de Processo do Windows) e reinicie o W3SVC (World Wide Web Publishing Service) e todos os serviços dependentes. Execute os seguintes comandos em um shell de comando com privilégios elevados:

net stop was /y
net start w3svc

Versão do módulo e logs do instalador do pacote de hospedagem

Para determinar a versão do Módulo do ASP.NET Core instalado:

  1. No sistema de hospedagem, navegue até %PROGRAMFILES%\IIS\Asp.Net Core Module\V2.
  2. Localize o aspnetcorev2.dll arquivo.
  3. Clique com o botão direito do mouse no arquivo e selecione Propriedades no menu contextual.
  4. Selecione a guia Detalhes . A versão arquivo e a versão do produto representam a versão instalada do módulo.

Os logs do instalador do Pacote de Hospedagem para o módulo são encontrados em C:\Users\%UserName%\AppData\Local\Temp. O arquivo é nomeado dd_DotNetCoreWinSvrHosting__{TIMESTAMP}_000_AspNetCoreModule_x64.log, onde o espaço reservado {TIMESTAMP} é o carimbo de data/hora do arquivo.