Skip to content

Commit 9c163f7

Browse files
Merge pull request #525 from UBC-DSCI/remove-tags-setup
Remove version-specific material in setup
2 parents 38fc193 + 5f215a7 commit 9c163f7

File tree

1 file changed

+15
-8
lines changed

1 file changed

+15
-8
lines changed

source/setup.Rmd

Lines changed: 15 additions & 8 deletions
Original file line numberDiff line numberDiff line change
@@ -91,11 +91,16 @@ and follow the instructions on the installation wizard, choosing **WSL-2** inste
9191
9292
**Running JupyterLab** Run Docker Desktop. Once it is running, you need to download and run the
9393
Docker *image* that we have made available for the worksheets (an *image* is like a "snapshot" of a
94-
computer with all the right packages pre-installed). In the search bar, enter `ubcdsci/r-dsci-100`, as this is
95-
the name of the image. You will be presented
96-
with a few options (Figure \@ref(fig:docker-desktop-search)). In the "Tag" drop down menu, click
97-
the tag `20230724142640d8f06f` to select the correct version of the image. Then click
98-
the "Pull" button to download the image.
94+
computer with all the right packages pre-installed). You only need to do this step one time; the image will remain
95+
the next time you run Docker Desktop.
96+
In the Docker Desktop search bar, enter `ubcdsci/r-dsci-100`, as this is
97+
the name of the image. You will see the `ubcdsci/r-dsci-100` image in the list (Figure \@ref(fig:docker-desktop-search)),
98+
and "latest" in the Tag drop down menu. We need to change "latest" to the right image version before proceeding.
99+
To find the right tag, open
100+
the [`Dockerfile` in the worksheets repository](https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-worksheets/main/Dockerfile),
101+
and look for the line `FROM ubcdsci/r-dsci-100:` followed by the tag consisting of a sequence of numbers and letters.
102+
Back in Docker Desktop, in the "Tag" drop down menu, click that tag to select the correct image version. Then click
103+
the "Pull" button to download the image.
99104

100105
```{r docker-desktop-search, echo = FALSE, fig.cap = "The Docker Desktop search window. Make sure to click the Tag drop down menu and find the right version of the image before clicking the Pull button to download it.", fig.retina = 2, out.width="100%"}
101106
image_read("img/setup/docker-1.png") |>
@@ -172,10 +177,12 @@ sudo chmod u+x get-docker.sh
172177
sudo sh get-docker.sh
173178
```
174179

175-
**Running JupyterLab** In the terminal, navigate to the directory where you want to run JupyterLab, and run
176-
the following command.
180+
**Running JupyterLab** First, open the [`Dockerfile` in the worksheets repository](https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-worksheets/main/Dockerfile),
181+
and look for the line `FROM ubcdsci/r-dsci-100:` followed by a tag consisting of a sequence of numbers and letters.
182+
Then in the terminal, navigate to the directory where you want to run JupyterLab, and run
183+
the following command, replacing `TAG` with the *tag* you found earlier.
177184
```
178-
docker run --rm -v $(pwd):/home/jovyan/work -p 8888:8888 ubcdsci/r-dsci-100:20230724142640d8f06f jupyter lab
185+
docker run --rm -v $(pwd):/home/jovyan/work -p 8888:8888 ubcdsci/r-dsci-100:TAG jupyter lab
179186
```
180187
The terminal will then print some text as the Docker container starts. Once the text stops scrolling, find the
181188
URL in your terminal that starts with `http://127.0.0.1:8888` (highlighted by the

0 commit comments

Comments
 (0)