client

package
v1.9.0-rc2 Latest Latest
Warning

This package is not in the latest version of its module.

 Go to latest Published: Oct 22, 2015 License: Apache-2.0 Imports: 74 Imported by: 0

Documentation

Overview

Package client provides a command-line interface for Docker.

Run "docker help SUBCOMMAND" or "docker SUBCOMMAND --help" to see more information on any Docker subcommand, including the full list of options supported for the subcommand. See https://docs.docker.com/installation/ for instructions on installing Docker.

Index

Constants

This section is empty.

Variables

This section is empty.

Functions

This section is empty.

Types

type ByStars added in v1.7.0 

type ByStars []registry.SearchResult

ByStars sorts search results in ascending order by number of stars.

func (ByStars) Len added in v1.7.0 

func (r ByStars) Len() int

func (ByStars) Less added in v1.7.0 

func (r ByStars) Less(i, j int) bool

func (ByStars) Swap added in v1.7.0 

func (r ByStars) Swap(i, j int)

type DockerCli 

type DockerCli struct {
	// contains filtered or unexported fields
}

DockerCli represents the docker command line client. Instances of the client can be returned from NewDockerCli.

func NewDockerCli 

func NewDockerCli(in io.ReadCloser, out, err io.Writer, clientFlags *cli.ClientFlags) *DockerCli

