Skip to content

Commit 227fb1b

Browse files
committed
more porting
1 parent f18deda commit 227fb1b

File tree

8 files changed

+99
-1
lines changed

8 files changed

+99
-1
lines changed

docs/srde/02_user_guide/01_getting_started.mdx renamed to docs/srde/02_user_guide/01_connecting.mdx

Lines changed: 99 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,4 +1,4 @@
1-
# SRDE User Guide
1+
# Connecting to SRDE
22

33
Remote access to the secure environment workspace via the Command Line Interface. The SRDE consists of two separate servers:
44
- The Workspace Host is where you access and analyze data
@@ -162,3 +162,101 @@ And then on the bastion VM:
162162
```sh
163163
ssh 10.0.0.2
164164
```
165+
166+
167+
## Connecting on MacOS/Linux
168+
169+
### Install gcloud CLI
170+
Follow the [official guidelines](https://cloud.google.com/sdk/docs/install-sdk#installing_the_latest_version) to install the latest version of gcloud CLI locally on your computer.
171+
172+
:::note
173+
After completing the gcloud installation, verify that the `gcloud` binary is in your $PATH environment variable.
174+
175+
:::
176+
177+
### Configure local gcloud settings
178+
Run the following command. It generates a link as shown below
179+
180+
```sh
181+
gcloud auth login --no-launch-browser
182+
```
183+
184+
![GCP authenticate login](./static/auth_login.png)
185+
186+
Copy the link and open your chrome browser in incognito mode to perform user sign in.Username is your NYU NetID email address. For e.g. [email protected]
187+
188+
189+
You will be redirected to the NYU SSO page and MFA verification through Duo Push. After successfully logging in, you will be asked to allow google SDK to access your account as shown below
190+
191+
![OAuth consent screen](./static/oauth_consent.png)
192+
193+
Pressing the “Allow” button on this page will present the authorization code. Copy the code and paste it in the terminal. If this step is successful, you should see this text printed to the console. **You are now logged in as [[email protected]].**
194+
195+
### Connect to the workspace
196+
Follow the same instructions for connecting with Google Cloud Shell above, starting from section on setting project and zone above.
197+
198+
## Connecting on Windows 10/11
199+
200+
### Start and Configure SSH-Agent Service
201+
Using an elevated PowerShell window (run as admin), execute the following command to install the SSH-Agent service and configure it to start automatically when you log into your machine:
202+
```ps
203+
Get-Service ssh-agent | Set-Service -StartupType Automatic -PassThru | Start-Service
204+
205+
```
206+
![Run a script in PowerShell](./static/powershell_script.png)
207+
208+
### Install gcloud CLI
209+
Download the [Google Cloud CLI installer] (https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe) and run the installer
210+
211+
![GCloud Installer](./static/gcloud_windows_installer.png)
212+
213+
Alternatively, run the following command to download and install:
214+
```ps
215+
(New-Object Net.WebClient).DownloadFile("https://dl.google.com/dl/cloudsdk/channels/rapid/GoogleCloudSDKInstaller.exe", "$env:Temp\GoogleCloudSDKInstaller.exe")
216+
217+
& $env:Temp\GoogleCloudSDKInstaller.exe
218+
219+
```
220+
221+
### Install Git
222+
Download the Git Bash setup from the official website: https://git-scm.com/ and run the installer
223+
224+
225+
### Install Putty
226+
Download and install Putty from this link https://www.chiark.greenend.org.uk/~sgtatham/putty/latest.html
227+
228+
Post installation verify that the Putty authentication agent is installed and available
229+
230+
For 64-bit installer, you will find this executable at `C:/Program Files/PuTTY/pageant.exe`
231+
232+
233+
### Install Python (>version 3.0)
234+
Install Python from the official website:https://www.python.org/downloads/
235+
236+
Remember to check “Add python to the environment path.” ***add screenshot
237+
238+
Make sure it's installed and available on PATH. On many systems Python comes pre-installed, you can try running the python command to start the Python interpreter to check and see if it is already installed.
239+
240+
![Python in CMD Prompt](./static/cmd_prompt_python.png)
241+
242+
On windows you can also try the py command which is a launcher which is more likely to work. If it is installed you will see a response which will include the version number, for example:
243+
244+
245+
![Py in CMD Prompt](./static/cmd_prompt_py.png)
246+
247+
### Logging in:
248+
Authenticate gcloud by starting a new session of command line or powershell. initialize and login to gcloud with your account (you will be redirected to the browser for authentication)
249+
```ps
250+
gcloud auth login
251+
```
252+
253+
![OAuth on windows](./static/oauth_consent_windows.png)
254+
255+
256+
257+
258+
259+
260+
261+
262+
141 KB
Loading
10.7 KB
Loading
8.31 KB
Loading
19.2 KB
Loading
71.9 KB
Loading
781 KB
Loading
14.3 KB
Loading

0 commit comments

Comments
 (0)