client

package
v1.4.2-0...-949f8d0 Latest Latest
Warning

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

 Go to latest Published: Jun 9, 2016 License: Apache-2.0 Imports: 67 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

func AddTrustedFlags 

func AddTrustedFlags(fs *pflag.FlagSet, verify bool)

AddTrustedFlags adds the trust flags to a FlagSet

func CopyToFile 

func CopyToFile(outfile string, r io.Reader) error

CopyToFile writes the content of the reader to the specified file

func EncodeAuthToBase64 

func EncodeAuthToBase64(authConfig types.AuthConfig) (string, error)

EncodeAuthToBase64 serializes the auth configuration as JSON base64 payload

func IsTrusted 

func IsTrusted() bool

IsTrusted returns true if content trust is enabled

func LoadDefaultConfigFile 

func LoadDefaultConfigFile(err io.Writer) *configfile.ConfigFile

LoadDefaultConfigFile attempts to load the default config file and returns an initialized ConfigFile struct if none is found.

func NewAPIClientFromFlags 

func NewAPIClientFromFlags(clientFlags *cliflags.ClientFlags, configFile *configfile.ConfigFile) (client.APIClient, error)

NewAPIClientFromFlags creates a new APIClient from command line flags

func ParseExec 

func ParseExec(cmd *flag.FlagSet, args []string) (*types.ExecConfig, error)

ParseExec parses the specified args for the specified command and generates an ExecConfig from it. If the minimal number of specified args is not right or if specified args are not valid, it will return an error.

Types

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 *cliflags.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 

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) Client 

func (cli *DockerCli) Client() client.APIClient

Client returns the APIClient

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 DEST_PATH is '-' the data is written as a tar archive file to STDOUT.

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

Usage: 

docker cp CONTAINER:SRC_PATH DEST_PATH|-
docker cp SRC_PATH|- CONTAINER:DEST_PATH

func (*DockerCli) CmdExec 

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

CmdExec runs a command in a running container.

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

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) 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 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 

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) 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) 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) CmdUpdate 

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

CmdUpdate updates resources of one or more containers.

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

func (*DockerCli) Command 

func (cli *DockerCli) Command(name string) func(...string) error

Command returns a cli command handler if one exists

func (*DockerCli) ConfigFile 

func (cli *DockerCli) ConfigFile() *configfile.ConfigFile

ConfigFile returns the ConfigFile

func (*DockerCli) Err 

func (cli *DockerCli) Err() io.Writer

Err returns the writer used for stderr

func (*DockerCli) ForwardAllSignals 

func (cli *DockerCli) ForwardAllSignals(ctx context.Context, cid string) chan os.Signal

ForwardAllSignals forwards signals to the container TODO: this can be unexported again once all container commands are under api/client/container

func (*DockerCli) GetExitCode 

func (cli *DockerCli) GetExitCode(ctx context.Context, containerID string) (bool, int, error)

GetExitCode perform an inspect on the container. It returns the running state and the exit code.

func (*DockerCli) GetTtySize 

func (cli *DockerCli) GetTtySize() (int, int)

GetTtySize returns the height and width in characters of the tty

func (*DockerCli) HoldHijackedConnection 

func (cli *DockerCli) HoldHijackedConnection(ctx context.Context, tty bool, inputStream io.ReadCloser, outputStream, errorStream io.Writer, resp types.HijackedResponse) error

HoldHijackedConnection handles copying input to and output from streams to the connection

func (*DockerCli) ImagesFormat 

func (cli *DockerCli) ImagesFormat() string

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

func (*DockerCli) In 

func (cli *DockerCli) In() io.ReadCloser

In returns the reader used for stdin

func (*DockerCli) Initialize 

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) IsTerminalOut 

func (cli *DockerCli) IsTerminalOut() bool

IsTerminalOut returns true if the clients stdin is a TTY

func (*DockerCli) MonitorTtySize 

func (cli *DockerCli) MonitorTtySize(ctx context.Context, id string, isExec bool) error

MonitorTtySize updates the container tty size when the terminal tty changes size

func (*DockerCli) Out 

func (cli *DockerCli) Out() io.Writer

Out returns the writer used for stdout

func (*DockerCli) OutFd 

func (cli *DockerCli) OutFd() uintptr

OutFd returns the fd for the stdout stream

func (*DockerCli) PsFormat 

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}}.

func (*DockerCli) RegistryAuthenticationPrivilegedFunc 

func (cli *DockerCli) RegistryAuthenticationPrivilegedFunc(index *registrytypes.IndexInfo, cmdName string) types.RequestPrivilegeFunc

RegistryAuthenticationPrivilegedFunc return a RequestPrivilegeFunc from the specified registry index info for the given command.

func (*DockerCli) ResizeTtyTo 

func (cli *DockerCli) ResizeTtyTo(ctx context.Context, id string, height, width int, isExec bool)

ResizeTtyTo resizes tty to specific height and width TODO: this can be unexported again once all container related commands move to package container

func (*DockerCli) ResolveAuthConfig 

func (cli *DockerCli) ResolveAuthConfig(ctx context.Context, index *registrytypes.IndexInfo) types.AuthConfig

ResolveAuthConfig is like registry.ResolveAuthConfig, but if using the default index, it uses the default index name for the daemon's platform, not the client's platform.

func (*DockerCli) RetrieveAuthConfigs 

func (cli *DockerCli) RetrieveAuthConfigs() map[string]types.AuthConfig

RetrieveAuthConfigs return all credentials.

func (*DockerCli) TagTrusted 

func (cli *DockerCli) TagTrusted(ctx context.Context, trustedRef reference.Canonical, ref reference.NamedTagged) error

TagTrusted tags a trusted ref

func (*DockerCli) TrustedReference 

func (cli *DockerCli) TrustedReference(ctx context.Context, ref reference.NamedTagged) (reference.Canonical, error)

TrustedReference returns the canonical trusted reference for an image reference

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.