Asp.net .Net Deployment Msbuild

Como Publicar com Sucesso uma `Aplicação Web ASP.NET` Usando MSBuild

Publicar uma aplicação web ASP.NET pode às vezes parecer intimidador, especialmente quando suas tentativas resultam em mensagens de erro confusas. Se você tem tentado publicar sua aplicação ASP.NET MVC localmente usando MSBuild e encontrou a temida mensagem: “Skipping unpublishable project,” não se preocupe! Este blog irá guiá-lo através do processo correto de publicação da sua aplicação e garantir que seu deployment seja suave e eficiente.

Entendendo o Erro

Quando você tenta executar o seguinte alvo NAnt:

<target name="publish-artifacts-to-build">
    <msbuild project="my-solution.sln" target="Publish">
      <property name="Configuration" value="debug" />
      <property name="OutDir" value="builds\" />
      <arg line="/m:2 /tv:3.5" />
    </msbuild>
</target>

a mensagem de erro “Skipping unpublishable project.” surge porque você está invocando um alvo que é destinado a um propósito diferente. O alvo Publish que você está tentando usar é especificamente projetado para OneClick deployment, e não para publicar um site diretamente.

A Abordagem Certa para Publicar Sua Aplicação ASP.NET

Para publicar com sucesso sua aplicação web ASP.NET, considere usar a tarefa AspNetCompiler em vez da tarefa MSBuild. Esta tarefa é mais adequada para compilar sua aplicação ASP.NET em um formato implantável.

Passos para Publicar Usando AspNetCompiler

Veja como configurar o AspNetCompiler:

Crie um novo alvo NAnt para Compilação ASP.NET:

Atualize seu alvo NAnt para usar o AspNetCompiler da seguinte forma:

<target name="publish-artifacts-to-build">
    <aspnetcompiler 
        configuration="debug" 
        targetedframework="4.0" 
        virtualpath="/" 
        physicalpath="caminho\para\sua\webapp" 
        outputpath="builds\" 
        debug="true">
    </aspnetcompiler>
</target>

configuration: Defina esta propriedade para debug ou release de acordo com suas necessidades.
physicalpath: Forneça o caminho para o diretório da sua aplicação web.
outputpath: Este é o local onde os arquivos compilados serão armazenados.

Ajuste seu Ambiente:

Certifique-se de que seu ambiente esteja configurado para suportar a publicação de aplicações web ASP.NET. Isso inclui garantir que suas versões de SDK estejam corretas e que todas as dependências necessárias estejam instaladas.
Execute o Comando de Deployment:

Com o alvo NAnt configurado corretamente, execute sua compilação. Isso irá compilar a aplicação ASP.NET e outputá-la para o diretório especificado.

Recursos Adicionais

Para mais informações detalhadas sobre a tarefa AspNetCompiler, consulte a documentação oficial em MSDN. Esta página fornece insights sobre as propriedades e como utilizá-las efetivamente para deployments mais complexos.

Conclusão

Publicar uma aplicação web ASP.NET pode ser alcançado sem enfrentar os erros comuns. Usando a tarefa correta—neste caso, AspNetCompiler—você garantirá que sua aplicação seja compilada adequadamente e esteja pronta para deployment. Se você seguir a abordagem estruturada delineada neste blog, você experienciará um processo de deployment tranquilo.