{"id":52421,"date":"2017-01-26T11:48:01","date_gmt":"2017-01-26T18:48:01","guid":{"rendered":"https:\/\/devblogs.microsoft.com\/devops\/?p=52421"},"modified":"2019-02-14T15:55:53","modified_gmt":"2019-02-14T23:55:53","slug":"debugging-net-core-on-unix-over-ssh","status":"publish","type":"post","link":"https:\/\/devblogs.microsoft.com\/devops\/debugging-net-core-on-unix-over-ssh\/","title":{"rendered":"Debugging .NET Core on Unix over SSH"},"content":{"rendered":"

With the release of Visual Studio 2017 RC3 it is now possible to attach to .NET Core processes running on Linux over SSH. This blog post will explain how to set this up.<\/p>\n

Machine Setup<\/h3>\n

On the Visual Studio computer, you need to install either the ‘ASP.NET and web development’ or the “.NET Core cross-platform development” workload in the 1\/26\/17 update<\/a> for\u00a0VS 2017 RC<\/a>. If you previously installed Visual Studio 2017 RC, you can see if it is an RC3 release from Help->About.<\/p>\n

On the Linux server, you need to install SSH server, unzip and either curl or wget. For example, on Ubuntu you can do that by running:<\/p>\n

sudo apt-get install openssh-server unzip curl<\/code><\/p>\n

Deploying the Application<\/h3>\n

In order to debug your application running on Linux, it will first need to be deployed there. One option for doing this is to copy sources to the target computer and build with \u2018dotnet build\u2019 on the Linux machine. Another option would be to build on Windows, and transfer the built artifacts (the application itself, any runtime libraries it might depend on and the .deps.json file).<\/p>\n

For debugging, there are two important notes. First, it is much harder to debug retail-compiled code than debug-compiled code, so it is highly recommended to use the \u2018Debug\u2019 configuration. If you do need to use the \u2018Release\u2019 configuration, make sure to disable Tool->Options->Debugging->Just My Code. Second, the debugger for Linux will need to make sure Portable PDBs<\/a> are enabled (which is the default), and they will need to be next to the dll.<\/p>\n

Attaching the Debugger<\/h3>\n

Once the computers are configured and the application is up and running now we are ready to attach the debugger.<\/p>\n

    \n
  1. Go to Debug->Attach to Process\u2026<\/li>\n
  2. In the \u2018Connection Type\u2019 drop down, select \u2018SSH\u2019<\/li>\n
  3. Change the \u2018Connection Target\u2019 to the IP address or host name of the target computer<\/li>\n
  4. Find the process that you would like to debug. By default, your code will run in a \u2018dotnet\u2019 process. You can look at the \u2018Title\u2019 column to see each processes command line arguments to find the process that you are interested in.\n\"Attach<\/a><\/li>\n
  5. Click \u2018Attach\u2019. You will get a dialog to select which type of code you would like to debug. Pick \u2018Managed (.NET Core for Unix)\u2019.<\/li>\n
  6. Debug as you would expect<\/li>\n<\/ol>\n

    \"A<\/a><\/p>\n

    If you have any feedback we\u2019d love to hear from you, send it from the VS Send Feedback feature or find us on twitter at @VS_Debugger<\/a>.<\/p>\n

    Gregg Miskelly<\/strong>\nPrincipal Software Engineerunzip curl<\/p>\n","protected":false},"excerpt":{"rendered":"

    With the release of Visual Studio 2017 RC3 it is now possible to attach to .NET Core processes running on Linux over SSH. This blog post will explain how to set this up. Machine Setup On the Visual Studio computer, you need to install either the ‘ASP.NET and web development’ or the “.NET Core cross-platform […]<\/p>\n","protected":false},"author":26,"featured_media":45953,"comment_status":"open","ping_status":"closed","sticky":false,"template":"","format":"standard","meta":{"_acf_changed":false,"footnotes":""},"categories":[1,225,249],"tags":[],"class_list":["post-52421","post","type-post","status-publish","format-standard","has-post-thumbnail","hentry","category-devops","category-git","category-open-source"],"acf":[],"blog_post_summary":"

    With the release of Visual Studio 2017 RC3 it is now possible to attach to .NET Core processes running on Linux over SSH. This blog post will explain how to set this up. Machine Setup On the Visual Studio computer, you need to install either the ‘ASP.NET and web development’ or the “.NET Core cross-platform […]<\/p>\n","_links":{"self":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/52421","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts"}],"about":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/types\/post"}],"author":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/users\/26"}],"replies":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/comments?post=52421"}],"version-history":[{"count":0,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/posts\/52421\/revisions"}],"wp:featuredmedia":[{"embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media\/45953"}],"wp:attachment":[{"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/media?parent=52421"}],"wp:term":[{"taxonomy":"category","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/categories?post=52421"},{"taxonomy":"post_tag","embeddable":true,"href":"https:\/\/devblogs.microsoft.com\/devops\/wp-json\/wp\/v2\/tags?post=52421"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}