Call the docker commandline tool
call_docker(cmd = "", ..., echo = getOption("azure_containers_tool_echo", TRUE))
cmd: The docker command. This should be a vector of individual docker arguments, but can also be a single commandline string. See below....: Other arguments to pass to processx::run .echo: Whether to echo the output of the command to the console.A list with the following components:
status: The exit status of the docker tool. If this is NA, then the process was killed and had no exit status.stdout: The standard output of the command, in a character scalar.stderr: The standard error of the command, in a character scalar.timeout: Whether the process was killed because of a timeout.cmdline: The command line.The first four components are from processx::run; AzureContainers adds the last to make it easier to construct scripts that can be run outside R.
This function calls the docker binary, which must be located in your search path. AzureContainers will search for the binary at package startup, and print a warning if it is not found.
The docker command should be specified as a vector of the individual arguments, which is what processx::run expects. If a single string is passed, for convenience and back-compatibility reasons call_docker will split it into arguments for you. This is prone to error, for example if you are working with pathnames that contain spaces, so it's strongly recommended to pass a vector of arguments as a general practice.
## Not run: # without any args, prints the docker help screen call_docker() # build an image: recommended usage call_docker(c("build", "-t", "myimage", ".")) # alternative usage, will be split into individual arguments call_docker("build -t myimage .") # list running containers call_docker(c("container", "ls")) # prune unused containers and images call_docker(c("container", "prune", "-f")) call_docker(c("image", "prune", "-f")) ## End(Not run)
processx::run , call_docker_compose , call_kubectl for the equivalent interface to the kubectl Kubernetes tool
docker_registry