stevedore (version 0.9.6)

docker_available: Test if docker available

Description

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.

Examples

Run this code
# Is docker available on your system?
stevedore::docker_available()

Run the code above in your browser using DataLab