Kontejnerizace aplikace .NET s publikováním dotnet

• Sada .NET 8+ SDK
  Pokud máte nainstalovanou dotnet --info technologii .NET, pomocí příkazu určete, kterou sadu SDK používáte.
• Docker Community Edition

• Sada .NET 7+ SDK
  Pokud máte nainstalovanou dotnet --info technologii .NET, pomocí příkazu určete, kterou sadu SDK používáte.
• Docker Community Edition

Přidání balíčku NuGet

Balíček NuGet Microsoft.NET.Build.Containers se v současné době vyžaduje k publikování jiných než webových projektů jako kontejneru. Pokud chcete přidat Microsoft.NET.Build.Containers balíček NuGet do šablony pracovního procesu, spusťte následující příkaz dotnet add package :

dotnet add package Microsoft.NET.Build.Containers

Ve výchozím nastavení je AssemblyName název image kontejneru projektem. Pokud je tento název neplatný jako název image kontejneru, můžete ho přepsat zadáním obrázku ContainerRepository , jak je znázorněno v následujícím souboru projektu:

<Project Sdk="Microsoft.NET.Sdk.Worker">

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UserSecretsId>dotnet-DotNet.ContainerImage-2e40c179-a00b-4cc9-9785-54266210b7eb</UserSecretsId>
    <ContainerRepository>dotnet-worker-image</ContainerRepository>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Hosting" Version="8.0.0" />
  </ItemGroup>
</Project>

Další informace najdete v tématu ContainerRepository.

Ve výchozím nastavení je AssemblyName název image kontejneru projektem. Pokud je tento název neplatný jako název image kontejneru, můžete ho přepsat zadáním (ContainerImageName zastaralého) nebo upřednostňovaného ContainerRepository názvu, jak je znázorněno v následujícím souboru projektu:

<Project Sdk="Microsoft.NET.Sdk.Worker">

  <PropertyGroup>
    <TargetFramework>net7.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UserSecretsId>dotnet-DotNet.ContainerImage-2e40c179-a00b-4cc9-9785-54266210b7eb</UserSecretsId>
    <ContainerImageName>dotnet-worker-image</ContainerImageName>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.Extensions.Hosting" Version="7.0.1" />
    <PackageReference Include="Microsoft.NET.Build.Containers" Version="7.0.401" />
  </ItemGroup>
</Project>

Další informace naleznete v tématu ContainerImageName.

Determining projects to restore...
  All projects are up-to-date for restore.
  DotNet.ContainerImage -> .\Worker\bin\Release\net8.0\linux-x64\DotNet.ContainerImage.dll
  DotNet.ContainerImage -> .\Worker\bin\Release\net8.0\linux-x64\publish\
  Building image 'dotnet-worker-image' with tags latest on top of base image mcr.microsoft.com/dotnet/aspnet:8.0
  Pushed container 'dotnet-worker-image:latest' to Docker daemon

Determining projects to restore...
  All projects are up-to-date for restore.
  DotNet.ContainerImage -> .\Worker\bin\Release\net7.0\linux-x64\DotNet.ContainerImage.dll
  DotNet.ContainerImage -> .\Worker\bin\Release\net7.0\linux-x64\publish\
  Building image 'dotnet-worker-image' with tags 1.0.0 on top of base image mcr.microsoft.com/dotnet/aspnet:7.0
  Pushed container 'dotnet-worker-image:1.0.0' to Docker daemon

ContainerArchiveOutputPath

Počínaje rozhraním .NET 8 můžete vytvořit kontejner přímo jako archiv tar.gz . Tato funkce je užitečná, pokud pracovní postup není jednoduchý a vyžaduje, abyste například před nasdílením obrázků spustili nástroj pro skenování. Po vytvoření archivu ho můžete přesunout, zkontrolovat nebo načíst do místní sady nástrojů Dockeru.

Pokud chcete publikovat do archivu ContainerArchiveOutputPath , přidejte do příkazu vlastnost dotnet publish , například:

