Test if we can construct a docker client and confirm that we can
communicate with it. This is intended to help in debug connection
issues, and also for use in tests. For example, you might
implement a testthat skip test that skips if
stevedore::docker_available() returns FALSE to
conditionally use stevedore/docker within tests.
Usage
docker_available(..., verbose = FALSE)
Value
Logical scalar, TRUE if
docker_client(...) would succeed.
Arguments
...
Passed through to docker_client (e.g.,
api_version, host).
verbose
Logical, indicating if information should be
printed about failures to connect. If FALSE (the
default) the function runs silently.
Details
Reasons for failure to connect might include:
You do not have a docker daemon running
You have docker installed but the socket in a non-standard
place and have not adjusted environment variables accordingly
You do not have permission to write to the docker socket
You are on windows and the required python packages to get
everything working there are not present or configured correctly
There are problems arranging verification over https/tls.
If versose is TRUE then some diagnostic information
will be printed.