Propriétés de build d’Outils de conteneur

Pour définir la valeur d’une propriété, modifiez le fichier projet. Par exemple, supposons que votre fichier Dockerfile soit nommé MyDockerfile. Vous pouvez définir la DockerfilePath propriété dans le fichier projet comme suit.

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

Pour définir la valeur d’une propriété, modifiez le fichier projet. Par exemple, supposons que votre fichier Dockerfile soit nommé MyDockerfile. Vous pouvez définir la DockerfileFile propriété dans le fichier projet comme suit.

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

Propriétés des projets sdk .NET

Cette section décrit les propriétés MSBuild qui s’appliquent lorsque vous choisissez le type de build du conteneur du Kit de développement logiciel (SDK) .NET.

Il n’existe qu’une seule propriété, EnableSdkContainerDebuggingdans le fichier projet qui est nécessaire pour les projets conteneurisés du Kit de développement logiciel (SDK) .NET. Il doit être défini True sur pour les projets du Kit de développement logiciel (SDK) .NET pour activer le débogage.

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

Propriétés des projets Dockerfile

Cette section décrit les propriétés MSBuild qui s’appliquent lorsque vous choisissez le type de build du conteneur Dockerfile.

Le tableau suivant présente les propriétés MSBuild disponibles pour les projets Dockerfile. La version du package NuGet s’applique à Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Le tableau suivant présente les propriétés MSBuild disponibles pour les projets Dockerfile. La version du package NuGet s’applique à Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Certaines des propriétés et listes d’éléments du tableau suivant sont des remplacements équivalents pour les propriétés obsolètes. Dans ce cas, la propriété obsolète qu’elle remplace est également nommée. Nous vous recommandons de mettre à jour des projets pour utiliser les propriétés actuellement prises en charge. La prise en charge des propriétés obsolètes peut être supprimée dans une prochaine mise à jour de Visual Studio.

Certaines propriétés répertoriées comme obsolètes sont remplacées par des valeurs équivalentes dans launchsettings.json, et l’une est remplacée par la liste d’éléments MSBuild.

ContainerRepositoryet ContainerImageTag (ouContainerImageTags) permettent de spécifier les deux parties d’une étiquette d’image, le référentiel et une ou plusieurs balises (par exemple). webapp1:alpha Dans les versions précédentes de Visual Studio, vous pouvez utiliser la DockerfileTag propriété pour spécifier le référentiel et une seule balise, mais cela avait des limitations, par exemple, il n’y avait aucune possibilité de spécifier plusieurs balises. La propriété DockerfileTag est obsolète ; les projets doivent désormais utiliser ContainerRepository et ContainerImageTag, et la version actuelle prend également en charge ContainerImageTags plusieurs balises.

Dans les versions précédentes de Visual Studio, la syntaxe était <DockerfileTag>webapp1:alpha</DockerfileTag>. L’équivalent actuel est <ContainerRepository>webapp1</ContainerRespository> et <ContainerImageTag>alpha</ContainerImageTag>, ou <ContainerImageTags>alpha;latest</ContainerImageTags> si vous souhaitez plusieurs balises.

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