Właściwości kompilacji narzędzi kontenera

Aby ustawić wartość właściwości, edytuj plik projektu. Załóżmy na przykład, że plik Dockerfile nosi nazwę MyDockerfile. Właściwość można ustawić DockerfilePath w pliku projektu w następujący sposób.

<PropertyGroup>
   <DockerfilePath>MyDockerfile</DockerfilePath>
</PropertyGroup>

Aby ustawić wartość właściwości, edytuj plik projektu. Załóżmy na przykład, że plik Dockerfile nosi nazwę MyDockerfile. Właściwość można ustawić DockerfileFile w pliku projektu w następujący sposób.

<PropertyGroup>
   <DockerfileFile>MyDockerfile</DockerfileFile>
</PropertyGroup>

Właściwości projektów zestawu .NET SDK

W tej sekcji opisano właściwości programu MSBuild, które mają zastosowanie podczas wybierania typu kompilacji kontenera zestawu SDK platformy .NET.

W pliku projektu jest tylko jedna właściwość, EnableSdkContainerDebuggingktóra jest wymagana dla projektów konteneryzowanych zestawu SDK platformy .NET. Musi być ustawiona na True wartość dla projektów zestawu .NET SDK, aby umożliwić debugowanie.

<PropertyGroup>
   <EnableSdkContainerDebugging>True</EnableSdkContainerDebugging>
</PropertyGroup>

Właściwości projektów Dockerfile

W tej sekcji opisano właściwości programu MSBuild stosowane podczas wybierania typu kompilacji kontenera Dockerfile.

W poniższej tabeli przedstawiono właściwości programu MSBuild dostępne dla projektów dockerfile. Wersja pakietu NuGet ma zastosowanie do elementu Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

W poniższej tabeli przedstawiono właściwości programu MSBuild dostępne dla projektów dockerfile. Wersja pakietu NuGet ma zastosowanie do elementu Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Niektóre właściwości i listy elementów w poniższej tabeli są równoważnymi zamiennikami przestarzałych właściwości. W takim przypadku przestarzała właściwość, którą zastępuje, jest również nazwana. Zalecamy zaktualizowanie projektów w celu korzystania z aktualnie obsługiwanych właściwości. Obsługa przestarzałych właściwości może zostać usunięta w przyszłej aktualizacji programu Visual Studio.

Niektóre właściwości wymienione jako przestarzałe są zastępowane przez równoważne wartości w launchsettings.json, a jeden jest zastępowany przez listę elementów programu MSBuild.

ContainerRepository i ContainerImageTag (lub ContainerImageTags) umożliwiają określenie dwóch części etykiety obrazu, repozytorium i co najmniej jednego tagu (na przykład webapp1:alpha). W poprzednich wersjach programu Visual Studio można użyć DockerfileTag właściwości do określenia repozytorium i pojedynczego tagu, ale miało to ograniczenia, na przykład nie było możliwości określenia wielu tagów. Właściwość DockerfileTag jest przestarzała. Projekty powinny teraz używać ContainerRepository elementów i ContainerImageTag, a bieżąca wersja obsługuje ContainerImageTags również wiele tagów.

W poprzednich wersjach programu Visual Studio składnia to <DockerfileTag>webapp1:alpha</DockerfileTag>. Bieżący odpowiednik to <ContainerRepository>webapp1</ContainerRespository> i <ContainerImageTag>alpha</ContainerImageTag>, lub <ContainerImageTags>alpha;latest</ContainerImageTags> jeśli chcesz mieć wiele tagów.

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

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UserSecretsId>8c7ab9a5-d578-4c40-8b6d-54d174002229</UserSecretsId>
    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
    <!-- By default, Visual Studio uses the folder above the Dockerfile.
         The path is relative to the Dockerfile, so here the context is
         set to the same folder as the Dockerfile. -->
    <ContainerBuildContext>.</ContainerBuildContext>
    <!-- Set `docker run` arguments to mount a volume -->
    <DockerfileRunArguments>-v $(MSBuildProjectDirectory)/host-folder:/container-folder:ro</DockerfileRunArguments>
    <!-- Set `docker build` arguments to add a custom tag -->
    <ContainerBuildArguments>-t contoso/front-end:v2.0</ContainerBuildArguments>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.20.1" />
  </ItemGroup>

</Project>

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

  <PropertyGroup>
    <TargetFramework>net8.0</TargetFramework>
    <Nullable>enable</Nullable>
    <ImplicitUsings>enable</ImplicitUsings>
    <UserSecretsId>8c7ab9a5-d578-4c40-8b6d-54d174002229</UserSecretsId>
    <DockerDefaultTargetOS>Linux</DockerDefaultTargetOS>
    <!-- In CI/CD scenarios, you might need to change the context. By default, Visual Studio uses the
         folder above the Dockerfile. The path is relative to the Dockerfile, so here the context is
         set to the same folder as the Dockerfile. -->
    <DockerfileContext>.</DockerfileContext>
    <!-- Set `docker run` arguments to mount a volume -->
    <DockerfileRunArguments>-v $(MSBuildProjectDirectory)/host-folder:/container-folder:ro</DockerfileRunArguments>
    <!-- Set `docker build` arguments to add a custom tag -->
    <DockerfileBuildArguments>-t contoso/front-end:v2.0</DockerfileBuildArguments>
  </PropertyGroup>

  <ItemGroup>
    <PackageReference Include="Microsoft.VisualStudio.Azure.Containers.Tools.Targets" Version="1.20.1" />
  </ItemGroup>

</Project>