NewDockerCli returns a DockerCli instance with IO output and error streams set by in, out and err. The key file, protocol (i.e. unix) and address are passed in as strings, along with the tls.Config. If the tls.Config is set the client scheme will be set to https. The client will be given a 32-second timeout (see https://github.com/docker/docker/pull/8035).

func (*DockerCli) CheckTtyInput added in v1.4.0 

func (cli *DockerCli) CheckTtyInput(attachStdin, ttyMode bool) error

CheckTtyInput checks if we are trying to attach to a container tty from a non-tty client input stream, and if so, returns an error.

func (*DockerCli) CmdAttach 

func (cli *DockerCli) CmdAttach(args ...string) error

CmdAttach attaches to a running container.

Usage: docker attach [OPTIONS] CONTAINER

func (*DockerCli) CmdBuild 

func (cli *DockerCli) CmdBuild(args ...string) error

CmdBuild builds a new image from the source code at a given path.

If '-' is provided instead of a path or URL, Docker will build an image from either a Dockerfile or tar archive read from STDIN.

Usage: docker build [OPTIONS] PATH | URL | -

func (*DockerCli) CmdCommit 

func (cli *DockerCli) CmdCommit(args ...string) error

CmdCommit creates a new image from a container's changes.

Usage: docker commit [OPTIONS] CONTAINER [REPOSITORY[:TAG]]

func (*DockerCli) CmdCp 

func (cli *DockerCli) CmdCp(args ...string) error

CmdCp copies files/folders to or from a path in a container.

When copying from a container, if LOCALPATH is '-' the data is written as a tar archive file to STDOUT.

When copying to a container, if LOCALPATH is '-' the data is read as a tar archive file from STDIN, and the destination CONTAINER:PATH, must specify a directory.

Usage: 

docker cp CONTAINER:PATH LOCALPATH|-
docker cp LOCALPATH|- CONTAINER:PATH

func (*DockerCli) CmdCreate added in v1.3.0 

func (cli *DockerCli) CmdCreate(args ...string) error

CmdCreate creates a new container from a given image.

Usage: docker create [OPTIONS] IMAGE [COMMAND] [ARG...]

func (*DockerCli) CmdDiff 

func (cli *DockerCli) CmdDiff(args ...string) error

CmdDiff shows changes on a container's filesystem.

Each changed file is printed on a separate line, prefixed with a single character that indicates the status of the file: C (modified), A (added), or D (deleted).

Usage: docker diff CONTAINER

func (*DockerCli) CmdEvents 

func (cli *DockerCli) CmdEvents(args ...string) error

CmdEvents prints a live stream of real time events from the server.

Usage: docker events [OPTIONS]

func (*DockerCli) CmdExec added in v1.3.0 

func (cli *DockerCli) CmdExec(args ...string) error

CmdExec runs a command in a running container.

Usage: docker exec [OPTIONS] CONTAINER COMMAND [ARG...]

func (*DockerCli) CmdExport 

func (cli *DockerCli) CmdExport(args ...string) error

CmdExport exports a filesystem as a tar archive.

The tar archive is streamed to STDOUT by default or written to a file.

Usage: docker export [OPTIONS] CONTAINER

func (*DockerCli) CmdHistory 

func (cli *DockerCli) CmdHistory(args ...string) error

CmdHistory shows the history of an image.

Usage: docker history [OPTIONS] IMAGE

func (*DockerCli) CmdImages 

func (cli *DockerCli) CmdImages(args ...string) error

CmdImages lists the images in a specified repository, or all top-level images if no repository is specified.

Usage: docker images [OPTIONS] [REPOSITORY]

func (*DockerCli) CmdImport 

func (cli *DockerCli) CmdImport(args ...string) error

CmdImport creates an empty filesystem image, imports the contents of the tarball into the image, and optionally tags the image.

The URL argument is the address of a tarball (.tar, .tar.gz, .tgz, .bzip, .tar.xz, .txz) file or a path to local file relative to docker client. If the URL is '-', then the tar file is read from STDIN.

Usage: docker import [OPTIONS] file|URL|- [REPOSITORY[:TAG]]

func (*DockerCli) CmdInfo 

func (cli *DockerCli) CmdInfo(args ...string) error

CmdInfo displays system-wide information.

Usage: docker info

func (*DockerCli) CmdInspect 

func (cli *DockerCli) CmdInspect(args ...string) error

CmdInspect displays low-level information on one or more containers or images.

Usage: docker inspect [OPTIONS] CONTAINER|IMAGE [CONTAINER|IMAGE...]

func (*DockerCli) CmdKill 

func (cli *DockerCli) CmdKill(args ...string) error

CmdKill kills one or more running container using SIGKILL or a specified signal.

Usage: docker kill [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdLoad 

func (cli *DockerCli) CmdLoad(args ...string) error

CmdLoad loads an image from a tar archive.

The tar archive is read from STDIN by default, or from a tar archive file.

Usage: docker load [OPTIONS]

func (*DockerCli) CmdLogin 

func (cli *DockerCli) CmdLogin(args ...string) error

CmdLogin logs in or registers a user to a Docker registry service.

If no server is specified, the user will be logged into or registered to the registry's index server.

Usage: docker login SERVER

func (*DockerCli) CmdLogout added in v1.2.0 

func (cli *DockerCli) CmdLogout(args ...string) error

CmdLogout logs a user out from a Docker registry.

If no server is specified, the user will be logged out from the registry's index server.

Usage: docker logout [SERVER]

func (*DockerCli) CmdLogs 

func (cli *DockerCli) CmdLogs(args ...string) error

CmdLogs fetches the logs of a given container.

docker logs [OPTIONS] CONTAINER

func (*DockerCli) CmdNetwork 

func (cli *DockerCli) CmdNetwork(args ...string) error

CmdNetwork is the parent subcommand for all network commands

Usage: docker network <COMMAND> [OPTIONS]

func (*DockerCli) CmdNetworkConnect 

func (cli *DockerCli) CmdNetworkConnect(args ...string) error

CmdNetworkConnect connects a container to a network

Usage: docker network connect <NETWORK> <CONTAINER>

func (*DockerCli) CmdNetworkCreate 

func (cli *DockerCli) CmdNetworkCreate(args ...string) error

CmdNetworkCreate creates a new network with a given name

Usage: docker network create [OPTIONS] <NETWORK-NAME>

func (*DockerCli) CmdNetworkDisconnect 

func (cli *DockerCli) CmdNetworkDisconnect(args ...string) error

CmdNetworkDisconnect disconnects a container from a network

Usage: docker network disconnect <NETWORK> <CONTAINER>

func (*DockerCli) CmdNetworkInspect 

func (cli *DockerCli) CmdNetworkInspect(args ...string) error

CmdNetworkInspect inspects the network object for more details

Usage: docker network inspect <NETWORK> [<NETWORK>] CmdNetworkInspect handles Network inspect UI

func (*DockerCli) CmdNetworkLs 

func (cli *DockerCli) CmdNetworkLs(args ...string) error

CmdNetworkLs lists all the netorks managed by docker daemon

Usage: docker network ls [OPTIONS]

func (*DockerCli) CmdNetworkRm 

func (cli *DockerCli) CmdNetworkRm(args ...string) error

CmdNetworkRm deletes a network

Usage: docker network rm <NETWORK-NAME | NETWORK-ID>

func (*DockerCli) CmdPause added in v0.12.0 

func (cli *DockerCli) CmdPause(args ...string) error

CmdPause pauses all processes within one or more containers.

Usage: docker pause CONTAINER [CONTAINER...]

func (*DockerCli) CmdPort 

func (cli *DockerCli) CmdPort(args ...string) error

CmdPort lists port mappings for a container. If a private port is specified, it also shows the public-facing port that is NATed to the private port.

Usage: docker port CONTAINER [PRIVATE_PORT[/PROTO]]

func (*DockerCli) CmdPs 

func (cli *DockerCli) CmdPs(args ...string) error

CmdPs outputs a list of Docker containers.

Usage: docker ps [OPTIONS]

func (*DockerCli) CmdPull 

func (cli *DockerCli) CmdPull(args ...string) error

CmdPull pulls an image or a repository from the registry.

Usage: docker pull [OPTIONS] IMAGENAME[:TAG|@DIGEST]

func (*DockerCli) CmdPush 

func (cli *DockerCli) CmdPush(args ...string) error

CmdPush pushes an image or repository to the registry.

Usage: docker push NAME[:TAG]

func (*DockerCli) CmdRename added in v1.5.0 

func (cli *DockerCli) CmdRename(args ...string) error

CmdRename renames a container.

Usage: docker rename OLD_NAME NEW_NAME

func (*DockerCli) CmdRestart 

func (cli *DockerCli) CmdRestart(args ...string) error

CmdRestart restarts one or more containers.

Usage: docker restart [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdRm 

func (cli *DockerCli) CmdRm(args ...string) error

CmdRm removes one or more containers.

Usage: docker rm [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdRmi 

func (cli *DockerCli) CmdRmi(args ...string) error

CmdRmi removes all images with the specified name(s).

Usage: docker rmi [OPTIONS] IMAGE [IMAGE...]

func (*DockerCli) CmdRun 

func (cli *DockerCli) CmdRun(args ...string) error

CmdRun runs a command in a new container.

Usage: docker run [OPTIONS] IMAGE [COMMAND] [ARG...]

func (*DockerCli) CmdSave 

func (cli *DockerCli) CmdSave(args ...string) error

CmdSave saves one or more images to a tar archive.

The tar archive is written to STDOUT by default, or written to a file.

Usage: docker save [OPTIONS] IMAGE [IMAGE...]

func (*DockerCli) CmdSearch 

func (cli *DockerCli) CmdSearch(args ...string) error

CmdSearch searches the Docker Hub for images.

Usage: docker search [OPTIONS] TERM

func (*DockerCli) CmdStart 

func (cli *DockerCli) CmdStart(args ...string) error

CmdStart starts one or more containers.

Usage: docker start [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdStats added in v1.5.0 

func (cli *DockerCli) CmdStats(args ...string) error

CmdStats displays a live stream of resource usage statistics for one or more containers.

This shows real-time information on CPU usage, memory usage, and network I/O.

Usage: docker stats CONTAINER [CONTAINER...]

func (*DockerCli) CmdStop 

func (cli *DockerCli) CmdStop(args ...string) error

CmdStop stops one or more containers.

A running container is stopped by first sending SIGTERM and then SIGKILL if the container fails to stop within a grace period (the default is 10 seconds).

Usage: docker stop [OPTIONS] CONTAINER [CONTAINER...]

func (*DockerCli) CmdTag 

func (cli *DockerCli) CmdTag(args ...string) error

CmdTag tags an image into a repository.

Usage: docker tag [OPTIONS] IMAGE[:TAG] [REGISTRYHOST/][USERNAME/]NAME[:TAG]

func (*DockerCli) CmdTop 

func (cli *DockerCli) CmdTop(args ...string) error

CmdTop displays the running processes of a container.

Usage: docker top CONTAINER

func (*DockerCli) CmdUnpause added in v0.12.0 

func (cli *DockerCli) CmdUnpause(args ...string) error

CmdUnpause unpauses all processes within a container, for one or more containers.

Usage: docker unpause CONTAINER [CONTAINER...]

func (*DockerCli) CmdVersion 

func (cli *DockerCli) CmdVersion(args ...string) (err error)

CmdVersion shows Docker version information.

Available version information is shown for: client Docker version, client API version, client Go version, client Git commit, client OS/Arch, server Docker version, server API version, server Go version, server Git commit, and server OS/Arch.

Usage: docker version

func (*DockerCli) CmdVolume 

func (cli *DockerCli) CmdVolume(args ...string) error

CmdVolume is the parent subcommand for all volume commands

Usage: docker volume <COMMAND> <OPTS>

func (*DockerCli) CmdVolumeCreate 

func (cli *DockerCli) CmdVolumeCreate(args ...string) error

CmdVolumeCreate creates a new container from a given image.

Usage: docker volume create [OPTIONS]

func (*DockerCli) CmdVolumeInspect 

func (cli *DockerCli) CmdVolumeInspect(args ...string) error

CmdVolumeInspect displays low-level information on one or more volumes.

Usage: docker volume inspect [OPTIONS] VOLUME [VOLUME...]

func (*DockerCli) CmdVolumeLs 

func (cli *DockerCli) CmdVolumeLs(args ...string) error

CmdVolumeLs outputs a list of Docker volumes.

Usage: docker volume ls [OPTIONS]

func (*DockerCli) CmdVolumeRm 

func (cli *DockerCli) CmdVolumeRm(args ...string) error

CmdVolumeRm removes one or more containers.

Usage: docker volume rm VOLUME [VOLUME...]

func (*DockerCli) CmdWait 

func (cli *DockerCli) CmdWait(args ...string) error

CmdWait blocks until a container stops, then prints its exit code.

If more than one container is specified, this will wait synchronously on each container.

Usage: docker wait CONTAINER [CONTAINER...]

func (*DockerCli) HTTPClient added in v0.11.0 

func (cli *DockerCli) HTTPClient() *http.Client

HTTPClient creates a new HTTP client with the cli's client transport instance.

func (*DockerCli) Initialize added in v1.8.0 

func (cli *DockerCli) Initialize() error

Initialize calls the init function that will setup the configuration for the client such as the TLS, tcp and other parameters used to run the client.

func (*DockerCli) PsFormat added in v1.8.0 

func (cli *DockerCli) PsFormat() string

PsFormat returns the format string specified in the configuration. String contains columns and format specification, for example {{ID}\t{{Name}}.

Source Files

View all Source files

Directories

Path Synopsis

Jump to

Keyboard shortcuts

? : This menu
/ : Search site
f or F : Jump to
y or Y : Canonical URL
go.dev uses cookies from Google to deliver and enhance the quality of its services and to analyze traffic. Learn more.