Docker Compose 빌드 속성

컨테이너 도구 빌드 속성에 설명된 개별 Docker 프로젝트 제어 속성 외에도, MSBuild에서 솔루션을 빌드하는 데 사용하는 Docker Compose 속성을 설정하여 Visual Studio에서 Docker Compose 프로젝트를 빌드하는 방식을 사용자 지정할 수 있습니다. Docker Compose 구성 파일에서 파일 레이블을 설정하여 Visual Studio 디버거가 Docker Compose 앱을 실행하는 방식을 제어할 수도 있습니다.

MSBuild 속성을 설정하는 방법

속성의 값을 설정하려면 프로젝트 파일을 편집합니다. Docker Compose 속성의 경우 다음 섹션의 .dcproj 표에 달리 표시되지 않는 한 이 프로젝트 파일은 확장명의 파일입니다. 예를 들어 디버깅을 시작할 때 브라우저를 시작하도록 지정한다고 가정해 봅시다. 다음과 같이 프로젝트 파일에서 DockerLaunchAction 속성을 설정할 .dcproj 수 있습니다.

<PropertyGroup>
   <DockerLaunchAction>LaunchBrowser</DockerLaunchAction>
</PropertyGroup>

기존 PropertyGroup 요소에 속성 설정을 추가하거나, 기존 요소가 없는 경우 새 PropertyGroup 요소를 만들 수 있습니다.

Docker Compose MSBuild 속성

다음 표에서는 Docker Compose 프로젝트(.dcproj 파일)에 사용할 수 있는 MSBuild 속성을 보여 줍니다.

또한 .csproj 또는 .vbproj 프로젝트 파일의 속성 DockerComposeProjectPath Docker Compose 프로젝트(.dcproj) 파일에 대한 상대 경로를 지정합니다. 서비스 프로젝트를 게시할 때 이 속성을 설정하여 docker-compose.yml 파일에 저장된 연결된 이미지 빌드 설정을 찾습니다.

예시

상대 경로로 설정 docker-compose 하여 파일의 DockerComposeBaseFilePath 위치를 변경하는 경우 솔루션 폴더를 참조하도록 빌드 컨텍스트가 변경되었는지 확인해야 합니다. 예를 들어 파일이 DockerComposeFilesdocker-compose폴더인 경우 Docker Compose 파일은 빌드 컨텍스트를 ".." 또는 ".로 설정해야 합니다. /.."는 솔루션 폴더를 기준으로 하는 위치에 따라 달라집니다.

<?xml version="1.0" encoding="utf-8"?>
<Project ToolsVersion="15.0" Sdk="Microsoft.Docker.Sdk">
  <PropertyGroup Label="Globals">
    <ProjectVersion>2.1</ProjectVersion>
    <DockerTargetOS>Windows</DockerTargetOS>
    <ProjectGuid>154022c1-8014-4e9d-bd78-6ff46670ffa4</ProjectGuid>
    <DockerLaunchAction>LaunchBrowser</DockerLaunchAction>
    <DockerServiceUrl>{Scheme}://{ServiceIPAddress}{ServicePort}</DockerServiceUrl>
    <DockerServiceName>webapplication1</DockerServiceName>
    <DockerComposeBaseFilePath>DockerComposeFiles\mydockercompose</DockerComposeBaseFilePath>
    <AdditionalComposeFilePaths>AdditionalComposeFiles\myadditionalcompose.yml</AdditionalComposeFilePaths>
  </PropertyGroup>
  <ItemGroup>
    <None Include="DockerComposeFiles\mydockercompose.override.yml">
      <DependentUpon>DockerComposeFiles\mydockercompose.yml</DependentUpon>
    </None>
    <None Include="DockerComposeFiles\mydockercompose.yml" />
    <None Include=".dockerignore" />
  </ItemGroup>
</Project>

mydockercompose.yml 파일은 다음과 같으며, 빌드 컨텍스트가 솔루션 폴더의 상대 경로(이 경우 ..)로 설정된 상태입니다.

version: '3.4'

services:
  webapplication1:
    image: ${DOCKER_REGISTRY-}webapplication1
    build:
      context: ..
      dockerfile: WebApplication1\Dockerfile

Visual Studio의 Docker Compose 구성 재정의

일반적으로 docker-compose.ci.build.yml은 docker-compose.yml의 특정 설정을 재정의하는 데 사용됩니다. 또한 Visual Studio는 Visual Studio 내에서 애플리케이션을 실행하는 것과 관련된 설정을 사용하여 docker-compose.vs.debug.g.yml(빠른 모드의 경우) 및 docker-compose.vs.release.g.yml(일반 모드의 경우) 재정의 파일을 생성합니다. docker-compose.vs.debug.yml(빠름 모드의 경우) 또는 docker-compose.vs.release.yml(일반 모드의 경우) 파일을 docker-compose.yml 파일과 동일한 디렉터리에 배치하여 이러한 Visual Studio 설정을 재정의할 수 있습니다. Docker Compose 프로젝트를 마우스 오른쪽 단추로 클릭하고 파일 탐색기 폴더 열기를 선택한 다음, 기존 항목>Docker Compose 프로젝트에 파일을 추가합니다.

Docker Compose 파일 레이블

docker-compose.vs.debug.yml 또는 docker-compose.vs.release.yml에서는 다음과 같이 재정의와 관련된 레이블을 정의할 수 있습니다.

services:
  webapplication1:
    labels:
      com.microsoft.visualstudio.debuggee.workingdirectory: "C:\\my_app_folder"

앞의 예제와 같이 값을 큰따옴표로 묶고, 경로의 백슬래시에 대한 이스케이프 문자로 백슬래시를 사용합니다.

Docker 빌드 프로세스 사용자 지정

target 속성의 build 설정을 사용하여 사용자 Dockerfile에서 빌드할 스테이지를 선언할 수 있습니다. 이 재정의는 docker-compose.vs.debug.yml 또는 docker-compose.vs.release.yml에서만 사용할 수 있습니다.

services:
  webapplication1:
    build:
      target: customStage
    labels:
      ...

앱 시작 프로세스 사용자 지정

entrypoint 설정을 사용하여 앱을 시작하고 DockerDevelopmentMode에 종속되도록 만들기 전에 명령 또는 사용자 지정 스크립트를 실행할 수 있습니다. 예를 들어 를 실행하여 update-ca-certificates 모드가 아닌 빠름 모드에서만 인증서를 설정해야 하는 경우 오직docker-compose.vs.debug.yml에 다음 코드를 추가할 수 있습니다.

services:
  webapplication1:
    entrypoint: "sh -c 'update-ca-certificates && tail -f /dev/null'"
    labels:
      ...

자세한 내용은 컨테이너 진입점을 참조 하세요.

다음 단계

MSBuild 속성에 대한 일반적인 내용은 MSBuild 속성을 참조하세요.

참고 항목

컨테이너 도구 빌드 속성

컨테이너 도구 시작 설정

Visual Studio에서 Docker Compose의 시작 프로필 관리

MSBuild의 예약된 속성 및 잘 알려진 속성