Udostępnij za pośrednictwem

Struktura katalogów platformy ASP.NET Core

  • Artykuł

Uwaga

Nie jest to najnowsza wersja tego artykułu. Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Ostrzeżenie

Ta wersja ASP.NET Core nie jest już obsługiwana. Aby uzyskać więcej informacji, zobacz zasady pomocy technicznej platformy .NET i platformy .NET Core. Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Ważne

Te informacje odnoszą się do produktu w wersji wstępnej, który może zostać znacząco zmodyfikowany, zanim zostanie wydany komercyjnie. Firma Microsoft nie udziela żadnych gwarancji, jawnych lub domniemanych, w odniesieniu do informacji podanych w tym miejscu.

Aby zapoznać się z bieżącą wersją, zobacz wersję tego artykułu platformy .NET 9.

Katalog publikowania zawiera możliwe do wdrożenia zasoby aplikacji utworzone przez polecenie dotnet publish. Katalog zawiera:

  • Pliki aplikacji
  • Pliki konfiguracji
  • Zasoby statyczne
  • Pakiety
  • Środowisko uruchomieniowe (tylko wdrożenie samodzielne)
Typ aplikacji Struktura katalogu
Plik wykonywalny zależny od struktury (FDE)
  • publikowanie†
    • Widoki† aplikacje MVC; jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}{. EXTENSION}.exe rozszerzenie w systemie Windows, brak rozszerzenia w systemie macOS lub Linux
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)
    • createdump (narzędzie createdump systemu Linux)
    • *.so (biblioteka obiektów udostępnionych systemu Linux)
    • *.a (archiwum systemu macOS)
    • *.dylib (biblioteka dynamiczna systemu macOS)
Wdrażanie samodzielne (SCD)
  • publikowanie†
    • Widoki† aplikacje MVC, jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}{. EXTENSION} .exe rozszerzenia w systemie Windows, bez rozszerzenia w systemie macOS lub Linux
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)

†Indicates katalogu

Katalog publikowania reprezentuje ścieżkę główną zawartości, nazywaną również ścieżką podstawową aplikacji wdrożenia. Niezależnie od nazwy katalogu publikowania wdrożonej aplikacji na serwerze, jego lokalizacja służy jako ścieżka fizyczna serwera do hostowanej aplikacji.

Katalog wwwroot , jeśli istnieje, zawiera tylko zasoby statyczne.

Dodatkowe zasoby

Katalog publikowania zawiera możliwe do wdrożenia zasoby aplikacji utworzone przez polecenie dotnet publish. Katalog zawiera:

  • Pliki aplikacji
  • Pliki konfiguracji
  • Zasoby statyczne
  • Pakiety
  • Środowisko uruchomieniowe (tylko wdrożenie samodzielne)
Typ aplikacji Struktura katalogu
Plik wykonywalny zależny od struktury (FDE)
  • publikowanie†
    • Widoki† aplikacje MVC; jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}{. EXTENSION}.exe rozszerzenie w systemie Windows, brak rozszerzenia w systemie macOS lub Linux
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}. Views.dll
    • {NAZWA ZESTAWU}. Views.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)
    • createdump (narzędzie createdump systemu Linux)
    • *.so (biblioteka obiektów udostępnionych systemu Linux)
    • *.a (archiwum systemu macOS)
    • *.dylib (biblioteka dynamiczna systemu macOS)
Wdrażanie samodzielne (SCD)
  • publikowanie†
    • Widoki† aplikacje MVC, jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}{. EXTENSION} .exe rozszerzenia w systemie Windows, bez rozszerzenia w systemie macOS lub Linux
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}. Views.dll
    • {NAZWA ZESTAWU}. Views.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)

†Indicates katalogu

Katalog publikowania reprezentuje ścieżkę główną zawartości, nazywaną również ścieżką podstawową aplikacji wdrożenia. Niezależnie od nazwy katalogu publikowania wdrożonej aplikacji na serwerze, jego lokalizacja służy jako ścieżka fizyczna serwera do hostowanej aplikacji.

