Como baixar o pacote de hospedagem para .NET Core 6
Se você deseja hospedar aplicativos ASP.NET Core no IIS, precisa instalar o pacote de hospedagem .NET Core. Este é um instalador que contém o .NET Core Runtime e o ASP.NET Core Module. O tempo de execução permite que você execute aplicativos web/servidor existentes, enquanto o módulo permite que o IIS encaminhe solicitações para seu aplicativo.
Neste artigo, você aprenderá como baixar e instalar o pacote de hospedagem para .NET Core 6, que é a versão mais recente do .NET Core em março de 2023. Você também aprenderá como usar algumas opções e parâmetros para personalizar sua instalação, como verificar se tudo está funcionando corretamente e como solucionar alguns problemas comuns.
download hosting bundle .net core 6
Download: https://urlcod.com/2vSX5N
Pré-requisitos
Antes de baixar e instalar o pacote de hospedagem, certifique-se de ter os seguintes pré-requisitos:
Um sistema operacional Windows compatível com .NET Core 6. Você pode verificar as versões de sistema operacional compatíveis .
IIS instalado e configurado em seu servidor. Você pode seguir isso para instalar o IIS.
O Visual Studio C++ 2015, 2017, 2019 Redistributable instalado em seu servidor. Isso é necessário para versões mais antigas do Windows, como o Windows Server 2012 R2. Você pode baixá-lo de (x86).
Baixando o Pacote de Hospedagem
Para baixar o pacote de hospedagem para .NET Core 6, use este link direto:
Alternativamente, você pode ir para o página e selecione a versão desejada do .NET Core. Em seguida, na coluna Executar aplicativos - Tempo de execução, localize a linha da versão do tempo de execução do .NET Core que você deseja e clique no link Pacote de hospedagem.
Depois de baixar o instalador, execute-o como administrador e siga as instruções na tela. O instalador instalará o .NET Core Runtime e o ASP.NET Core Module em seu servidor.
Opções e Parâmetros
O instalador do pacote de hospedagem tem alguns parâmetros opcionais que você pode usar para personalizar sua instalação. Você pode especificar esses parâmetros ao executar o instalador a partir de um shell de comando do administrador. Por exemplo:
dotnet-hosting-6.0.15-win.exe OPT_NO_ANCM=1
A tabela a seguir lista alguns desses parâmetros e seus significados:
Parâmetro
Descrição
OPT_NO_ANCM=1
Ignore a instalação do módulo ASP.NET Core.
OPT_NO_RUNTIME=1
Ignore a instalação do .NET Core Runtime.
OPT_NO_SHARED_CONFIG_CHECK=1
Ignore a verificação de configuração compartilhada no IIS. Isso pode impedir que o instalador falhe se você tiver uma configuração compartilhada.
OPT_NO_X86=1
Ignore a instalação da versão x86 do .NET Core Runtime e do módulo ASP.NET Core.
OPT_NO_X64=1
Ignore a instalação da versão x64 do .NET Core Runtime e do módulo ASP.NET Core.
OPT_INSTALL_LTS_REDIST=1
Instale a versão LTS mais recente do Visual C++ Redistributable, em vez da versão incluída no instalador.
OPT_INSTALL_FTS_REDIST=1
Instale a versão FTS mais recente do Visual C++ Redistributable, em vez da versão incluída no instalador.
INSTALL_ASPNETCORE_SHARED_RUNTIME_60=0
Ignore a instalação de uma versão específica do .NET Core Runtime. Substitua 60 pelo número da versão desejada.
Você também pode usar o /? ou parâmetro /help para ver uma lista de todos os parâmetros disponíveis e suas descrições.
Verificando a instalação
Depois de instalar o pacote de hospedagem, você pode verificar se está funcionando corretamente verificando o seguinte:
A versão do módulo. Você pode ver a versão instalada do Módulo ASP.NET Core abrindo o Gerenciador do IIS e examinando a seção Módulos. Você deve ver um módulo chamado AspNetCoreModuleV2 com um número de versão que corresponde à versão do pacote de hospedagem.
O instalador registra. Você pode encontrar os logs do instalador do pacote de hospedagem na pasta %temp%. O nome do arquivo deve começar com Microsoft_.NET_Core_Hosting_Bundle_ e terminar com .log.Você pode abrir o arquivo de log e procurar erros ou avisos que possam indicar um problema com a instalação.
A funcionalidade do aplicativo. Você pode testar se seu aplicativo ASP.NET Core está sendo executado corretamente navegando até sua URL e verificando se ele responde conforme o esperado. Você também pode verificar os logs do aplicativo e o visualizador de eventos em busca de erros ou exceções que possam ocorrer durante ou após a solicitação.
Solução de problemas comuns
Às vezes, você pode encontrar alguns problemas ao instalar ou usar o pacote de hospedagem. Aqui estão alguns problemas comuns e suas possíveis soluções:
O instalador do pacote de hospedagem falha com uma mensagem de erro que diz "A seção de configuração 'system.webServer/aspNetCore' não pode ser lida porque está faltando uma declaração de seção". Isso geralmente acontece quando você tem uma configuração compartilhada no IIS e o instalador não pode acessá-la ou modificá-la. Para corrigir isso, você pode desabilitar a configuração compartilhada temporariamente ou usar o parâmetro OPT_NO_SHARED_CONFIG_CHECK=1 ao executar o instalador.
O instalador do pacote de hospedagem falha com uma mensagem de erro que diz "Uma verificação de pré-requisito para o SDK do .NET Core falhou". Isso geralmente acontece quando você tem uma versão mais antiga do Visual Studio ou Visual Studio Build Tools instalada em seu servidor, que não suporta .NET Core 6. Para corrigir isso, você pode atualizar seu Visual Studio ou Visual Studio Build Tools para a versão mais recente ou usar o parâmetro OPT_NO_RUNTIME=1 ao executar o instalador.
O instalador do pacote de hospedagem falha com uma mensagem de erro que diz "Uma versão mais recente do Microsoft Visual C++ 2015-2019 Redistributable foi detectada nesta máquina". Isso geralmente acontece quando você tem uma versão mais recente do Visual C++ Redistributable instalada em seu servidor, que entra em conflito com a versão incluída no instalador.Para corrigir isso, você pode desinstalar o Visual C++ Redistributable existente ou usar um destes parâmetros ao executar o instalador: OPT_INSTALL_LTS_REDIST=1 ou OPT_INSTALL_FTS_REDIST=1.
Seu aplicativo ASP.NET Core falha ao iniciar ou responde com uma mensagem de erro que diz "Erro HTTP 500.19 - Erro interno do servidor". Isso geralmente acontece quando você tem uma configuração incorreta em seu arquivo web.config ou em seu arquivo appsettings.json, o que impede que o IIS carregue seu aplicativo. Para corrigir isso, você pode verificar seus arquivos de configuração em busca de erros de sintaxe, seções ausentes ou valores inválidos. Você também pode verificar a mensagem de erro detalhada e o rastreamento de pilha para obter mais pistas sobre o que deu errado.
Seu aplicativo ASP.NET Core falha ao iniciar ou responde com uma mensagem de erro que diz "Erro HTTP 502.5 - Falha no processo". Isso geralmente acontece quando seu aplicativo falha ao iniciar ou trava durante a solicitação. Isso pode ser causado por vários motivos, como dependências ausentes, versões incompatíveis, arquivos corrompidos ou exceções não tratadas. Para corrigir isso, você pode verificar os logs do aplicativo e o visualizador de eventos em busca de erros ou avisos que possam indicar a causa da falha. Você também pode tentar executar seu aplicativo na linha de comando usando o comando dotnet para ver se funciona ou fornecer mais detalhes sobre o problema.
Conclusão
Neste artigo, você aprendeu como baixar e instalar o pacote de hospedagem para .NET Core 6, que é uma ferramenta essencial para hospedar aplicativos ASP.NET Core no IIS. Você também aprendeu como usar algumas opções e parâmetros para personalizar sua instalação, como verificar se tudo está funcionando corretamente e como solucionar alguns problemas comuns.
Se quiser saber mais sobre o pacote de hospedagem, confira estes recursos:
: a documentação oficial que cobre tudo o que você precisa saber sobre hospedagem de aplicativos ASP.NET Core no IIS.
: uma visão geral detalhada do módulo ASP.NET Core, seus recursos e suas opções de configuração.
: um guia abrangente que ajuda a diagnosticar e resolver vários problemas que podem ocorrer ao hospedar aplicativos ASP.NET Core no IIS.
perguntas frequentes
Aqui estão algumas perguntas frequentes sobre o pacote de hospedagem:
Qual é a diferença entre o .NET Core Runtime e o .NET Core SDK?
O .NET Core Runtime é o conjunto mínimo de bibliotecas e componentes de que você precisa para executar aplicativos Web/servidores existentes criados com o .NET Core. O .NET Core SDK é um conjunto maior de bibliotecas e ferramentas que você precisa para desenvolver novos aplicativos Web/servidor com .NET Core. O pacote de hospedagem inclui apenas o tempo de execução, não o SDK.
Como faço para atualizar ou desinstalar o pacote de hospedagem?
Para atualizar o pacote de hospedagem, você pode baixar e executar a versão mais recente do instalador. Ele substituirá automaticamente a versão existente do tempo de execução e do módulo. Para desinstalar o pacote de hospedagem, você pode usar o recurso Adicionar ou remover programas no Windows. Você também pode usar o parâmetro /uninstall ao executar o instalador a partir de um shell de comando do administrador.
Como hospedo aplicativos ASP.NET Core em outras plataformas?
O pacote de hospedagem é apenas para servidores Windows com IIS. Se você quiser hospedar aplicativos ASP.NET Core em outras plataformas, como Linux ou macOS, precisará usar um servidor Web diferente, como Apache, Nginx ou Kestrel. Você pode encontrar mais informações sobre como hospedar aplicativos ASP.NET Core em outras plataformas .
Como hospedo várias versões de aplicativos ASP.NET Core no mesmo servidor?
O pacote de hospedagem dá suporte à hospedagem de várias versões de aplicativos ASP.NET Core no mesmo servidor. Você pode especificar qual versão do tempo de execução seu aplicativo requer usando um elemento em seu arquivo web.config. Por exemplo:
<runtime> <aspNetCore version="6.0.15" /> </runtime>
Isso instruirá o IIS a usar a versão 6.0.15 do runtime para seu aplicativo. Se você não especificar uma versão, o IIS usará a última versão instalada por padrão.
Como habilito HTTPS para meu aplicativo ASP.NET Core?
Para habilitar HTTPS para seu aplicativo ASP.NET Core, você precisa configurar certificados SSL para seu domínio e seu servidor web. Você pode usar um certificado autoassinado para fins de teste ou um certificado confiável de uma autoridade de certificação para fins de produção. Você pode encontrar mais informações sobre como habilitar HTTPS para seu aplicativo ASP.NET Core . 0517a86e26
コメント