Run a command in a new container on a host.

docker_run(host = localhost, image = NULL, cmd = NULL, name = NULL,
  rm = FALSE, detach = FALSE, docker_opts = NULL, ...)

Arguments

host

An object representing the host where the container will be run.

image

The name or ID of a docker image.

cmd

A command to run in the container.

name

A name for the container. If none is provided, a random name will be used.

rm

If TRUE, remove the container after it finishes. This is incompatible with detach=TRUE.

detach

If TRUE, run the container in the background.

docker_opts

Options to docker. These are things that come before the docker command, when run on the command line.

...

Other arguments passed to the SSH command for the host

Value

A container object. When rm=TRUE, this function returns NULL instead of a container object, because the container no longer exists.

Examples

# NOT RUN {
docker_run(localhost, "debian:testing", "echo foo")
#> foo

# Arguments will be concatenated
docker_run(localhost, "debian:testing", c("echo foo", "bar"))
#> foo bar

docker_run(localhost, "rocker/r-base", c("Rscript", "-e", "1+1"))
#> [1] 2
# }