Skip to content

Commit 7aebe17

Browse files
remove version-specific tags from setup chapter
1 parent 38fc193 commit 7aebe17

File tree

1 file changed

+18
-11
lines changed

1 file changed

+18
-11
lines changed

source/setup.Rmd

Lines changed: 18 additions & 11 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
@@ -237,12 +244,12 @@ knitr::include_graphics("img/setup/jlab-2.png")
237244
In this terminal, run the following commands:
238245
```
239246
pip install --upgrade jupyterlab-git
240-
conda env update --file https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-worksheets/main/environment.yml
247+
conda env update --file https://raw.githubusercontent.com/UBC-DSCI/data-science-a-first-intro-worksheets/main/env.yml
241248
```
242249
The second command installs the specific R and package versions specified in
243-
the `environment.yml` file found in
250+
the `env.yml` file found in
244251
[the worksheets repository](https://worksheets.datasciencebook.ca).
245-
We will always keep the versions in the `environment.yml` file updated
252+
We will always keep the versions in the `env.yml` file updated
246253
so that they are compatible with the exercise worksheets that accompany the book.
247254
Once all of the software installation is complete, it is a good idea to restart
248255
JupyterLab Desktop entirely before you proceed to doing your data analysis.

0 commit comments

Comments
 (0)