Partilhar via


ASP.NET Estrutura de diretórios principal

Note

Esta não é a versão mais recente deste artigo. Para a versão atual, consulte a versão .NET 10 deste artigo.

Warning

Esta versão do ASP.NET Core não é mais suportada. Para obter mais informações, consulte a Política de suporte do .NET e do .NET Core. Para a versão atual, consulte a versão .NET 9 deste artigo.

O diretório publish contém os ativos implantáveis do aplicativo produzidos pelo comando dotnet publishing . O diretório contém:

  • Ficheiros de aplicação
  • Arquivos de configuração
  • Ativos estáticos
  • Packages
  • Um ambiente de execução (apenas implantação independente)
Tipo de aplicativo Estrutura do diretório
Executável dependente de estrutura (FDE)
  • Publicar†
    • Visualizações† em aplicações MVC, caso as visualizações não estejam pré-compiladas.
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA MONTAGEM}{. EXTENSION}.exe extensão no Windows, nenhuma extensão no macOS ou Linux
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)
    • createdump (utilitário createdump do Linux)
    • *.so (biblioteca de objetos compartilhados do Linux)
    • *.a (arquivo macOS)
    • *.dylib (biblioteca dinâmica do macOS)
Implantação autónoma (SCD)
  • Publicar†
    • Visualizações† aplicativos MVC, se as exibições não forem pré-compiladas
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA MONTAGEM}{. EXTENSION} .exe extensão no Windows, nenhuma extensão no macOS ou Linux
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)

†Indica um diretório

O diretório publish representa o caminho raiz do conteúdo, também chamado de caminho base do aplicativo, da implantação. Seja qual for o nome dado ao diretório de publicação do aplicativo implantado no servidor, seu local serve como o caminho físico do servidor para o aplicativo hospedado.

O diretório wwwroot , se presente, contém apenas ativos estáticos.

Recursos adicionais

O diretório publish contém os ativos implantáveis do aplicativo produzidos pelo comando dotnet publishing . O diretório contém:

  • Ficheiros de aplicação
  • Arquivos de configuração
  • Ativos estáticos
  • Packages
  • Um ambiente de execução (apenas implantação independente)
Tipo de aplicativo Estrutura do diretório
Executável dependente de estrutura (FDE)
  • Publicar†
    • Visualizações† em aplicações MVC, caso as visualizações não estejam pré-compiladas.
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA MONTAGEM}{. EXTENSION}.exe extensão no Windows, nenhuma extensão no macOS ou Linux
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.Views.dll
    • {NOME DA ASSEMBLEIA}. Views.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)
    • createdump (utilitário createdump do Linux)
    • *.so (biblioteca de objetos compartilhados do Linux)
    • *.a (arquivo macOS)
    • *.dylib (biblioteca dinâmica do macOS)
Implantação autónoma (SCD)
  • Publicar†
    • Visualizações† aplicativos MVC, se as exibições não forem pré-compiladas
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA MONTAGEM}{. EXTENSION} .exe extensão no Windows, nenhuma extensão no macOS ou Linux
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.Views.dll
    • {NOME DA ASSEMBLEIA}. Views.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)

†Indica um diretório

O diretório publish representa o caminho raiz do conteúdo, também chamado de caminho base do aplicativo, da implantação. Seja qual for o nome dado ao diretório de publicação do aplicativo implantado no servidor, seu local serve como o caminho físico do servidor para o aplicativo hospedado.

O diretório wwwroot , se presente, contém apenas ativos estáticos.

Recursos adicionais

O diretório publish contém os ativos implantáveis do aplicativo produzidos pelo comando dotnet publishing . O diretório contém:

  • Ficheiros de aplicação
  • Arquivos de configuração
  • Ativos estáticos
  • Packages
  • Um ambiente de execução (apenas implantação independente)
Tipo de aplicativo Estrutura do diretório
Executável dependente de estrutura (FDE)
  • Publicar†
    • Visualizações† em aplicações MVC, caso as visualizações não estejam pré-compiladas.
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA MONTAGEM}{. EXTENSION} .exe extensão no Windows, nenhuma extensão no macOS ou Linux
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.Views.dll
    • {NOME DA ASSEMBLEIA}. Views.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)
    • createdump (utilitário createdump do Linux)
    • *.so (biblioteca de objetos compartilhados do Linux)
    • *.a (arquivo macOS)
    • *.dylib (biblioteca dinâmica do macOS)
Implantação autónoma (SCD)
  • Publicar†
    • Visualizações† aplicativos MVC, se as exibições não forem pré-compiladas
    • Aplicações Pages† MVC ou Razor Pages, se as páginas não forem pré-compiladas
    • wwwroot†
    • *.dll ficheiros
    • {NOME DA ASSEMBLEIA}.deps.json
    • {NOME DA ASSEMBLEIA}.dll
    • {NOME DA ASSEMBLEIA}.exe
    • {NOME DA ASSEMBLEIA}.pdb
    • {NOME DA ASSEMBLEIA}.Views.dll
    • {NOME DA ASSEMBLEIA}. Views.pdb
    • {NOME DA ASSEMBLEIA}.runtimeconfig.json
    • web.config (implantações do IIS)

†Indica um diretório

O diretório publish representa o caminho raiz do conteúdo, também chamado de caminho base do aplicativo, da implantação. Seja qual for o nome dado ao diretório de publicação do aplicativo implantado no servidor, seu local serve como o caminho físico do servidor para o aplicativo hospedado.

O diretório wwwroot , se presente, contém apenas ativos estáticos.

A criação de uma pasta Logs é útil para o registo de depuração aprimorado do módulo ASP.NET Core. As pastas no caminho fornecido para o <handlerSetting> valor não são criadas pelo módulo automaticamente e devem pré-existir na implantação para permitir que o módulo escreva o log de depuração.

Um diretório Logs pode ser criado para a implantação usando uma das duas abordagens a seguir:

  • Adicione o seguinte <Target> elemento ao arquivo de projeto:

    <Target Name="CreateLogsFolder" AfterTargets="Publish">
       <MakeDir Directories="$(PublishDir)Logs" 
                Condition="!Exists('$(PublishDir)Logs')" />
       <WriteLinesToFile File="$(PublishDir)Logs\.log" 
                         Lines="Generated file" 
                         Overwrite="True" 
                         Condition="!Exists('$(PublishDir)Logs\.log')" />
    </Target>
    

    O <MakeDir> elemento cria uma pasta Logs vazia na saída publicada. O elemento usa a PublishDir propriedade para determinar o local de destino para criar a pasta. Vários métodos de implantação, como Web Deploy, ignoram pastas vazias durante a implantação. O <WriteLinesToFile> elemento gera um arquivo na pasta Logs , que garante a implantação da pasta no servidor. A criação de pastas usando essa abordagem falhará se o processo de trabalho não tiver acesso de gravação à pasta de destino.

  • Crie fisicamente o diretório Logs no servidor na implantação.

O diretório de implantação requer permissões de Leitura/Execução. O diretório Logs requer permissões de leitura/gravação. Diretórios adicionais onde os arquivos são gravados exigem permissões de leitura/gravação.

Recursos adicionais