Garden-AI / garden

https://garden-ai.readthedocs.io
MIT License
17 stars 4 forks source link

Unclear error `DockerException: No such file or directory` #376

Closed ascourtas closed 7 months ago

ascourtas commented 8 months ago

As a Publisher, I want to be able to easily follow the publishing tutorial and publish an Entrypoint in a Garden. If there is an error, I want to immediately know what I need to do to fix it

When running the command garden-ai notebook start tutorial_notebook.ipynb --base-image=3.10-sklearn, as specified in the Tutorial, if I do not have the Docker daemon already running, I get the following error, preceded by a very long stack trace:

DockerException: Error while fetching server API version: ('Connection aborted.', FileNotFoundError(2, 'No such file or directory'))

This made me consider whether or not I had run the commands in the right folder (?), but discussion with Owen revealed that the issue is that the Docker daemon isn't running.

Add error handling to create a more informative message to the user, such that they immediately know to start their Docker daemon. Ensure the documentation reflects this.

Tasks

Assumptions:

  1. Docker is necessary for this tutorial

Acceptance Criteria

  1. The solution does not mask any other Docker errors thrown -- it is specific to the case where the daemon is not running
  2. As a User, I immediately know what went wrong and how to fix it.
  3. As a User, there is nothing else (logging in, etc) I need to do that I wasn't already informed of