Skip to content

Commit 4e6b1b9

Browse files
authored
Fix grammar and clarity in tunneling.md
Corrected minor grammatical errors and improved clarity in the ssh tunnels documentation.
1 parent c2e37cb commit 4e6b1b9

File tree

1 file changed

+18
-3
lines changed

1 file changed

+18
-3
lines changed

bash/tunneling.md

Lines changed: 18 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -3,23 +3,38 @@
33

44
# ssh tunnels
55

6-
`ssh` tunnels enable us to log in to remote machines and even run `jupyter lab` by means of port forwarding.
6+
7+
`ssh` tunnels enable us to log in to remote machines and run `jupyter lab` by means of port forwarding.
78
[This lab](https://github.com/cloudbank-project/az-serverless-tutorial/blob/main/content/workstation/_index.md)
89
walks through setting up **VS Code Server** in this manner. My notes are below under the heading
910
[Using VSCode Server](#Using-VSCode-Server].
1011

12+
1113
## Overview
1214

1315

1416
This page describes `ssh` tunnel use through the specific application of using a cloud virtual machine
15-
as a working Jupyter environment.
17+
as a working Jupyter environment. These instructions were written using an Azure VM (hence the
18+
Username is `azureuser`) but they apply equally to other cloud platforms / remote VMs. On AWS the
19+
Ubuntu default username would be `ubuntu` rather than `azureuser`.
1620

1721

1822
Suppose I want to run a Jupyter notebook server on a cloud Virtual Machine. I will view and interact with this
1923
from my laptop web browser. I can select a VM with a desired level of compute power. I can run the
2024
`jupyter` notebook server on an internet-facing VM (less secure) or on a cloud-internal VM (more secure).
2125
This approach is simpler than building a "Littlest Jupyter Hub" which in turn is much simpler than building
22-
a full-scale Jupyter Hub.
26+
a full-scale Jupyter Hub. Let's review these three options briefly, with build times being "YMMV".
27+
28+
29+
- Full-scale Jupyter Hub: Provides Jupyter Lab Server for hundreds, even thousands of individuals
30+
- Build time: Days to learn and build a first time; with necessary ongoing care and feeding
31+
- Littlest Jupyter hub: Jupyter Lab Server for two up to 12 people
32+
- Build time: Set up in half a day; plan on occasional updating
33+
- Jupyter Lab Server on a VM: For one person
34+
- Build time: Up and running in an hour; update whenever
35+
36+
37+
In all cases each User should take advantage of independent software versioning such as GitHub.
2338

2439

2540
One way to proceed is to employ the `ssh` protocol to create a secure tunnel between machines. We consider

0 commit comments

Comments
 (0)