-
Notifications
You must be signed in to change notification settings - Fork 0
Remote SSH
The Remote-SSH extension lets us use a remote machine as our development environment while running VS Code locally. The source code is located on the remote machine.
We are assuming the following tasks have been done beforehand:
- The remote host that we want to connect to is defined in the local SSH configuration file
~/.ssh/config
. - The toy repository has been cloned and set up on the remote machine as described in Basic VS Code setup.
To install/enable the extension, follow the same steps as in the previous sections.
To establish a connection to the remote machine,
- Run
>Remote-SSH: Connect to Host...
- Select your host from the pop up window (
workstation
in our case)
This opens a new VS Code window that is connected to the remote host (see bottom left corner):
Just like we did in the previous sections, we can install extensions on the remote machine.
- Go to
Extensions
in the activity bar
VS Code shows you all the extensions which are installed on the local and on the remote machine. It will also disable certain local extensions if they cannot be used on the remote machine.
To install an extension remotely, simply select a greyed out local extension and click Install in SSH: workstation
:
To modify VS Code user settings on the remote machine,
- Run
>Preferences: Open Remote Settings (JSON) (SSH: workstation)
You can simply copy the contents of your local user settings to the remote file.
Note: Be careful to adjust all paths in case they don't make sense for the remote machine. Settings for extensions which are not installed remotely will simply be greyed out and ignored.
To open a folder on the remote machine,
- Run
>File: Open Folder...
- Select the workspace folder
moderncpp_vscode
First, follow the same steps as in Setting the source directory.
Setting up the CMake kits can be a little bit more complicated.
Often we want to connect to an HPC cluster which uses Environment modules.
In this case, we don't want CMake Tools to find the kits for us.
Instead, we will add them manually by running >CMake: Edit User-Local CMake Kits
:
The first kit we added is
{
"name": "GCC 12",
"compilers": {
"C": "gcc",
"CXX": "g++",
"Fortran": "gfortran"
},
"isTrusted": true,
"environmentSetupScript": "/mnt/home/thahn/scripts/compilers/init_gcc12.sh",
"description": "v12.2.0"
}
As you can see, we did not specify any absolute paths for the compilers.
Instead, we will bring them into the PATH
by loading the right modules with the setup script /mnt/home/thahn/scripts/compilers/init_gcc12.sh
.
The script is located on the remote machine and contains the following lines:
module purge
module load modules/2.2
module load gcc/12
module load cmake
module load git
module load python
Of course, you will need to adjust this file for the remote machine that you are connected to.
Once we have all our kits defined, we can Select a kit + variant and configure the project and Build the project.
To Run tests and examples from the terminal, we might have to load the corresponding modules first.
Otherwise, you can simply run them directly from the Status Bar.
We can also check that the language server works as expected by opening the ./src/linalg.cpp
file and hovering over nda::matrix
:
If you don't need any specific environment setup for your executable, you can simply follow the steps in the CodeLLDB section.
If your executable depends on certain environment modules to be loaded beforehand, it might be easier to debug from the command line or use Dev Containers explained in the next section.