Propriedades de compilação do Container Tools

Para definir o valor de uma propriedade, edite o arquivo de projeto. Por exemplo, suponha que seu Dockerfile seja chamado MyDockerfile. Você pode definir a DockerfilePath propriedade no arquivo de projeto da seguinte maneira.

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

Para definir o valor de uma propriedade, edite o arquivo de projeto. Por exemplo, suponha que seu Dockerfile seja chamado MyDockerfile. Você pode definir a DockerfileFile propriedade no arquivo de projeto da seguinte maneira.

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

Propriedades para projetos do SDK do .NET

Esta seção descreve as propriedades do MSBuild que se aplicam quando você escolhe o tipo de compilação de contêiner do SDK do .NET.

Há apenas uma propriedade, EnableSdkContainerDebugging, no arquivo de projeto que é necessário para projetos em contêiner do .NET SDK. Ele deve ser definido como True para projetos do SDK do .NET para habilitar a depuração.

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

Propriedades para projetos Dockerfile

Esta seção descreve as propriedades do MSBuild que se aplicam quando você escolhe o tipo de compilação de contêiner Dockerfile.

A tabela a seguir mostra as propriedades do MSBuild disponíveis para projetos Dockerfile. A versão do pacote NuGet aplica-se a Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

A tabela a seguir mostra as propriedades do MSBuild disponíveis para projetos Dockerfile. A versão do pacote NuGet aplica-se a Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Algumas das propriedades e listas de itens na tabela a seguir são substituições equivalentes para propriedades obsoletas. Nesse caso, a propriedade obsoleta que substitui também é nomeada. Recomendamos atualizar os projetos para usar as propriedades atualmente suportadas. O suporte para propriedades obsoletas pode ser removido em uma atualização futura do Visual Studio.

Algumas propriedades listadas como obsoletas são substituídas por valores equivalentes emlaunchsettings.jsone uma é substituída pela lista de itens do MSBuild.

ContainerRepository e ContainerImageTag (ou ContainerImageTags) fornecer a capacidade de especificar as duas partes de um rótulo de imagem, o repositório e uma ou mais tags (por exemplo, webapp1:alpha). Em versões anteriores do Visual Studio, você podia usar a DockerfileTag propriedade para especificar o repositório e uma única tag, mas isso tinha limitações, por exemplo, não havia capacidade de especificar várias tags. A propriedade DockerfileTag está obsoleta, os projetos agora devem usar ContainerRepository e ContainerImageTag, e a versão atual também suporta ContainerImageTags várias tags.

Em versões anteriores do Visual Studio, a sintaxe era <DockerfileTag>webapp1:alpha</DockerfileTag>. O equivalente atual é <ContainerRepository>webapp1</ContainerRespository> e <ContainerImageTag>alpha</ContainerImageTag>, ou <ContainerImageTags>alpha;latest</ContainerImageTags> se você quiser várias tags.

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