Obter configurações de publicação do IIS e importar para o Visual Studio

Você pode usar a ferramenta Publicar para importar configurações de publicação e, em seguida, implantar seu aplicativo. Neste artigo, usamos configurações de publicação para o IIS.

Estas etapas se aplicam aos aplicativos Web ASP.NET e ASP.NET Core.

Pré-requisitos

• Visual Studio instalado com a carga de trabalho de desenvolvimento ASP.NET e Web. Se você já instalou o Visual Studio:

  • Instale as atualizações mais recentes no Visual Studio selecionando Ajuda>Verificar se há atualizações.
  • Adicione a carga de trabalho selecionando Ferramentas>Obter Ferramentas e Recursos.

• No servidor, você deve estar executando o Windows Server 2012 ou superior e deve ter a função Servidor Web do IIS instalada corretamente (necessária para gerar o arquivo de configurações de publicação (.publishsettings). ASP.NET 4.5 ou a versão correta do ASP.NET Core também deve ser instalado no servidor. As etapas deste tutorial foram testadas no Windows Server 2022 e no IIS 10.

  • Para configurar o ASP.NET Core, consulte Host ASP.NET Core no Windows com o IIS. Para ASP.NET Core, certifique-se de configurar o Pool de Aplicativos para usar No Managed Code, conforme descrito no artigo.

  • Para configurar o ASP.NET 4.5, consulte IIS 8.0 usando ASP.NET 3.5 e ASP.NET 4.5.

  Observação

  O IIS no Windows não oferece suporte à geração das configurações de publicação. No entanto, você ainda pode publicar no IIS usando a ferramenta Publicar no Visual Studio.

Instalar e configurar o Web Deploy no servidor Windows

Web Deploy fornece recursos de configuração adicionais que permitem a criação do ficheiro de definições de publicação pela interface do usuário.

1. Se você ainda não instalou Ferramentas e Scripts de Gerenciamento do IIS, instale-o agora.

   Vá para Selecionar funções de servidor>Servidor Web (IIS)>Ferramentas de Gerenciamento de, e em seguida, selecione a função Scripts e Ferramentas de Gerenciamento do IIS, clique em Avançar, e em seguida instale essa função.

   

   Os scripts e ferramentas são necessários para permitir a geração do arquivo de configurações de publicação.

   Certifique-se também de instalar o Serviço de Gerenciamento e o Console de Gerenciamento do IIS (eles podem já estar instalados).

2. No Windows Server, baixar o Web Deploy 4.0.

3. Execute o programa de instalação do Web Deploy e certifique-se de selecionar instalação completa em vez de uma instalação típica.

   Com uma instalação completa, você obtém os componentes necessários para gerar um arquivo de configurações de publicação. (Se escolher Personalizado, poderá ver a lista de componentes, conforme mostrado na ilustração a seguir.)

   

4. (Opcional) Verifique se a Implantação da Web está sendo executada corretamente abrindo Painel de Controle > Sistema e Segurança > Ferramentas do Windows > Serviços, e verifique se:

   • O Serviço do Agente de Implantação da Web está em execução (o nome do serviço é diferente em versões mais antigas).

   • do Serviço de Gerenciamento da Web está em execução.

   Se um dos serviços do agente não estiver em execução, reinicie o Web Deployment Agent Service.

   Se o Serviço do Web Deployment Agent não estiver presente, vá para Painel de Controlo > Programas > Desinstalar um Programa, localize Microsoft Web Deploy <versão>. Escolha Alterar a instalação e certifique-se de escolher que será instalado no disco rígido local para os componentes de Implantação da Web. Conclua as etapas de instalação da mudança.

Criar o arquivo de configurações de publicação no IIS no Windows Server

1. Feche e reabra o Console de Gerenciamento do IIS para mostrar opções de configuração atualizadas na interface do usuário.

2. No IIS, clique com o botão direito do rato no Site Padrão, escolha Implantar>Configurar Publicação de Implantação Web.

   de configuração do Web Deploy

   Se não vires o menu Deploy, consulta a seção anterior para verificar se o Web Deploy está em execução.

3. Na caixa de diálogo Configurar de Publicação de Implantação da Web, examine as configurações.

4. Clique em Configuração.

   No painel Resultados , a saída mostra que os direitos de acesso são concedidos ao usuário especificado e que um arquivo com uma .publishsettings extensão de arquivo foi gerado no local mostrado na caixa de diálogo.

   <?xml version="1.0" encoding="utf-8"?>
   <publishData>
     <publishProfile
       publishUrl="https://myhostname:8172/msdeploy.axd"
       msdeploySite="Default Web Site"
       destinationAppUrl="http://myhostname:80/"
       profileName="Default Settings"
       publishMethod="MSDeploy"
       userName="myhostname\myusername" />
   </publishData>
   

   Dependendo da configuração do Windows Server e do IIS, você verá valores diferentes no arquivo XML. Aqui estão alguns detalhes sobre os valores que você vê:

   • O arquivo de msdeploy.axd referenciado no atributo publishUrl é um arquivo manipulador HTTP gerado dinamicamente para Implantação da Web. (Para fins de teste, http://myhostname:8172 geralmente funciona também.)

   • A porta publishUrl é definida como porta 8172, que é o padrão para Web Deploy.

   • A porta destinationAppUrl é definida como porta 80, que é o padrão para o IIS.

   • Se, em etapas posteriores, você não conseguir se conectar ao host remoto do Visual Studio usando o nome do host, teste o endereço IP do servidor no lugar do nome do host.

     Observação

     Se estiver a publicar no IIS em execução numa VM do Azure, deverá abrir uma porta de entrada para Web Deploy e IIS no grupo de Segurança de Rede. Para obter informações detalhadas, consulte Abrir portas para uma máquina virtual.

5. Copie este arquivo para o computador onde você está executando o Visual Studio.

Importar as configurações de publicação no Visual Studio e implantar

1. No computador onde você tem o projeto ASP.NET aberto no Visual Studio, clique com o botão direito do mouse no projeto no Gerenciador de Soluções e escolha Publicar.

   Se você configurou anteriormente quaisquer perfis de publicação, o painel Publicar será exibido. Clique Novo ou Criar Novo Perfil.

2. Selecione a opção para importar um perfil.

   Na caixa de diálogo Publicar, clique em Importar Perfil.

   

3. Navegue até o local do arquivo de configurações de publicação que você criou na seção anterior.

4. Na caixa de diálogo Importar Arquivo de Configurações de Publicação, navegue até o perfil criado na seção anterior e selecione o perfil criado na seção anterior e clique em Abrir.

   Clique Concluir para salvar o perfil de publicação e, em seguida, clique Publicar.

   O Visual Studio inicia o processo de implantação e a janela Saída mostra o progresso e os resultados.

   Se você receber algum erro de implantação, clique em Mais ações>Editar para editar as configurações. Modifique as configurações e clique em Validar para testar novas configurações. Se o nome do host não for encontrado, tente o endereço IP em vez do nome do host nos campos URL do servidor e do destino .

   

Depois que o aplicativo for implantado com êxito, ele deve ser iniciado automaticamente.

Problemas comuns

Primeiro, verifique a janela Saída no Visual Studio para obter informações de status e verifique suas mensagens de erro. Além disso:

• Se você não conseguir se conectar ao host usando o nome do host, tente o endereço IP.
• Verifique se as portas necessárias estão abertas no servidor remoto.
• Para ASP.NET Core, no IIS, você precisa certificar-se de que o campo Pool de aplicativos (.NET CLR Version on IIS 10) para o DefaultAppPool está definido como No Managed Code.
• Verifique se a versão do ASP.NET usado em seu aplicativo é a mesma que você instalou no servidor. Para a sua aplicação, pode ver e definir a versão na página de Propriedades . Para definir o aplicativo para uma versão diferente, essa versão deve ser instalada.
• Se o aplicativo tentou abrir, mas você vê um aviso de certificado, escolha confiar no site. Se você já fechou o aviso, você pode editar o arquivo *.pubxml em seu projeto e adicionar o seguinte elemento: <AllowUntrustedCertificate>true</AllowUntrustedCertificate>. Esta configuração é apenas para teste!
• Se o aplicativo não iniciar a partir do Visual Studio, inicie o aplicativo no IIS para testar se ele foi implantado corretamente.

Conteúdo relacionado

Alojar o ASP.NET Core no Windows com o IIS