Skip to content

Commit fe670a1

Browse files
committed
Modify module 1 exercise steps
Start with JH login. Move auth step to just-in-time.
1 parent 3672696 commit fe670a1

File tree

1 file changed

+46
-28
lines changed

1 file changed

+46
-28
lines changed

modules/01-collaborating-in-jupyterhub.md

Lines changed: 46 additions & 28 deletions
Original file line numberDiff line numberDiff line change
@@ -7,7 +7,7 @@ title: "Module 1: Collaborating in JupyterHub"
77

88
* Jupyter is much more than Notebooks
99
* Interact with geospatial data in JupyterLab
10-
* Interact with GitHub
10+
* Save our work to GitHub
1111
:::
1212

1313

@@ -22,7 +22,22 @@ title: "Module 1: Collaborating in JupyterHub"
2222

2323
## 💪 Exercise
2424

25-
### Step 0: Create and clone a new repository for this workshop's exercises
25+
### Step 0: Log in to the JupyterHub
26+
27+
1. Visit <https://hub.cryointhecloud.com>.
28+
You may want to bookmark this page!
29+
1. **Select the last option, "Bring your own image"**.
30+
* Copy/paste `ghcr.io/geojupyter/geojupyter:latest` into the "custom image" field.
31+
* Leave "Resource Allocation" as default (1.9GB RAM).
32+
1. **Click "Start"**!
33+
* It may take a moment for the server to start.
34+
When it's done, **place a green sticky on the corner of your laptop screen** so
35+
instructors know you're ready!
36+
* If startup takes longer than a couple of minutes, put up a red sticky and we'll
37+
take a look!
38+
39+
40+
### Step 1: Create and clone a new repository for this workshop's exercises
2641

2742
1. Create a new repository in GitHub from our
2843
[workshop template repository](https://github.com/geojupyter/workshop-csdms2025-template).
@@ -32,11 +47,11 @@ title: "Module 1: Collaborating in JupyterHub"
3247
repository".
3348
:::
3449

35-
1. Leave all the settings as default: your username should be the "owner", and the repo
36-
should be public. Set the "Repository name" to `workshop-csdms2025-exercises` -- this
37-
will make it easier for us to find it!
50+
1. Leave most of the settings as default: your username should be the "owner", and the
51+
repo should be public. **Set the "Repository name" to
52+
`workshop-csdms2025-exercises`** -- this will make it easier for us to find it!
3853

39-
1. In JupyterHub, clone the new repository you just created from the template.
54+
1. **In JupyterHub**, clone the new repository you just created from the template.
4055
We'll be working here from now on! **Run the command below, replacing `MY-USERNAME`
4156
with your GitHub account username**.
4257

@@ -45,7 +60,30 @@ title: "Module 1: Collaborating in JupyterHub"
4560
```
4661

4762

48-
### Step 1: Set up GitHub authentication in JupyterHub (WIP)
63+
### Step 2: Explore the example data
64+
65+
1. Navigate to the newly cloned repository in the JupyterLab file browser on the left
66+
panel.
67+
If the left panel isn't open, click the topmost icon in the far left column.
68+
1. Navigate to the `exercises/module-1` directory.
69+
1. Double-click the GeoJSON file `seec.json` to view it with the JupyterLab viewer.
70+
71+
72+
### Step 3: Open our example Notebook and create some new data (WIP)
73+
74+
1. Open `example-1.ipynb` by double-clicking it in the file browser in the left panel.
75+
1. This notebook is pre-populated with some code.
76+
**Run all the cells** by pressing `SHIFT+ENTER` repeatedly until you reach the end.
77+
1. Add a new cell which adds more data into the GeoDataFrame (_TODO_: Prompt and empty
78+
space in notebook).
79+
Start with the address of a location that is meaningful to you:
80+
Your favorite coffee shop?
81+
The shelter where you adopted your pet?
82+
The town where you grew up?
83+
1. Add another new cell which saves the GeoDataFrame with a new filename.
84+
85+
86+
### Step 4: Set up GitHub authentication in JupyterHub (WIP)
4987
5088
In order to push changes from the JupyterHub, you need credentials.
5189
Since the JupyterHub is a shared cloud service, saving credentials there can be
@@ -61,27 +99,7 @@ This configuration is valid for 8 hours.
6199
If you need to refresh your access, please re-do the final step in the list above.
62100
63101
64-
### Step 2: Explore the example data (WIP)
65-
66-
1. Navigate to the newly cloned repository in the JupyterLab file browser.
67-
1. Enter the `exercises/module-1` directory.
68-
1. Double-click the GeoJSON file to view it with the JupyterLab viewer.
69-
70-
71-
### Step 3: Open our example Notebook and create some new data (WIP)
72-
73-
This Notebook is pre-populated with some code.
74-
75-
1. Run all the cells (_TODO: Details_).
76-
1. Add a new cell which adds more data into the GeoDataFrame.
77-
Start with the address of a location that is meaningful to you:
78-
Your favorite coffee shop?
79-
The shelter where you adopted your pet?
80-
The town where you grew up?
81-
1. Add another new cell which saves the GeoDataFrame with a new filename.
82-
83-
84-
### Step 4: Push to GitHub (WIP)
102+
### Step 5: Push to GitHub (WIP)
85103
86104
1. `git add .`
87105
1. `git commit --message="Add new data to GeoJSON"`

0 commit comments

Comments
 (0)