This workflow leverages Visual Studio\u2019s native support for CMake, but the same instructions can be used to build a MSBuild-based Linux project in Visual Studio<\/a>.<\/p>\n First, we\u2019ll set-up a Linux docker container on Windows. You will need to download the Docker Desktop Client for Windows<\/a> and create a docker account if you haven\u2019t already. See Install Docker Desktop on Windows<\/a> for download information, system requirements, and installation instructions.<\/p>\n We\u2019ll get started by pulling down an image of the Ubuntu OS<\/a> \u00a0and running a few commands. From the Windows command prompt run:<\/p>\n This will download the latest image of Ubuntu from Docker. You can see a list of your docker images by running:<\/p>\n Next, we\u2019ll use a Dockerfile to create a custom image based on our local image of Ubuntu. Dockerfiles contain the commands used to assemble an image and allow you to automatically reproduce the same build environment from any machine. See Dockerfile reference<\/a> for more information on authoring your own Dockerfiles. The following Dockerfile can be used to install Visual Studio’s required build tools\u00a0<\/a>and configure SSH. CMake is also a required dependency but I will deploy statically linked binaries<\/a> directly from Visual Studio in a later step. Use your favorite text editor to create a file called \u2018Dockerfile\u2019 with the following content.<\/p>\n We can then build an image<\/a> based on our Dockerfile by running the following command from the directory where your Dockerfile is saved:<\/p>\n Next, we can run a container<\/a> derived from our image:<\/p>\n The -p flag is used to expose the container\u2019s internal port to the host. If this step was successful, then you should automatically attach to the running container. You can stop your docker container at any time and return to the command prompt using the exit <\/strong>command. To reattach, run docker ps -a<\/strong>, docker start <container-ID><\/strong>, and docker attach <container-ID><\/strong> from the command prompt.<\/p>\n Lastly, we will interact with our docker container directly to start SSH and create a user account to use with our SSH connection. Note that you can also enable root login and start SSH from your Dockerfile if you want to avoid any manual and container-specific configuration. Replace <user-name> with the username you would like to use and run:<\/p>\n The -m and -d flags create a user with the specified home directory, and the -s flag sets the user\u2019s default shell.<\/p>\n You are now ready to connect to your container from Visual Studio.<\/p>\n Make sure you have Visual Studio 2019<\/a> and the Linux development with C++ workload<\/a> installed.<\/p>\n Open Visual Studio 2019 a create a new CMake Project. CMake is cross-platform and allows you to configure an application to run on both Windows and Linux.<\/p>\n Once the IDE has loaded, you can add a SSH connection to your Linux docker container the same way you would add any other remote connection<\/a>. Navigate to the Connection Manager (Tools > Options > Cross Platform > Connection Manager) and select \u201cAdd\u201d to add a new remote connection.<\/p>\n Your host name should be \u201clocalhost\u201d, the port should be whatever you are using for your SSH connection (in this example we\u2019re using 5000), and your username and password should match the user account that you just created for your container.<\/p>\n At this point the project behaves like any other CMake project in Visual Studio. To configure and build the console application in our Linux container navigate to \u201cManage Configurations\u2026\u201d in the configuration drop-down. You can then select the green plus sign in the CMake Settings Editor to add a new \u201cLinux-Debug\u201d configuration. Make sure that the remote machine name of your Linux configuration matches the remote connection we created for our Linux docker container.<\/p>\n Save the CMake Settings Editor (ctrl + s) and select your new Linux configuration from the configuration drop-down to kick off a CMake configuration. If you don\u2019t already have CMake installed on your docker container, then Visual Studio will prompt you to deploy statically linked binaries<\/a> directly to your remote connection as a part of the configure step.<\/p>\n At this point you can build your application in your Linux docker container directly from Visual Studio. Additional build settings (including custom toolchain files, CMake variables, and environment variables) can be configured in the CMake Settings Editor<\/a>. The underlying CMakeSettings.json file<\/a> can store multiple build configurations and can be checked into source control and shared between team members.<\/p>\n This post showed you how to build a C++ application in a Linux docker container with Visual Studio. Stay tuned for our next post, where will we show you how to copy the build artifacts back to your local Windows machine and debug using gdbserver on a second remote system.<\/p>\n Do you have feedback on our Linux tooling or CMake support in Visual Studio? We\u2019d love to hear from you to help us prioritize and build the right features for you. We can be reached via the comments below, Developer Community<\/a>, email (visualcpp@microsoft.com<\/a>), and Twitter (@VisualC<\/a>).<\/p>\n","protected":false},"excerpt":{"rendered":" Docker containers provide a consistent development environment for building, testing, and deployment. The virtualized OS, file system, environment settings, libraries, and other dependencies are all encapsulated and shipped as one image that can be shared between developers and machines. This is especially useful for C++ cross-platform developers because you can target a container that runs […]<\/p>\n","protected":false},"author":2953,"featured_media":25289,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,266,292,279],"tags":[],"class_list":["post-25287","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-cplusplus","category-cmake","category-containers","category-linux"],"acf":[],"blog_post_summary":" Docker containers provide a consistent development environment for building, testing, and deployment. The virtualized OS, file system, environment settings, libraries, and other dependencies are all encapsulated and shipped as one image that can be shared between developers and machines. This is especially useful for C++ cross-platform developers because you can target a container that runs […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25287","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/users\/2953"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/comments?post=25287"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/posts\/25287\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media\/25289"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/media?parent=25287"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/categories?post=25287"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/cppblog\/wp-json\/wp\/v2\/tags?post=25287"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}Set-up your first Linux docker container<\/h4>\n
> docker pull ubuntu<\/pre>\n
> docker images<\/pre>\n
![\"\"](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2019\/12\/docker_images.png\")
<\/p>\n# our local base image\r\nFROM ubuntu \r\n\r\nLABEL description=\"Container for use with Visual Studio\" \r\n\r\n# install build dependencies \r\nRUN apt-get update && apt-get install -y g++ rsync zip openssh-server make \r\n\r\n# configure SSH for communication with Visual Studio \r\nRUN mkdir -p \/var\/run\/sshd\r\n\r\nRUN echo 'PasswordAuthentication yes' >> \/etc\/ssh\/sshd_config && \\ \r\n ssh-keygen -A \r\n\r\n# expose port 22 \r\nEXPOSE 22<\/pre>\n
> docker build -t ubuntu-vs .<\/pre>\n
> docker run -p 5000:22 -i -t ubuntu-vs \/bin\/bash<\/pre>\n
> service ssh start\r\n> useradd -m -d \/home\/<user-name> -s \/bin\/bash -G sudo <user-name>\r\n> passwd <user-name><\/pre>\n
Connect to your docker container from Visual Studio<\/h4>\n
![\"Add](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2019\/12\/docker_newConnection.png\")
<\/p>\nConfigure build in Visual Studio<\/h4>\n
![\"\"](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2019\/12\/docker_configurationDropDown.png\")
<\/p>\n![\"Remote](\"https:\/\/devblogs.microsoft.com\/cppblog\/wp-content\/uploads\/sites\/9\/2019\/12\/docker_remoteMachineName.png\")
<\/p>\nComing next<\/h4>\n
Give us your feedback<\/h4>\n