Propriedades de build das Ferramentas de Contêiner

Para definir o valor de uma propriedade, edite o arquivo de projeto. Por exemplo, suponha que seu Dockerfile se chama 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 se chama 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 build de contêiner do SDK do .NET.

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

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

Propriedades para projetos do Dockerfile

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

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

A tabela a seguir mostra as propriedades do MSBuild disponíveis para projetos do Dockerfile. A versão do pacote NuGet se aplica 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 ela substitui também é nomeada. Recomendamos atualizar projetos para usar as propriedades com suporte no momento. 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 em launchsettings.jsone uma é substituída pela lista de itens do MSBuild.

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

Nas 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 marcas.

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