The Docker CLI
Go to file
Sebastiaan van Stijn de6020a240
cli/context/store: simplify error handling, and make it more idiomatic
The package defined various special errors; these errors existed for two reasons;

- being able to distinguish "not found" errors from other errors (as "not found"
  errors can be ignored in various cases).
- to be able to update the context _name_ in the error message after the error
  was created. This was needed in cases where the name was not available at the
  location where the error was produced (e.g. only the "id" was present), and
  the helpers to detect "not found" errors did not support wrapped errors (so
  wrapping the error with a "name" could break logic); a `setContextName` interface
  and corresponding `patchErrContextName()` utility was created for this (which
  was a "creative", but not very standard approach).

This patch:

- Removes the special error-types, replacing them with errdefs definitions (which
  is a more common approach in our code-base to detect error types / classes).
- Removes the internal utilities for error-handling, and deprecates the exported
  utilities (to allow external consumers to adjust their code).
- Some errors have been enriched with detailed information (which may be useful
  for debugging / problem solving).
- Note that in some cases, `patchErrContextName()` was called, but the code
  producing the error would never return a `setContextName` error, so would
  never update the error message.

Signed-off-by: Sebastiaan van Stijn <github@gone.nl>
2022-09-30 11:19:25 +02:00
.circleci dummy circleci config 2022-02-25 21:15:39 +01:00
.github Update to go 1.19.1 to address CVE-2022-27664, CVE-2022-32190 2022-09-08 10:40:08 +02:00
cli cli/context/store: simplify error handling, and make it more idiomatic 2022-09-30 11:19:25 +02:00
cli-plugins linting: remove unused nolint comments (nolintlint) 2022-09-03 21:25:34 +02:00
cmd/docker fix broken alias check is buildx is installed as alias for builder 2022-09-29 22:40:51 +02:00
contrib/completion completion: remove options related to deprecated cluster-store 2022-05-17 11:03:25 +02:00
dockerfiles Update to go 1.19.1 to address CVE-2022-27664, CVE-2022-32190 2022-09-08 10:40:08 +02:00
docs linting: ST1005: error strings should not be capitalized (stylecheck) 2022-09-03 21:25:42 +02:00
e2e replace uses of deprecated env.Patch() 2022-09-22 17:28:07 +02:00
experimental experimental: fix broken link to "checkpoint and restore" page 2021-09-07 13:30:48 +02:00
internal/test format (GoDoc) comments with Go 1.19 to prepare for go updates 2022-07-19 19:10:16 +02:00
man docs: remove documentation about deprecated cluster-store 2022-05-17 11:00:51 +02:00
opts replace uses of deprecated env.Patch() 2022-09-22 17:28:07 +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 Merge pull request #3760 from thaJeztah/update_credshelpers 2022-09-22 19:07:00 +02: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 golangci-lint: update to v1.49.0 for compatibilty with go1.19 2022-09-03 21:25:47 +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 Fix broken link in CONTRIBUTING 2020-03-19 15:03:59 +01:00
Dockerfile Update to go 1.19.1 to address CVE-2022-27664, CVE-2022-32190 2022-09-08 10:40:08 +02:00
LICENSE Add project files 2017-04-17 17:49:33 -04:00
MAINTAINERS maintainers: Add Paweł Gronowski as curator 2022-07-07 14:03:25 +02:00
Makefile Makefile: don't warn "outside container" for some targets 2022-04-06 19:10:53 +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 22.06.0-dev 2022-05-17 11:41:40 +02: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.1 to address CVE-2022-27664, CVE-2022-32190 2022-09-08 10:40:08 +02:00
docker.Makefile Makefile: add missing help messages for some targets 2022-04-06 18:34:51 +02:00
vendor.mod Merge pull request #3760 from thaJeztah/update_credshelpers 2022-09-22 19:07:00 +02:00
vendor.sum Merge pull request #3760 from thaJeztah/update_credshelpers 2022-09-22 19:07:00 +02: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.