dotnet publish \
  -p PublishProfile=DefaultContainer \
  -p ContainerArchiveOutputPath=./images/sdk-container-demo.tar.gz

Můžete zadat název složky nebo cestu s určitým názvem souboru. Pokud zadáte název složky, název souboru vygenerovaný pro soubor archivu obrázku bude $(ContainerRepository).tar.gz. Tyto archivy mohou obsahovat více značek uvnitř, pouze když je vytvořen jeden soubor pro všechny ContainerImageTags.

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:8.0</ContainerBaseImage>
</PropertyGroup>

<PropertyGroup>
    <ContainerBaseImage>mcr.microsoft.com/dotnet/runtime:7.0</ContainerBaseImage>
</PropertyGroup>

ContainerFamily

Počínaje rozhraním .NET 8 můžete pomocí ContainerFamily vlastnosti MSBuild zvolit jinou řadu imagí kontejnerů poskytovaných Microsoftem jako základní image pro vaši aplikaci. Při nastavení se tato hodnota připojí na konec vybrané značky specifické pro TFM a změní zadanou značku. Pokud chcete například použít varianty Alpine Linux základních imagí .NET, můžete nastavit ContainerFamily následující alpine:

<PropertyGroup>
    <ContainerFamily>alpine</ContainerFamily>
</PropertyGroup>

Předchozí konfigurace projektu má za následek konečnou značku 8.0-alpine pro aplikaci zacílenou na .NET 8.

Toto pole je volné a často se dá použít k výběru různých distribucí operačního systému, výchozích konfigurací balíčků nebo jiných změn základní image. Toto pole se při nastavení ignoruje ContainerBaseImage . Další informace najdete v tématu Image kontejneru .NET.

ContainerRepository

Úložiště kontejneru je název samotné image, dotnet/runtime například nebo my-app. Ve výchozím nastavení AssemblyName se používá projekt.

<PropertyGroup>
    <ContainerRepository>my-app</ContainerRepository>
</PropertyGroup>

ContainerImageName

Název image kontejneru řídí název samotné image, dotnet/runtime například nebo my-app. Ve výchozím nastavení AssemblyName se používá projekt.

<PropertyGroup>
    <ContainerImageName>my-app</ContainerImageName>
</PropertyGroup>

Počínaje rozhraním .NET 8 platí, že pokud není zadána výchozí latestznačka.

Ve výchozím nastavení Version se projekt používá jako hodnota značky.

Počínaje rozhraním .NET 8 se odvozuje, ContainerPort pokud není explicitně zadáno na základě několika dobře známých proměnných prostředí ASP.NET:

• ASPNETCORE_URLS
• ASPNETCORE_HTTP_PORTS
• ASPNETCORE_HTTPS_PORTS

Pokud jsou tyto proměnné prostředí přítomny, jejich hodnoty se analyzují a převedou na mapování portů TCP. Tyto proměnné prostředí se čtou ze základní image, pokud jsou k dispozici, nebo z proměnných prostředí definovaných v projektu prostřednictvím ContainerEnvironmentVariable položek. Další informace naleznete v tématu ContainerEnvironmentVariable.

Způsob spouštění aplikace však můžete řídit pomocí některé kombinace ContainerAppCommandContainerAppCommandArgs, , ContainerDefaultArgsa ContainerAppCommandInstruction.

Tyto různé body konfigurace existují, protože různé základní image používají různé kombinace kontejneru ENTRYPOINT a COMMAND vlastností a chcete mít možnost podporovat všechny z nich. Výchozí hodnoty by měly být použitelné pro většinu aplikací, ale pokud chcete přizpůsobit chování při spuštění aplikace, měli byste:

• Identifikujte binární soubor, který se má spustit, a nastavte ho jako ContainerAppCommand
• Určete, které argumenty jsou potřeba ke spuštění aplikace, a nastavte je jako ContainerAppCommandArgs
• Určete, které argumenty (pokud nějaké) jsou volitelné , a uživatel je může přepsat a nastavit je jako ContainerDefaultArgs
• Nastavte ContainerAppCommandInstruction na hodnotu DefaultArgs.

