Propiedades de compilación de Las herramientas de contenedor

Para establecer el valor de una propiedad, edite el archivo de proyecto. Por ejemplo, supongamos que el Dockerfile se denomina MyDockerfile. Puede establecer la DockerfilePath propiedad en el archivo del proyecto como se indica a continuación.

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

Para establecer el valor de una propiedad, edite el archivo de proyecto. Por ejemplo, supongamos que el Dockerfile se denomina MyDockerfile. Puede establecer la DockerfileFile propiedad en el archivo del proyecto como se indica a continuación.

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

Propiedades para proyectos del SDK de .NET

En esta sección se describen las propiedades de MSBuild que se aplican al elegir el tipo de compilación de contenedor del SDK de .NET.

Solo hay una propiedad, EnableSdkContainerDebugging, en el archivo de proyecto que se necesita para los proyectos contenedorizados del SDK de .NET. Debe establecerse en True para que los proyectos del SDK de .NET habiliten la depuración.

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

Propiedades para proyectos de Dockerfile

En esta sección se describen las propiedades de MSBuild que se aplican al elegir el tipo de compilación de contenedor dockerfile.

En la tabla siguiente se muestran las propiedades de MSBuild disponibles para los proyectos de Dockerfile. La versión del paquete NuGet se aplica a Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

En la tabla siguiente se muestran las propiedades de MSBuild disponibles para los proyectos de Dockerfile. La versión del paquete NuGet se aplica a Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Algunas de las propiedades y listas de elementos de la tabla siguiente son reemplazos equivalentes para las propiedades obsoletas. En ese caso, la propiedad obsoleta que reemplaza también se denomina . Se recomienda actualizar proyectos para usar las propiedades admitidas actualmente. Es posible que la compatibilidad con propiedades obsoletas se quite en una actualización futura de Visual Studio.

Algunas propiedades enumeradas como obsoletas se reemplazan por valores equivalentes en launchsettings.json, y uno se reemplaza por la lista de elementos de MSBuild.

ContainerRepository y ContainerImageTag (o ContainerImageTags) proporcionan la capacidad de especificar las dos partes de una etiqueta de imagen, el repositorio y una o varias etiquetas (por ejemplo, webapp1:alpha). En versiones anteriores de Visual Studio, podría usar la DockerfileTag propiedad para especificar el repositorio y una sola etiqueta, pero esto tenía limitaciones, por ejemplo, no había capacidad para especificar varias etiquetas. La propiedad DockerfileTag está obsoleta; los proyectos ahora deben usar ContainerRepository y ContainerImageTag, y la versión actual también admite ContainerImageTags para varias etiquetas.

En versiones anteriores de Visual Studio, la sintaxis era <DockerfileTag>webapp1:alpha</DockerfileTag>. El equivalente actual es <ContainerRepository>webapp1</ContainerRespository> y <ContainerImageTag>alpha</ContainerImageTag>, o <ContainerImageTags>alpha;latest</ContainerImageTags> si desea varias etiquetas.

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