Katalog wwwroot , jeśli istnieje, zawiera tylko zasoby statyczne.

Dodatkowe zasoby

Katalog publikowania zawiera możliwe do wdrożenia zasoby aplikacji utworzone przez polecenie dotnet publish. Katalog zawiera:

  • Pliki aplikacji
  • Pliki konfiguracji
  • Zasoby statyczne
  • Pakiety
  • Środowisko uruchomieniowe (tylko wdrożenie samodzielne)
Typ aplikacji Struktura katalogu
Plik wykonywalny zależny od struktury (FDE)
  • publikowanie†
    • Widoki† aplikacje MVC; jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}{. EXTENSION} .exe rozszerzenia w systemie Windows, bez rozszerzenia w systemie macOS lub Linux
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}. Views.dll
    • {NAZWA ZESTAWU}. Views.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)
    • createdump (narzędzie createdump systemu Linux)
    • *.so (biblioteka obiektów udostępnionych systemu Linux)
    • *.a (archiwum systemu macOS)
    • *.dylib (biblioteka dynamiczna systemu macOS)
Wdrażanie samodzielne (SCD)
  • publikowanie†
    • Widoki† aplikacje MVC, jeśli widoki nie są wstępnie skompilowane
    • Strony† aplikacje MVC lub Razor Pages, jeśli strony nie są wstępnie skompilowane
    • wwwroot†
    • *pliki .dll
    • {NAZWA ZESTAWU}.deps.json
    • {NAZWA ZESTAWU}.dll
    • {NAZWA ZESTAWU}.exe
    • {NAZWA ZESTAWU}.pdb
    • {NAZWA ZESTAWU}. Views.dll
    • {NAZWA ZESTAWU}. Views.pdb
    • {NAZWA ZESTAWU}.runtimeconfig.json
    • web.config (wdrożenia usług IIS)

†Indicates katalogu

Katalog publikowania reprezentuje ścieżkę główną zawartości, nazywaną również ścieżką podstawową aplikacji wdrożenia. Niezależnie od nazwy katalogu publikowania wdrożonej aplikacji na serwerze, jego lokalizacja służy jako ścieżka fizyczna serwera do hostowanej aplikacji.

Katalog wwwroot , jeśli istnieje, zawiera tylko zasoby statyczne.

Tworzenie folderu Logs jest przydatne w przypadku rejestrowania ulepszonego debugowania modułu ASP.NET Core Module. Foldery w ścieżce podanej <handlerSetting> do wartości nie są tworzone automatycznie przez moduł i powinny istnieć wstępnie we wdrożeniu, aby umożliwić modułowi zapisywanie dziennika debugowania.

Katalog dzienników można utworzyć dla wdrożenia przy użyciu jednego z następujących dwóch podejść:

  • Dodaj następujący <Target> element do pliku projektu:

    <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>

    Element <MakeDir> tworzy pusty folder Logs w opublikowanych danych wyjściowych. Element używa PublishDir właściwości , aby określić lokalizację docelową do utworzenia folderu. Kilka metod wdrażania, takich jak Web Deploy, pomija puste foldery podczas wdrażania. Element <WriteLinesToFile> generuje plik w folderze Logs , który gwarantuje wdrożenie folderu na serwerze. Tworzenie folderu przy użyciu tej metody kończy się niepowodzeniem, jeśli proces roboczy nie ma dostępu do zapisu do folderu docelowego.

  • Fizycznie utwórz katalog Logs na serwerze we wdrożeniu.

Katalog wdrażania wymaga uprawnień odczyt/wykonanie. Katalog Logs wymaga uprawnień do odczytu/zapisu. Dodatkowe katalogi, w których pliki są zapisywane, wymagają uprawnień do odczytu/zapisu.

Dodatkowe zasoby