Add ssh vscode section.

_toc.yml

@@ -19,7 +19,7 @@ chapters:
   - file: content/02_container/2_singularity
 - file: content/03_vscode/0_intro
   sections:
-  - file: content/03_vscode/1_vscode_git
+  - file: content/03_vscode/1_vscode_ssh
   - file: content/03_vscode/2_vscode_docker
 - file: content/04_cluster/0_intro
   sections:

content/03_vscode/1_vscode_git.md

-# SSH in VSCode 
-
-Follows.
\ No newline at end of file

content/03_vscode/1_vscode_ssh.md

+# SSH in VSCode 
+
+"The Visual Studio Code Remote - SSH extension allows you to open a remote folder on any remote machine, virtual machine, or container with a running SSH server and take full advantage of VS Code's feature set. Once connected to a server, you can interact with files and folders anywhere on the remote filesystem." ([Source](hhttps://code.visualstudio.com/docs/remote/ssh))
+
+## Prerequisites
+- [VSCode](https://code.visualstudio.com/) installed and running
+- [Remote - SSH](https://marketplace.visualstudio.com/items?itemName=ms-vscode-remote.remote-ssh) extensions installed within VSCode
+
+
+
+
+## Example working on the KI4All Cluster
+
+1. Open VSCode and click on the green button in the bottom left corner to open the command palette. 
+2. Choose "Remote-SSH: Connect to Host..."
+
+ ```{figure} ../../figures/ssh-vscode-1.png
+---
+align: center
+---
+
+```
+
+3. Enter your user name and the remote name address of the KI4All cluster and press enter. (Make sure that you exchange `your_user_name` with your actual user name.)
+
+ ```{figure} ../../figures/ssh-vscode-2.png
+---
+align: center
+---
+
+```
+
+
+
+4. A new VSCode window opens. Enter your password and press enter to continue.
+
+ ```{figure} ../../figures/ssh-vscode-3.png
+---
+align: center
+---
+
+```
+
+
+5. You are now connected to the KI4All cluster and can work on the cluster as if you were sitting in front of it. 
+   1. You are successfully connected if you see the name of the cluster in the bottom left corner of the VSCode window.
+   2. Cou can now e.g. open a folder on the cluster and work on it.
+   3. or you can work on the cluster via the terminal.
+
+
+ ```{figure} ../../figures/ssh-vscode-4.png
+---
+align: center
+---
+
+```
+
+
+Congratulations! You are now connected to the KI4All cluster via VSCode.
\ No newline at end of file