guides: update jupyter guide (#20923)

Signed-off-by: Craig Osterhout <craig.osterhout@docker.com>
This commit is contained in:
Craig Osterhout 2024-10-17 14:50:04 -07:00 committed by GitHub
parent 0eb3a9819c
commit 033acdfab1
No known key found for this signature in database
GPG Key ID: B5690EEEBB952194
1 changed files with 26 additions and 23 deletions

View File

@ -383,39 +383,42 @@ $ docker run --rm -p 8889:8888 YOUR-USER-NAME/my-jupyer-image start-notebook.py
### Share your volume ### Share your volume
This example uses the Docker Desktop [Volumes Backup & Share](https://hub.docker.com/extensions/docker/volumes-backup-extension) extension. Alternatively, in the CLI you can [back up the volume](/engine/storage/volumes/#back-up-a-volume) and then [push it using the ORAS CLI](/manuals/docker-hub/oci-artifacts.md#push-a-volume). This example uses the Docker Desktop graphical user interface. Alternatively, in the command line interface you can [back up the volume](/engine/storage/volumes/#back-up-a-volume) and then [push it using the ORAS CLI](/manuals/docker-hub/oci-artifacts.md#push-a-volume).
1. Install the Volumes Backup & Share extension. 1. Sign in to Docker Desktop.
2. In the Docker Dashboard, select **Volumes**.
1. Open the Docker Dashboard and select **Extensions**. 3. Select the **jupyter-data** volume by selecting the name.
2. Search for `Volumes Backup & Share`. 4. Select the **Exports** tab.
3. In the search results select **Install** for the extension. 5. Select **Quick export**.
6. For **Location**, select **Registry**.
2. Open the **Volumes Backup & Share** extension in the Docker Dashboard. 7. In the text box under **Registry**, specify your Docker ID, a name for the
3. Next to the **jupyter-data** volume, select the **Export volume** icon. volume, and a tag. For example, `YOUR-USERNAME/jupyter-data:latest`.
4. In the **Export content** window, select **Registry**. 8. Select **Save**.
5. In the text box under **Registry**, specify your Docker ID and a name for the 9. Verify that you exported the volume to Docker Hub.
volume. For example, `YOUR-USERNAME/jupyter-data`.
6. Select **Export**.
7. Verify that you exported the volume to Docker Hub.
1. Go to [Docker Hub](https://hub.docker.com). 1. Go to [Docker Hub](https://hub.docker.com).
2. Select **Repositories**. 2. Select **Repositories**.
3. View the **Last pushed** time for your repository. 3. View the **Last pushed** time for your repository.
Other users can now download and import your volume. To import the volume and then run it with your image: Other users can now download and import your volume. To import the volume and then run it with your image:
1. In the Volumes Backup & Share extension, select **Import into new volume**. 1. Sign in to Docker Desktop.
2. In the **Import into a new volume** window, select **Registry**. 2. In the Docker Dashboard, select **Volumes**.
3. In the text box under **Registry**, specify your Docker ID and the repository 3. Select **Create** to create a new volume.
name for the volume. For example, `YOUR-USERNAME/jupyter-data`. 4. Specify a name for the new volume. For this example, use `jupyter-data-2`.
4. In **Volume name**, specify the name you want to give the 5. Select **Create**.
volume. This example uses `jupyter-data` as the name. 6. In the list of volumes, select the **jupyter-data-2** volume by selecting the
5. Select **Import**. name.
6. In a terminal, run `docker run` to run your image with the imported volume. 7. Select **Import**.
8. For **Location**, select **Registry**.
9. In the text box under **Registry**, specify the same name as the repository
that you exported your volume to. For example,
`YOUR-USERNAME/jupyter-data:latest`.
10. Select **Import**.
11. In a terminal, run `docker run` to run your image with the imported volume.
Replace `YOUR-USER-NAME` with your Docker ID. Replace `YOUR-USER-NAME` with your Docker ID.
```console ```console
$ docker run --rm -p 8889:8888 -v jupyter-data:/home/jovyan/work YOUR-USER-NAME/my-jupyter-image start-notebook.py --NotebookApp.token='my-token' $ docker run --rm -p 8889:8888 -v jupyter-data-2:/home/jovyan/work YOUR-USER-NAME/my-jupyter-image start-notebook.py --NotebookApp.token='my-token'
``` ```
## Summary ## Summary