Build-eigenschappen van Container Tools

Als u de waarde van een eigenschap wilt instellen, bewerkt u het projectbestand. Stel dat uw Dockerfile MyDockerfile heet. U kunt de DockerfilePath eigenschap in het projectbestand als volgt instellen.

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

Als u de waarde van een eigenschap wilt instellen, bewerkt u het projectbestand. Stel dat uw Dockerfile MyDockerfile heet. U kunt de DockerfileFile eigenschap in het projectbestand als volgt instellen.

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

Eigenschappen voor .NET SDK-projecten

In deze sectie worden de MSBuild-eigenschappen beschreven die van toepassing zijn wanneer u het buildtype van de .NET SDK-container kiest.

Er is slechts één eigenschap, EnableSdkContainerDebuggingin het projectbestand dat nodig is voor in containers geplaatste .NET SDK-projecten. Deze moet worden ingesteld op True .NET SDK-projecten om foutopsporing in te schakelen.

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

Eigenschappen voor Dockerfile-projecten

In deze sectie worden de MSBuild-eigenschappen beschreven die van toepassing zijn wanneer u het buildtype Dockerfile-container kiest.

In de volgende tabel ziet u de MSBuild-eigenschappen die beschikbaar zijn voor Dockerfile-projecten. De NuGet-pakketversie is van toepassing op Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

In de volgende tabel ziet u de MSBuild-eigenschappen die beschikbaar zijn voor Dockerfile-projecten. De NuGet-pakketversie is van toepassing op Microsoft.VisualStudio.Azure.Containers.Tools.Targets.

Sommige eigenschappen en itemlijsten in de volgende tabel zijn gelijkwaardige vervangingen voor verouderde eigenschappen. In dat geval wordt ook de verouderde eigenschap genoemd die wordt vervangen. We raden u aan projecten bij te werken om de momenteel ondersteunde eigenschappen te gebruiken. Ondersteuning voor verouderde eigenschappen kan worden verwijderd in een toekomstige update van Visual Studio.

Sommige eigenschappen die als verouderd worden vermeld, worden vervangen door equivalente waarden in launchsettings.jsonen één wordt vervangen door msBuild-itemlijst.

ContainerRepository en ContainerImageTag (of ContainerImageTags) bieden de mogelijkheid om de twee delen van een afbeeldingslabel, de opslagplaats en een of meer tags (bijvoorbeeld webapp1:alpha) op te geven. In eerdere versies van Visual Studio kunt u de DockerfileTag eigenschap gebruiken om de opslagplaats en één tag op te geven, maar dit had beperkingen, bijvoorbeeld, er was geen mogelijkheid om meerdere tags op te geven. De eigenschap DockerfileTag is verouderd; projecten moeten nu worden gebruikt ContainerRepository en ContainerImageTag, en de huidige versie ondersteunt ContainerImageTags ook voor meerdere tags.

In eerdere Versies van Visual Studio was <DockerfileTag>webapp1:alpha</DockerfileTag>de syntaxis . Het huidige equivalent is <ContainerRepository>webapp1</ContainerRespository> en <ContainerImageTag>alpha</ContainerImageTag>, of <ContainerImageTags>alpha;latest</ContainerImageTags> als u meerdere tags wilt.

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