This guide (and single line install script!) will configure your system so you can code entirely on your local machine with no reliance on the remote machine until you need to deploy.<\/p>\n\n\n\n
The previous version of this guide<\/h2>\n\n\n\n
This guide is actually a simplified version of a previous post<\/a> I made about remote debugging .NET Applications on a Raspberry Pi from VS Code.<\/p>\n\n\n\n The previous version had relied on two different items; WSL with OpenSSH (primarily for rsync) and Putty’s Plink.<\/p>\n\n\n\n This version uses the free cwrsync <\/a>tool to remove the need for WSL entirely. Further, using Scott Hansleman’s instructions here<\/a>, we can remove the need for plink entirely.<\/p>\n\n\n\n Finally, I’ve created a one line script you can run from an elevated command prompt which makes getting your machine setup to Remote Deploy and Debug from Visual Studio Code a cinch!<\/p>\n\n\n\n Before you start, you’re going to need to have the following installed;<\/p>\n\n\n\n Instead of following along with a heap of instructions, I’ve created a script that carries out everything you need to prepare your pc to Remote Deploy and Debug .NET code from Visual Studio Code.<\/p>\n\n\n\n Open a command prompt as an Administrator and navigate to your root C drive with “cd \/<\/em><\/strong>“. <\/p>\n\n\n\n There are multiple versions of this script, depending on whether you are using .NET Core 3, .NET 5, .NET 6 or .NET 7;<\/p>\n\n\n\n The first thing the script will do is prompt you for the hostname of the Raspberry Pi you want to deploy your code to.<\/p>\n\n\n\n You’ll also be asked to enter the SSH password for the Pi, so the script can get the Pi setup to allow passwordless SSH – This is often simply “raspberry<\/em><\/strong>“.<\/p>\n\n\n\n This script will perform the following functions;<\/p>\n\n\n\n Once the process has completed. You should be looking at a VS Code Window with the new Console Application Loaded.<\/p>\n\n\n\n Before we can try deploying to the Pi and Debugging remotely, we need to select the correct debugging profile.<\/p>\n\n\n\n Click on the “Run” toolbar button on the left, to show the “Run” options. Drop down the Run Option Dropdown and select the “.NET Core Launch (remote)”<\/p>\n\n\n We’re now ready to test it all out! Go ahead and either press the green “Start Debugging” button, or hit F5 to start the process off.<\/p>\n\n\n\n The predefined tasks.json and launch.json files will run through the following processes on the way to debugging the code on the Pi;<\/p>\n\n\n\n You’ll see the various steps complete, then the “Hello World” application will run with the output showing in the “Debug Console”.<\/p>\n\n\n\n You’ll see various messages reporting which dlls have been loaded. You’ll see “Hello World!” in the Debug Console in blue, before the application ends.<\/p>\n\n\n\n Congratulations, you’ve now deployed your first .NET application to a Raspberry Pi and debugged it remotely!<\/p>\n\n\n\n Now that you’ve got everything set up, it’s possible for you to create new applications and also Deploy and Debug them remotely.<\/p>\n\n\n\n You’ll just need to copy the launch.json and tasks.json files to your .vscode directory once the project has been created.<\/p>\n\n\n\n You’ll then need to modify lines where we’ve referenced the Pi Hostname if you intend to deploy to a different Pi perhaps.<\/p>\n\n\n\n Also, if your solution has multiple projects, you’ll need to modify the tasks.json and launch.json files to point to the correct project within your overall solution.<\/p>\n\n\n\n If you’d like to take a more manual approach to the configuration, or perhaps if you’re interested in what the script is doing, then feel free to follow along from here instead of running the script above.<\/p>\n\n\n\n The first thing we need to do is check if you already have some SSH keys, and if not, then we need to generate some SSH keys so that we can SSH into our Raspberry Pi without using a password.<\/p>\n\n\n\n We can create our keys (or leave them untouched if they already exist by running the following command;<\/p>\n\n\n\n Now that we have the SSH keys, we need to get them on to our Pi.<\/p>\n\n\n\n We can use the windows Type command along with the SSH command to copy the id_rsa.pub file to the Pi. This way, we won’t need to enter a password when we use the SSH command.<\/p>\n\n\n\n Enter the following command, replacing the “<hostname><\/em><\/strong>” placeholder with the hostname for your pi;<\/p>\n\n\n\n You’ll be prompted for the password for your pi of course (In most cases this is “raspberry<\/em><\/strong>” of course).<\/p>\n\n\n\n We can test this works now with the following;<\/p>\n\n\n\n You should see the nice SSH Session appear…<\/p>\n\n\n We’ll be using a tool called Rsync to copy files to the Pi over SSH. The beauty of Rsync is, not only can it copy files over an SSH connection to the Pi, but it will also compare the files already on the Pi, with the files about to be copied. It will then only copy the files which have changed.<\/p>\n\n\n\n This is great for the development lifecycle, as we’re often only changing the odd file here and there normally, so after the first deployment, only one or two files need to be copied to the Pi.<\/p>\n\n\n\n Rsync is a Linux application, in the previous blog post we use the Windows Subsystem for Linux to use the Rsync application.<\/p>\n\n\n\n However, there’s a Windows implementation based on Cygwin called cwRsync<\/a>, we can use this instead of needing to configure WSL at all.<\/p>\n\n\n\n Due to an issue with this version of cwRsync, we also need to create a directory structure that cwRsync can use to store it’s known list of hosts. Normally this would be stored in our userdata folder… But for some reason, cwRsync needs a different directory.<\/p>\n\n\n\n We also need to copy the SSH keys we created above to this new directory.<\/p>\n\n\n\n Finally, we need to set the correct permissions on the new “home” folder, otherwise cwRsync will complain (rather misleadingly) that our keys have insufficient security<\/p>\n\n\n\n Assuming you have an up to date version of Windows 10, you can run a set of commands to set everything up.<\/p>\n\n\n\n Open a command prompt as an Administrator and run the following commands;<\/p>\n\n\n\n When we’re debugging from VS Code, we’ll be using the Microsoft Visual Studio Debugger Package to carry out the debugging on the Pi. The VS Debugger will run the code on the pi through an SSH session, and VS code will connect remotely to the debug session allowing us to interact with that session on our local machine.<\/p>\n\n\n\n To install the VS Debugger, run the following commands;<\/p>\n\n\n\n You’ll need to switch out the “<Pi Host Name><\/em><\/strong>” place holder for the Host Name of your Raspberry Pi.<\/p>\n\n\n\n That will begin the process of downloading and installing the VS Debugger on the Raspberry Pi;<\/p>\n\n\n It’s now time to create a .NET 5 console application and configure it to Remote Deploy and Debug to our Raspberry Pi.<\/p>\n\n\n\n Choose a suitable location on your machine and run the following command, replacing the “<name of project><\/em><\/strong>” placeholder with the name of your project;<\/p>\n\n\n\n Navigate to your new project in the command prompt and use the following to open your new project in VS Code;<\/p>\n\n\n\n Once VS Code has finished loading up, if you’ll be prompted by the C# Extension to add the Build and Debug Assets to the project, go ahead and click the “Yes<\/em><\/strong>” button;<\/p>\n\n\n This will add default launch.json and tasks.json files to your project in a directory called “.vscode”;<\/p>\n\n\n We now need to add a couple of extra tasks to the tasks.json file to firstly create some binaries which are compatible with the Raspberry Pi.<\/p>\n\n\n\n The Raspberry Pi has an ARM processor and is running Linux. We can create compatible binaries using the following command;<\/p>\n\n\n\n Next we can deploy these compiled binaries to the Raspberry Pi using our new cwRsync tool which we configured earlier, using the following command;<\/p>\n\n\n\n We can have Visual Studio Code carry out both of these tasks for us by adding them to the tasks.json file.<\/p>\n\n\n\n Open the tasks.json file and add the following two tasks below the “watch<\/strong>” task (remember to place this code immediately after the “watch” task curly brace, and not at the end of the file!);<\/p>\n\n\n\n You’ll need to switch out the “<Pi Host Name><\/em><\/strong>” placeholder with the correct Host Name for your Raspberry Pi.<\/p>\n\n\n\n Next, we need to configure the launch.json file to connect to the Visual Studio debugger on the Pi, run our code and begin debugging.<\/p>\n\n\n\n Open the launch.json file and add the following section of json below the “.NET Core Attach” launch task;<\/p>\n\n\n\n You’ll again need to switch out the “<Pi Host Name><\/em><\/strong>” placeholder with the correct Host Name for your Raspberry Pi.<\/p>\n\n\n\n You’re not ready to Deploy and Debug your .NET 5 application on the Raspberry Pi!<\/p>\n\n\n\n Before we can try deploying to the Pi and Debugging remotely, we need to select the correct debugging profile.<\/p>\n\n\n\n Click on the “Run” toolbar button on the left, to show the “Run” options. Drop down the Run Option Dropdown and select the “.NET Core Launch (remote)<\/em><\/strong>“<\/p>\n\n\n We’re now ready to test it all out! Go ahead and either press the green “Start Debugging” button, or hit F5 to start the process off.<\/p>\n\n\n\n The predefined tasks.json and launch.json files will run through the following processes on the way to debugging the code on the Pi;<\/p>\n\n\n\n You’ll see the various steps complete, then the “Hello World” application will run with the output showing in the “Debug Console”.<\/p>\n\n\n\n You’ll see various messages reporting which dlls have been loaded. You’ll see “Hello World!” in the Debug Console in blue, before the application ends.<\/p>\n\n\n\nPrerequisites<\/h2>\n\n\n\n
The Quick Way – Run a script<\/h2>\n\n\n\n
For .NET Core 3 run…<\/h3>\n\n\n\n
curl --output remotedebugsetup.bat https:\/\/raw.githubusercontent.com\/pjgpetecodes\/dotnetcore3pi\/master\/remotedebugsetup.bat && remotedebugsetup.bat<\/code><\/pre><\/div>\n\n\n\nFor .NET 5 run…<\/h3>\n\n\n\n
curl --output remotedebugsetup.bat https:\/\/raw.githubusercontent.com\/pjgpetecodes\/dotnet5pi\/master\/remotedebugsetup.bat && remotedebugsetup.bat<\/code><\/pre><\/div>\n\n\n\nFor .NET 6 run…<\/h3>\n\n\n\n
curl --output remotedebugsetup.bat https:\/\/raw.githubusercontent.com\/pjgpetecodes\/dotnet6pi\/master\/remotedebugsetup.bat && remotedebugsetup.bat<\/code><\/pre><\/div>\n\n\n\nFor .NET 7 run…<\/h3>\n\n\n\n
curl --output remotedebugsetup.bat https:\/\/raw.githubusercontent.com\/pjgpetecodes\/dotnet7pi\/master\/remotedebugsetup.bat && remotedebugsetup.bat<\/code><\/pre><\/div>\n\n\n\n![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/Script-Optimised.gif\")
<\/a>Trying out the Remote Deployment and Debugging from VS Code<\/h2>\n\n\n\n
![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-7-1024x576.png\")
<\/a>![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-9.png\")
<\/a>![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-10.png\")
<\/a>![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/VSCode-Optimised.gif\")
<\/a>Next Steps<\/h2>\n\n\n\n
\n\n\n\nThe Step by Step Way (.NET 5)<\/h2>\n\n\n\n
Generate SSH keys<\/h2>\n\n\n\n
if not exist c:\\users\\%username%\\.ssh\\id_rsa ssh-keygen -f c:\\users\\%username%\\.ssh\\id_rsa -t rsa -N ''<\/code><\/pre><\/div>\n\n\n\nCopy SSH Files to the Pi<\/h2>\n\n\n\n
type c:\\Users\\%username%\\.ssh\\id_rsa.pub | ssh pi@<hostname> "cat >> ~\/.ssh\/authorized_keys"<\/code><\/pre><\/div>\n\n\n\nssh pi@<hostname><\/code><\/pre><\/div>\n\n\n\n![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-5.png\")
<\/a>Copying files to the Pi with cwRsync<\/h2>\n\n\n\n
mkdir c:\\home\\%USERNAME%\\.ssh\ncd c:\\home\ncurl --output cwrsync.zip https:\/\/itefix.net\/dl\/free-software\/cwrsync_6.2.7_x64_free.zip && tar -xf cwrsync.zip\nrename bin cwrsync\nmove cwrsync c:\\\ncopy %userprofile%\\.ssh\\* c:\\home\\%username%\\.ssh\nicacls c:\\home \/setowner %username% \/R\nicacls c:\\home \/inheritance:r \/grant:r %username%:(OI)(CI)F \/T<\/code><\/pre><\/div>\n\n\n\nInstall the Visual Studio Debugger on the Pi<\/h2>\n\n\n\n
ssh pi@<Pi Host Name> "cd ~\/ && curl -sSL https:\/\/aka.ms\/getvsdbgsh | \/bin\/sh \/dev\/stdin -v latest -l ~\/vsdbg"<\/code><\/pre><\/div>\n\n\n\n![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2020\/05\/image-9-1024x713.png\")
<\/a>Create and configure a .NET 5 console application<\/h2>\n\n\n\n
dotnet new console -o <name of project><\/code><\/pre><\/div>\n\n\n\ncode .<\/code><\/pre><\/div>\n\n\n\n![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-6.png\")
<\/a>![\"\"](\"https:\/\/wordpress-634681-2064240.cloudwaysapps.com\/wp-content\/uploads\/2021\/01\/image-11.png\")
<\/a>Adding VS Code Tasks for Publish and Deploy<\/h2>\n\n\n\n
dotnet publish -r linux-arm -o bin\\linux-arm\\publish --no-self-contained<\/code><\/pre><\/div>\n\n\n\nrsync -rvuz --rsh=\\"c:\\\\cwrsync\\\\ssh\\" --chmod=700 bin\/linux-arm\/publish\/ pi@r<Pi Host Name>:share\/${workspaceFolderBasename}\/<\/code><\/pre><\/div>\n\n\n\n,\n{\n "label": "RaspberryPiPublish",\n "command": "sh",\n "type": "shell",\n "dependsOn": "build",\n "windows": {\n "command": "cmd",\n "args": [\n "\/c",\n "\\"dotnet publish -r linux-arm -o bin\\\\linux-arm\\\\publish --no-self-contained\\""\n ],\n "problemMatcher": []\n }\n \n},\n{\n "label": "RaspberryPiDeploy",\n "type": "shell",\n "dependsOn": "RaspberryPiPublish",\n "presentation": {\n "reveal": "always",\n "panel": "new"\n },\n "windows": {\n "command": "c:\\\\cwrsync\\rsync -rvuz --rsh=\\"c:\\\\cwrsync\\\\ssh\\" --chmod=700 bin\/linux-arm\/publish\/ pi@<Pi Host Name>:share\/${workspaceFolderBasename}\/"\n },\n "problemMatcher": []\n}<\/code><\/pre><\/div>\n\n\n\nAdding VS Code Launch config to Launch and attach the Remote Debugger<\/h2>\n\n\n\n
,\n{\n "name": ".NET Core Launch (remote)",\n "type": "coreclr",\n "request": "launch",\n "preLaunchTask": "RaspberryPiDeploy",\n "program": "dotnet",\n "args": ["\/home\/pi\/${workspaceFolderBasename}\/${workspaceFolderBasename}.dll"],\n "cwd": "\/home\/pi\/${workspaceFolderBasename}",\n "stopAtEntry": false,\n "console": "internalConsole",\n "pipeTransport": {\n "pipeCwd": "${workspaceFolder}",\n "pipeProgram": "ssh",\n "pipeArgs": [\n "pi@<Pi Host Name>"\n ],\n "debuggerPath": "\/home\/pi\/vsdbg\/vsdbg"\n }\n}<\/code><\/pre><\/div>\n\n\n\nTrying out the Remote Deployment and Debugging from VS Code<\/h2>\n\n\n\n
<\/a><\/a><\/a>