Container Tools build properties
Applies to: 
Visual Studio 
Visual Studio for Mac
Note
This article applies to Visual Studio 2017. If you're looking for the latest Visual Studio documentation, see Visual Studio documentation. We recommend upgrading to the latest version of Visual Studio. Download it here
You can customize how Visual Studio builds your container projects by setting the properties that MSBuild uses to build your project. For example, you can change the name of the Dockerfile, specify tags and labels for your images, provide additional arguments passed to Docker commands, and control whether Visual Studio does certain performance optimizations such as building outside of the container environment. You can also set debugging properties such as the name of the executable to launch, and the command line arguments to provide.
To set the value of a property, edit the project file. For example, suppose your Dockerfile is named MyDockerfile. You can set the DockerfileFile property in the project file as follows.
<PropertyGroup>
<DockerfileFile>MyDockerfile</DockerfileFile>
</PropertyGroup>
You can add the property setting to an existing PropertyGroup element, or if there isn't one, create a new PropertyGroup element.
The following table shows the MSBuild properties available for container projects. The NuGet package version applies to Microsoft.VisualStudio.Azure.Containers.Tools.Targets.
| Property name | Description | Default value | NuGet package version |
|---|---|---|---|
| ContainerDevelopmentMode | Controls whether "build-on-host" optimization ("Fast Mode" debugging) is enabled. Allowed values are Fast and Regular. | Fast | 1.0.1872750 or newer |
| ContainerVsDbgPath | The path for VSDBG debugger. | %USERPROFILE%\vsdbg\vs2017u5 |
1.0.1985401 or newer |
| DockerDebuggeeArguments | When debugging, the debugger is instructed to pass these arguments to the launched executable. | Not applicable to ASP.NET .NET Framework projects | 1.7.8 or newer |
| DockerDebuggeeProgram | When debugging, the debugger is instructed to launch this executable. | For .NET Core projects: dotnet, ASP.NET .NET Framework projects: Not applicable (IIS is always used) | 1.7.8 or newer |
| DockerDebuggeeKillProgram | This command is used to kill the running process in a container. | Not applicable to ASP.NET .NET Framework projects | 1.7.8 or newer |
| DockerDebuggeeWorkingDirectory | When debugging, the debugger is instructed to use this path as the working directory. | C:\app (Windows) or /app (Linux) | 1.7.8 or newer |
| DockerDefaultTargetOS | The default target operating system used when building the Docker image. | Set by Visual Studio. | 1.0.1985401 or newer |
| DockerImageLabels | The default set of labels applied to the Docker image. | com.microsoft.created-by=visual-studio;com.microsoft.visual-studio.project-name=$(MSBuildProjectName) | 1.5.4 or newer |
| DockerFastModeProjectMountDirectory | In Fast Mode, this property controls where the project output directory is volume-mounted into the running container. | C:\app (Windows) or /app (Linux) | 1.9.2 or newer |
| DockerfileBuildArguments | Additional arguments passed to the Docker build command. | Not applicable. | 1.0.1872750 or newer |
| DockerfileContext | The default context used when building the Docker image, as a path relative to the Dockerfile. | Set by Visual Studio. | 1.0.1872750 or newer |
| DockerfileFastModeStage | The Dockerfile stage (that is, target) to be used when building the image in debug mode. | First stage found in the Dockerfile (base) | |
| DockerfileFile | Describes the default Dockerfile that will be used to build/run the container for the project. This can be a path as well. | Dockerfile | 1.0.1872750 or newer |
| DockerfileRunArguments | Additional arguments passed to the Docker run command. | Not applicable. | 1.0.1872750 or newer |
| DockerfileRunEnvironmentFiles | Semicolon-delimited list of environment files applied during Docker run. | Not applicable. | 1.0.1872750 or newer |
| DockerfileTag | The tag that will be used when building the Docker image. In debugging, a ":dev" is appended to the tag. | Assembly name after stripping non-alphanumeric characters with the following rules: If the resultant tag is all numeric, then "image" is inserted as a prefix (for example, image2314) If the resultant tag is an empty string, then "image" is used as the tag. |
1.0.1872750 or newer |
Example
The following project file shows examples of some of these settings.
<Project Sdk="Microsoft.NET.Sdk.Web">
<PropertyGroup>
<TargetFramework>netcoreapp3.1</TargetFramework>
<UserSecretsId>feae72bf-2368-4487-b6c6-546c19338cb1</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 $(pwd)/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.10.6" />
</ItemGroup>
</Project>
Next steps
For information on MSBuild properties generally, see MSBuild Properties.
See also
Docker Compose build properties