The Docker CLI
Go to file
Sebastiaan van Stijn 3b7235edca
cli/command: initialize client and load content lazily
This allows commands that don't require a client connection (such as `context use`)
to be functional, but still produces an error when trying to run a command that
needs to connect with the API;

    mkdir -p ~/.docker/ && echo '{"currentContext":"nosuchcontext"}' >  ~/.docker/config.json
    docker version
    Failed to initialize: unable to resolve docker endpoint: load context "nosuchcontext": context does not exist: open /root/.docker/contexts/meta/8bfef2a74c7d06add4bf4c73b0af97d9f79c76fe151ae0e18b9d7e57104c149b/meta.json: no such file or directory

    docker context use default
    default
    Current context is now "default"

    docker version
    Client:
     Version:           22.06.0-dev
     API version:       1.42
     ...

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2022-11-28 16:52:02 +01:00
.circleci dummy circleci config 2022-02-25 21:15:39 +01:00
.github Update to Go 1.19.3 to address CVE-2022-41716 2022-11-05 17:39:57 +01:00
cli cli/command: initialize client and load content lazily 2022-11-28 16:52:02 +01:00
cli-plugins cli-plugins/manager: TestPluginError: don't use yaml.Marshal 2022-11-17 13:17:51 +01:00
cmd/docker cli/command: add Cli.CurrentVersion() function 2022-11-28 10:49:01 +01:00
contrib/completion Remove "experimental" gates around "--platform" in bash completion 2022-10-19 14:25:24 -07:00
dockerfiles update gotestsum to v1.8.2 2022-11-17 18:08:19 +01:00
docs docs: update version to v23.0.0-dev 2022-11-24 19:43:34 +01:00
e2e format go with gofumpt (with -lang=1.19) 2022-09-30 19:14:36 +02:00
experimental experimental: fix broken link to "checkpoint and restore" page 2021-09-07 13:30:48 +02:00
internal/test cli/command: add Cli.CurrentVersion() function 2022-11-28 10:49:01 +01:00
man docs: remove documentation about deprecated cluster-store 2022-05-17 11:00:51 +02:00
opts format go with gofumpt (with -lang=1.19) 2022-09-30 19:14:36 +02:00
scripts update to golang 1.19 2022-09-08 10:40:06 +02:00
service/logs bump gotest.tools v3.0.1 for compatibility with Go 1.14 2020-02-23 00:28:55 +01:00
templates staticcheck: ignore SA1019: strings.Title is deprecated 2022-03-28 17:23:06 +02:00
vendor vendor: update github.com/moby/term to fix interrupt handling 2022-11-28 10:28:21 +01:00
.dockerignore validate manpages target 2022-02-25 17:11:17 +01:00
.gitattributes fix linguist with .gitattributes 2021-12-16 21:16:02 +01:00
.gitignore validate manpages target 2022-02-25 17:11:17 +01:00
.golangci.yml Use gofumpt if available, and enable gofumpt linter 2022-09-30 19:14:36 +02:00
.mailmap update AUTHORS and mailmap 2022-06-03 12:18:51 +02:00
AUTHORS update AUTHORS and mailmap 2022-06-03 12:18:51 +02:00
CONTRIBUTING.md Use gofumpt if available, and enable gofumpt linter 2022-09-30 19:14:36 +02:00
Dockerfile update gotestsum to v1.8.2 2022-11-17 18:08:19 +01:00
LICENSE Add project files 2017-04-17 17:49:33 -04:00
MAINTAINERS Add Sam Thibault (sam-thibault) as curator 2022-11-25 11:35:41 +01:00
Makefile Use gofumpt if available, and enable gofumpt linter 2022-09-30 19:14:36 +02:00
NOTICE switch kr/pty to creack/pty v1.1.7 2019-07-29 16:45:41 -07:00
README.md remove circleci 2022-02-25 17:11:17 +01:00
TESTING.md tweak description of login/logout 2022-04-04 10:44:11 +02:00
VERSION Update version to v23.0.0-dev 2022-11-24 19:43:32 +01:00
codecov.yml Drop support for (archived) Compose-on-Kubernetes 2022-02-22 13:47:34 +01:00
docker-bake.hcl Update to Go 1.19.3 to address CVE-2022-41716 2022-11-05 17:39:57 +01:00
docker.Makefile Use gofumpt if available, and enable gofumpt linter 2022-09-30 19:14:36 +02:00
vendor.mod vendor: update github.com/moby/term to fix interrupt handling 2022-11-28 10:28:21 +01:00
vendor.sum vendor: update github.com/moby/term to fix interrupt handling 2022-11-28 10:28:21 +01:00

README.md

Docker CLI

PkgGoDev Build Status Test Status Go Report Card Codecov

About

This repository is the home of the cli used in the Docker CE and Docker EE products.

Development

docker/cli is developed using Docker.

Build CLI from source:

docker buildx bake

Build binaries for all supported platforms:

docker buildx bake cross

Build for a specific platform:

docker buildx bake --set binary.platform=linux/arm64 

Build dynamic binary for glibc or musl:

USE_GLIBC=1 docker buildx bake dynbinary 

Run all linting:

docker buildx bake lint shellcheck

Run test:

docker buildx bake test

List all the available targets:

make help

In-container development environment

Start an interactive development environment:

make -f docker.Makefile shell

Brought to you courtesy of our legal counsel. For more context, please see the NOTICE document in this repo.

Use and transfer of Docker may be subject to certain restrictions by the United States and other governments.

It is your responsibility to ensure that your use and/or transfer does not violate applicable laws.

For more information, please see https://www.bis.doc.gov

Licensing

docker/cli is licensed under the Apache License, Version 2.0. See LICENSE for the full license text.