WSL

Many of the tools used in the course will not work natively on Windows, and to make the journey smoother, students on Windows are recommended to install WSL (Windows Subsystem for Linux). An alternative approach is to create a machine in CSCloud with the single purpose of running the tools in the course.

Install WSL

Follow the guide: https://learn.microsoft.com/en-us/windows/wsl/setup/environment

  1. Start of by installing WSL
  2. Setup your Linux username and password
  3. Update and upgrade packages
  4. (There is no need to add additional distributions.)
  5. Set up the Windows Terminal
  6. Try out the File Storage
  7. Setup Visual Studio Code
  8. Setup Git
  9. (Remote development with Docker)
  10. Read Basic WSL Commands

Add SSH-keys to WSL

The WSL is a virtual computer in windows and will not have access to your, in Windows, added SSH-keys. It is possible to sync keys between Windows and WSL, however we recommend to have separate keys in WSL and Windows.

Remember! WHen you are in WSL you should follow guides aimed towards Linux/Ubuntu, not Windows!

Add SSH-keys to Gitlab

  1. Start of by creating new SSH-keys in WSL by following the guide at Gitlab.com
  2. Add the public part of the key to your Gitlab.lnu.se-account
  3. Verify that you can communicate between WSL and Gitlab: ssh -T git@gitlab.lnu.se

Add your CSCloud SSH-keys

  1. Download the SSH-key (xx222yy_key_ssh.pem) from your "Secrets"-project on Gitlab and add to the folder ~/.ssh/ in WSL.
  2. Change the key permissions to 600: chmod 600 ~/.ssh/xx222yy_key_ssh.pem