Další informace najdete v následujících položkách konfigurace.

ContainerAppCommand

Položka konfigurace příkazu aplikace je logický vstupní bod vaší aplikace. U většiny aplikací se jedná o AppHost, vygenerovaný spustitelný binární soubor pro vaši aplikaci. Pokud vaše aplikace negeneruje AppHost, bude tento příkaz obvykle dotnet <your project dll>. Tyto hodnoty se použijí po libovolném ENTRYPOINT základním kontejneru nebo přímo v případě, že nejsou ENTRYPOINT definovány.

Konfigurace ContainerAppCommand má jednu Include vlastnost, která představuje příkaz, možnost nebo argument pro použití v příkazu vstupního bodu:

<ItemGroup Label="ContainerAppCommand Assignment">
  <!-- This is how you would start the dotnet ef tool in your container -->
  <ContainerAppCommand Include="dotnet" />
  <ContainerAppCommand Include="ef" />

  <!-- This shorthand syntax means the same thing, note the semicolon separating the tokens. -->
  <ContainerAppCommand Include="dotnet;ef" />
</ItemGroup>

ContainerAppCommandArgs

Tato položka příkazu aplikace args konfigurace představuje všechny logicky požadované argumenty pro vaši aplikaci, které by se měly použít na ContainerAppCommand. Ve výchozím nastavení se pro aplikaci negenerují žádné. Pokud jsou k dispozici, použijí sergy v kontejneru při jeho spuštění.

Konfigurace ContainerAppCommandArgs má jednu Include vlastnost, která představuje možnost nebo argument, který se má použít pro ContainerAppCommand příkaz.

<ItemGroup>
  <!-- Assuming the ContainerAppCommand defined above, 
       this would be the way to force the database to update.
  -->
  <ContainerAppCommandArgs Include="database" />
  <ContainerAppCommandArgs Include="update" />

  <!-- This is the shorthand syntax for the same idea -->
  <ContainerAppCommandArgs Include="database;update" />
</ItemGroup>

ContainerDefaultArgs

Tato výchozí položka konfigurace args představuje všechny argumenty přepisovatelné uživatelem pro vaši aplikaci. To je dobrý způsob, jak poskytnout výchozí hodnoty, které může vaše aplikace potřebovat spustit způsobem, který usnadňuje spuštění, ale i tak snadné přizpůsobení.

Konfigurace ContainerDefaultArgs má jednu Include vlastnost, která představuje možnost nebo argument, který se má použít pro ContainerAppCommand příkaz.

<ItemGroup>
  <!-- Assuming the ContainerAppCommand defined above, 
       this would be the way to force the database to update.
  -->
  <ContainerDefaultArgs Include="database" />
  <ContainerDefaultArgs Include="update" />

  <!-- This is the shorthand syntax for the same idea -->
  <ContainerDefaultArgs Include="database;update" />
</ItemGroup>

ContainerAppCommandInstruction

Konfigurace instrukce příkazu aplikace pomáhá řídit způsob, jakým ContainerEntrypoint, ContainerEntrypointArgs, ContainerAppCommand, ContainerAppCommandArgsa ContainerDefaultArgs jsou kombinovány tak, aby se vytvořil konečný příkaz, který se spustí v kontejneru. To velmi závisí na tom, jestli ENTRYPOINT je v základní imagi k dispozici. Tato vlastnost má jednu ze tří hodnot: "DefaultArgs", "Entrypoint"nebo "None".

• Entrypoint:
  • V tomto režimu je vstupní bod definován pomocí ContainerAppCommand, ContainerAppCommandArgsa ContainerDefaultArgs.
• None:
  • V tomto režimu je vstupní bod definován pomocí ContainerEntrypoint, ContainerEntrypointArgsa ContainerDefaultArgs.
