컨테이너 도구 빌드 속성

속성 값을 설정하려면 프로젝트 파일을 편집합니다. 예를 들어 Dockerfile의 이름이 MyDockerfile이라고 가정합니다. 다음과 같이 프로젝트 파일에서 속성을 설정할 DockerfilePath 수 있습니다.

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

속성 값을 설정하려면 프로젝트 파일을 편집합니다. 예를 들어 Dockerfile의 이름이 MyDockerfile이라고 가정합니다. 다음과 같이 프로젝트 파일에서 속성을 설정할 DockerfileFile 수 있습니다.

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

.NET SDK 프로젝트의 속성

이 섹션에서는 .NET SDK 컨테이너 빌드 유형을 선택할 때 적용되는 MSBuild 속성에 대해 설명합니다.

.NET SDK 컨테이너화된 프로젝트에 필요한 속성 EnableSdkContainerDebugging은 프로젝트 파일에 하나뿐입니다. 디버깅을 True 사용하도록 설정하려면 .NET SDK 프로젝트로 설정해야 합니다.

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

Dockerfile 프로젝트의 속성

이 섹션에서는 Dockerfile 컨테이너 빌드 유형을 선택할 때 적용되는 MSBuild 속성에 대해 설명합니다.

다음 표에서는 Dockerfile 프로젝트에 사용할 수 있는 MSBuild 속성을 보여줍니다. NuGet 패키지 버전은 Microsoft.VisualStudio.Azure.Containers.Tools.Targets에 적용됩니다.

다음 표에서는 Dockerfile 프로젝트에 사용할 수 있는 MSBuild 속성을 보여줍니다. NuGet 패키지 버전은 Microsoft.VisualStudio.Azure.Containers.Tools.Targets에 적용됩니다.

다음 표의 일부 속성 및 항목 목록은 사용되지 않는 속성에 대한 동등한 대체 항목입니다. 이 경우 대체되는 사용되지 않는 속성의 이름도 지정됩니다. 현재 지원되는 속성을 사용하도록 프로젝트를 업데이트하는 것이 좋습니다. 사용되지 않는 속성에 대한 지원은 향후 Visual Studio 업데이트에서 제거될 수 있습니다.

사용되지 않음으로 나열된 일부 속성은 launchsettings.json동일한 값으로 대체되고 하나는 MSBuild 항목 목록으로 바뀝니다.

ContainerRepository 및 ContainerImageTag (또는 ContainerImageTags) 이미지 레이블의 두 부분, 리포지토리 및 하나 이상의 태그(예 webapp1:alpha: )를 지정하는 기능을 제공합니다. 이전 버전의 Visual Studio에서는 이 속성을 사용하여 DockerfileTag 리포지토리와 단일 태그를 지정할 수 있었지만, 예를 들어 여러 태그를 지정할 수 없는 등의 제한 사항이 있었습니다. 이 속성 DockerfileTag 은 사용되지 않습니다. 프로젝트는 이제 사용하고 ContainerRepositoryContainerImageTag현재 버전은 여러 태그도 지원 ContainerImageTags 합니다.

이전 Visual Studio 버전에서 구문은 .입니다 <DockerfileTag>webapp1:alpha</DockerfileTag>. 현재 해당 항목은 <ContainerRepository>webapp1</ContainerRespository> 및 <ContainerImageTag>alpha</ContainerImageTag>, 또는 <ContainerImageTags>alpha;latest</ContainerImageTags> 여러 태그를 원하는 경우입니다.

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