Свойства сборки средств контейнеров

Чтобы задать значение свойства, измените файл проекта. Например, предположим, что файл Dockerfile называется MyDockerfile. Свойство в файле проекта можно задать DockerfilePath следующим образом.

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

Чтобы задать значение свойства, измените файл проекта. Например, предположим, что файл Dockerfile называется MyDockerfile. Свойство в файле проекта можно задать DockerfileFile следующим образом.

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

Свойства проектов пакета SDK для .NET

В этом разделе описываются свойства MSBuild, которые применяются при выборе типа сборки контейнера пакета SDK для .NET.

Существует только одно свойство, EnableSdkContainerDebuggingв файле проекта, который необходим для контейнерных проектов пакета SDK для .NET. Он должен иметь значение True для проектов пакета SDK для .NET, чтобы включить отладку.

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

Свойства для проектов Dockerfile

В этом разделе описываются свойства MSBuild, которые применяются при выборе типа сборки контейнера Dockerfile.

В следующей таблице показаны свойства MSBuild, доступные для проектов Dockerfile. Версия пакета NuGet применяется к Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

В следующей таблице показаны свойства MSBuild, доступные для проектов Dockerfile. Версия пакета NuGet применяется к Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Некоторые из списков свойств и элементов в следующей таблице эквивалентны замене устаревших свойств. В этом случае устаревшее свойство, которое он заменяет, также называется. Мы рекомендуем обновить проекты для использования поддерживаемых в настоящее время свойств. Поддержка устаревших свойств может быть удалена в будущем обновлении Visual Studio.

Некоторые свойства, перечисленные как устаревшие, заменяются эквивалентными значениями в launchsettings.json, а один — списком элементов MSBuild.

ContainerRepository и ContainerImageTag (или ContainerImageTags) предоставляют возможность указывать две части метки изображения, репозиторий и один или несколько тегов (например, webapp1:alpha). В предыдущих версиях Visual Studio можно использовать DockerfileTag свойство для указания репозитория и одного тега, но это было ограничение, например, невозможно указать несколько тегов. Свойство DockerfileTag устарело; теперь проекты должны использовать ContainerRepository и ContainerImageTag, а текущая версия также поддерживает ContainerImageTags для нескольких тегов.

В предыдущих версиях Visual Studio синтаксис был <DockerfileTag>webapp1:alpha</DockerfileTag>. Текущий эквивалент и , если <ContainerImageTags>alpha;latest</ContainerImageTags> требуется <ContainerRepository>webapp1</ContainerRespository><ContainerImageTag>alpha</ContainerImageTag>несколько тегов.

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