• DefaultArgs:
  • Jedná se o nejsložitější režim – pokud nejsou k dispozici žádné položky ContainerEntrypoint[Args] , ContainerAppCommand[Args]ContainerDefaultArgs slouží k vytvoření vstupního bodu a příkazu. Vstupní bod základní image pro základní image, které mají pevně zakódované dotnet nebo /usr/bin/dotnet se přeskočí, takže máte úplnou kontrolu.
  • Pokud jsou oba ContainerEntrypoint a ContainerAppCommand jsou k dispozici, ContainerEntrypoint stane se vstupním bodem a ContainerAppCommand stane se příkazem.

ContainerUser

Vlastnost konfigurace uživatele řídí výchozího uživatele, který kontejner spouští jako. To se často používá ke spuštění kontejneru jako uživatele, který není v kořenovém adresáři, což je osvědčený postup zabezpečení. Pro tuto konfiguraci existuje několik omezení, o které je potřeba vědět:

• Může to mít různé formy – uživatelské jméno, ID uživatele linuxu, název skupiny, ID username:groupnameskupiny linuxu a další varianty ID.
• Neexistuje žádné ověření, že zadaný uživatel nebo skupina na obrázku existuje.
• Změna uživatele může změnit chování aplikace, zejména pokud jde o věci, jako jsou oprávnění systému souborů.

Výchozí hodnota tohoto pole se liší podle projektu TFM a cílového operačního systému:

• Pokud cílíte na .NET 8 nebo novější a používáte image modulu runtime Microsoftu, postupujte takhle:
  • v Linuxu se používá uživatel app bez rootu (i když na něj odkazuje jeho ID uživatele).
  • v systému Windows se používá uživatel ContainerUser bez rootu.
• V opačném případě se nepoužívá žádné výchozí nastavení ContainerUser .

<PropertyGroup>
  <ContainerUser>my-existing-app-user</ContainerUser>
</PropertyGroup>

Můžete ale řídit, jak se aplikace spouští pomocí ContainerEntrypoint a ContainerEntrypointArgs.

ContainerEntrypoint

Vstupní bod kontejneru lze použít k přizpůsobení ENTRYPOINT kontejneru, což je spustitelný soubor, který se volá při spuštění kontejneru. Ve výchozím nastavení se pro sestavení, která vytvářejí hostitele aplikace, nastaví jako ContainerEntrypoint. Pro sestavení, které nevytvoří spustitelný soubor, dotnet path/to/app.dll se použije jako ContainerEntrypoint.

Uzel ContainerEntrypoint má jeden atribut:

• Include: Příkaz, možnost nebo argument, který se má použít v ContainerEntrypoint příkazu.

Představte si například následující ukázkovou skupinu položek projektu .NET:

<ItemGroup Label="Entrypoint Assignment">
  <!-- This is how you would start the dotnet ef tool in your container -->
  <ContainerEntrypoint Include="dotnet" />
  <ContainerEntrypoint Include="ef" />

  <!-- This shorthand syntax means the same thing.
       Note the semicolon separating the tokens. -->
  <ContainerEntrypoint Include="dotnet;ef" />
</ItemGroup>

ContainerEntrypointArgs

Uzel args vstupního bodu kontejneru řídí výchozí argumenty zadané do objektu ContainerEntrypoint. To by se mělo použít, pokud ContainerEntrypoint je program, který uživatel může chtít použít samostatně. Ve výchozím nastavení se za vás nevytvořila žádná ContainerEntrypointArgs .

Uzel ContainerEntrypointArg má jeden atribut:

• Include: Možnost nebo argument, které se mají použít pro ContainerEntrypoint příkaz.

Představte si následující příklad skupiny položek projektu .NET:

<ItemGroup>
  <!-- Assuming the ContainerEntrypoint defined above,
       this would be the way to update the database by
       default, but let the user run a different EF command. -->
  <ContainerEntrypointArgs Include="database" />
  <ContainerEntrypointArgs Include="update" />

  <!-- This is the shorthand syntax for the same idea -->
  <ContainerEntrypointArgs Include="database;update" />
</ItemGroup>