Unhelpful, incorrect error message when docker commands fail

[cole-christensen]

• No setup instructions provided for getting started on Linux/Mac/Windows
• The message says Docker CLI tools aren't installed when they clearly are
• docker-kitchen isn't correctly detecting and using the installed docker

Coles-MBP-2:chef_repository chaos$ docker --version
Docker version 1.12.0-rc4, build e4a0dbc, experimental

Here I show that I have docker installed correctly, having started an nginx container on the command line, but kitchen still fails

Coles-MBP-2:~ chaos$ docker ps
CONTAINER ID        IMAGE               COMMAND                  CREATED             STATUS              PORTS               NAMES
5921d3d77fb2        nginx               "nginx -g 'daemon off"   27 seconds ago      Up 27 seconds       80/tcp, 443/tcp     determined_mestorf
Coles-MBP-2:chef_repository chaos$ kitchen list
>>>>>> ------Exception-------
>>>>>> Class: Kitchen::UserError
>>>>>> Message: You must first install the Docker CLI tool http://www.docker.io/gettingstarted/
>>>>>> ----------------------
>>>>>> Please see .kitchen/logs/kitchen.log for more details
>>>>>> Also try running `kitchen diagnose --all` for configuration

[claudio-viola]

Are you on Mac? Try running from the docker quickstart terminal
Or try this configuration
driver:
name: docker
use_sudo: false

[cole-christensen]

The issue I am reporting is specifically that the error message is bad. I'm not asking for what to do to make the message go away, I'm reporting that the message is incorrect (I had indeed installed docker from that URL) and that the actual error was not detected or reported correctly.

[PhearZero]

👍

[cpoole]

I see this error randomly during periods of high container churn on our test box. (testing roughly 30 containers at the same time).

one or two times out of thirty will I see this message on kitchen converge

[kitforbes]

I just tried to start using Test Kitchen with Docker For Windows and found it tricky to get started. I encountered this same error, which was misleading. The Readme (or the repo) should probably include a working example for using Test Kitchen on Windows with this driver. Or, as a bare minimum, update the Readme to mention that you must set use_sudo: false when running on Windows.

[StuporHero]

This needs to be corrected so that the gem knows not to use sudo on Windows without adding the flag as this breaks CI workflows that don't take place on Windows.

[nergdron]

just ran into this myself getting started with kitchen. docker is usable by regular users on all supported platforms, so I feel like this flag should default to false, not true.

[nergdron]

just ran into this myself getting started with kitchen. docker is usually usable by regular users on all supported platforms, so I feel like this flag should default to false, not true.