From de344251b13fe5f3cd012d7d4d368ef6d0fa65ea Mon Sep 17 00:00:00 2001 From: Justin Campbell Date: Tue, 18 May 2021 11:36:40 -0400 Subject: [PATCH] Add tip for SSH proxy jump hosts --- docs/Dev Environment Setup Guide.md | 23 +++++++++++++++++++++-- 1 file changed, 21 insertions(+), 2 deletions(-) diff --git a/docs/Dev Environment Setup Guide.md b/docs/Dev Environment Setup Guide.md index 4dd212d..481e503 100644 --- a/docs/Dev Environment Setup Guide.md +++ b/docs/Dev Environment Setup Guide.md @@ -69,9 +69,28 @@ The configuration above will allow you to connect to the development machine and | HostName | The DNS name or IP address of the computer you're connecting to. | | User | The name of your user on the computer you're connecting to. | | LocalForward | Forwards a port on your computer to a port on the computer you're connecting to. | + +Development machines are not publicly accessible. You'll need to be connected to WebVPN to connect to them. -!!! tip - You need to be connected to WebVPN before SSH'ing into a the development machine. +??? tip "SSH Jump Hosts" + WebVPN works on all platforms but requires an extra step to get to work. On macOS/Linux, `pier.ecn.purdue.edu` can be used as an [SSH jump host](https://www.tecmint.com/access-linux-server-using-a-jump-host/) allowing for development machines to be connected to automatically when openning VS Code. + + Assuming you already have an SSH key configured for `pier.ecn.purdue.edu`, you can use a jump host by adding the following to `~/.ssh/config`: + + ``` + Host campb303-pier + HostName pier.ecn.purdue.edu + User campb303 + + Host campb303-w2vm1 + HostName w2vm1.ecn.purdue.edu + ProxyJump campb303-pier + User campb303 + # Forward webqueue2 API Port + LocalForward 5000 localhost:5000 + # Forward webqueue2 API Docs Port + LocalForward 8000 localhost:8000 + ``` To test your configuration, run `ssh` followed by the `Host` value. When prompted for your password, enter your career account password and press Enter.