Docker

描述

根据您的 Docker 系统配置，您可能需要在前 每dockercommand 替换为sudo.为避免使用sudo使用docker命令，您的系统管理员可以创建一个名为docker并向其添加用户。

有关安装 Docker 或sudoconfiguration，请参阅 作系统的安装说明。

显示帮助文本

要列出任何命令的帮助，只需执行该命令，然后执行--help选择。

$ docker run --help

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

Create and run a new container from an image

Options:
      --add-host value             Add a custom host-to-IP mapping (host:ip) (default [])
  -a, --attach value               Attach to STDIN, STDOUT or STDERR (default [])
<...>

环境变量

以下环境变量列表受docker命令 线：

由于 Docker 是使用 Go 开发的，因此您也可以使用任何环境 Go 运行时使用的变量。特别是，您可能会发现这些很有用：

有关这些变量的详细信息，请参阅 Go 规范。

选项类型

单个字符命令行选项可以组合使用，因此而不是 打字docker run -i -t --name test busybox sh, 您可以编写docker run -it --name test busybox sh.

布尔

布尔选项采用以下格式-d=false.您在帮助文本中看到的值是 如果未指定该标志，则设置的默认值。如果你 指定一个不带值的 Boolean 标志，这会将标志设置为true, 与默认值无关。

例如，运行docker run -d会将值设置为true，因此您的 容器将在后台以 “detached” 模式运行。

默认为true（例如，docker build --rm=true） 只能是 通过将 API 显式设置为false:

$ docker build --rm=false .

多

您可以指定如下选项-a=[]在单个命令行中多次， 例如，在这些命令中：

$ docker run -a stdin -a stdout -i -t ubuntu /bin/bash

$ docker run -a stdin -a stdout -a stderr ubuntu /bin/ls

有时，多个选项可以调用更复杂的值字符串，例如-v:

$ docker run -v /host:/container example/mysql

注意

请勿使用-t和-a stderroptions 一起由于 的pty实现。都stderr在pty模式 只需转到stdout.

字符串和整数

诸如--name=""expect 一个字符串，而它们 只能指定一次。诸如-c=0期望一个整数，并且它们只能指定一次。

配置文件

默认情况下，Docker 命令行将其配置文件存储在 名为.docker在您的$HOME目录。

Docker 管理配置目录中的大部分文件 你不应该修改它们。但是，您可以修改config.json文件来控制docker命令的行为。

您可以修改docker使用环境的命令行为 变量或命令行选项。您还可以使用config.json来修改某些相同的行为。如果环境变量 和--configflag 时，该标志优先于环境 变量。命令行选项覆盖环境变量和环境 变量会覆盖您在config.json文件。

更改.docker目录

要指定其他目录，请使用DOCKER_CONFIG环境变量或--config命令行选项。如果两者都是 指定，则--config选项会覆盖DOCKER_CONFIG环境 变量。下面的示例将docker ps命令使用config.json文件位于~/testconfigs/目录。

$ docker --config ~/testconfigs/ ps

此标志仅适用于正在运行的任何命令。对于持久性 配置中，您可以设置DOCKER_CONFIG环境变量中 shell（例如~/.profile或~/.bashrc).下面的示例将新的 目录HOME/newdir/.docker.

$ echo export DOCKER_CONFIG=$HOME/newdir/.docker > ~/.profile

Docker CLI 配置文件 （config.json） 属性

使用 Docker CLI 配置自定义dockerCLI 的 配置文件使用 JSON 格式和属性：

默认情况下，配置文件存储在~/.docker/config.json.请参阅更改.docker目录部分以使用 不同的位置。

警告

配置文件和~/.docker配置 directory 可能包含敏感信息，例如身份验证信息 用于代理，或者根据您的凭据存储，镜像的凭据 登记处。在与他人共享之前查看配置文件的内容， 并防止将文件提交到版本控制。

自定义命令的默认输出格式

这些字段允许您自定义某些命令的默认输出格式 如果没有--formatflag 的 Flag。

自定义 HTTP 标头

物业HttpHeaders指定要包含在所有邮件中的一组标头 从 Docker 客户端发送到守护程序。Docker 不会尝试解释或 了解这些标头;它只是将它们放入消息中。Docker 可以 不允许这些 Headers 更改它为自己设置的任何 Headers。

或者，使用DOCKER_CUSTOM_HEADERS 环境变量、 在 v27.1 及更高版本中可用。此环境变量是实验性的， 它的确切行为可能会发生变化。

凭据存储选项

物业credsStore指定要用作默认值的外部Binaries 凭据存储。设置此属性后，docker login将尝试 将凭证存储在由docker-credential-<value>哪 在$PATH.如果未设置此属性，则会存储凭据 在authsCLI 配置文件的属性。有关更多信息， 请参阅Credential stores 部分docker login文档

物业credHelpers指定要使用的一组凭证帮助程序 优先于credsStore或auths存储和检索时 特定注册表的凭据。如果设置了此属性，则Binariesdocker-credential-<value>将在存储或检索凭据时使用 对于特定注册表。有关更多信息，请参阅Credential helpers 部分中的docker login文档

容器的自动代理配置

物业proxies指定要自动的代理环境变量 set 添加到容器上，并设置为--build-arg在容器上使用docker build. 一个"default"代理集，并将用于任何 Docker 客户端连接到的守护进程，或者每个主机的配置（Docker 守护进程）， 例如https://docker-daemon1.example.com.以下属性可以 为每个环境设置：

这些设置仅用于配置容器的代理设置，而不用于配置 用作dockerCLI 或dockerd守护 进程。请参阅环境变量和 HTTP/HTTPS 代理部分，为 CLI 和守护程序配置代理设置。

警告

代理服务器设置可能包含敏感信息（例如，如果代理服务器 需要身份验证）。环境变量以纯文本形式存储在 容器的配置，因此可以通过远程 API 或提交到镜像docker commit.

要从容器中分离的默认键序列

附加到容器后，用户从容器中分离并使用 使用CTRL-p CTRL-q键序列。此 detach 键序列是可自定义的 使用detachKeys财产。指定<sequence>值 财产。的<sequence>是逗号分隔的任一 字母 [a-Z] 或ctrl-与以下任一内容结合使用：

• a-z（单个小写字母字符）
• @（签到）
• [（左括号）
• \\（两个反斜杠）
• _（下划线）
• ^（插入符号）

您的自定义适用于使用 Docker 客户端启动的所有容器。 用户可以覆盖每个容器上的自定义键序列或默认键序列 基础。为此，用户指定--detach-keysflag 替换为docker attach,docker exec,docker run或docker start命令。

CLI 插件选项

物业plugins包含特定于 CLI 插件的设置。这 key 是插件名称，而 value 是选项的进一步映射， 它们特定于该插件。

示例配置文件

下面是一个示例config.json文件来说明用于 各种领域：

{
  "HttpHeaders": {
    "MyHeader": "MyValue"
  },
  "psFormat": "table {{.ID}}\\t{{.Image}}\\t{{.Command}}\\t{{.Labels}}",
  "imagesFormat": "table {{.ID}}\\t{{.Repository}}\\t{{.Tag}}\\t{{.CreatedAt}}",
  "pluginsFormat": "table {{.ID}}\t{{.Name}}\t{{.Enabled}}",
  "statsFormat": "table {{.Container}}\t{{.CPUPerc}}\t{{.MemUsage}}",
  "servicesFormat": "table {{.ID}}\t{{.Name}}\t{{.Mode}}",
  "secretFormat": "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}\t{{.UpdatedAt}}",
  "configFormat": "table {{.ID}}\t{{.Name}}\t{{.CreatedAt}}\t{{.UpdatedAt}}",
  "serviceInspectFormat": "pretty",
  "nodesFormat": "table {{.ID}}\t{{.Hostname}}\t{{.Availability}}",
  "detachKeys": "ctrl-e,e",
  "credsStore": "secretservice",
  "credHelpers": {
    "awesomereg.example.org": "hip-star",
    "unicorn.example.com": "vcbait"
  },
  "plugins": {
    "plugin1": {
      "option": "value"
    },
    "plugin2": {
      "anotheroption": "anothervalue",
      "athirdoption": "athirdvalue"
    }
  },
  "proxies": {
    "default": {
      "httpProxy":  "http://user:pass@example.com:3128",
      "httpsProxy": "https://my-proxy.example.com:3129",
      "noProxy":    "intra.mycorp.example.com",
      "ftpProxy":   "http://user:pass@example.com:3128",
      "allProxy":   "socks://example.com:1234"
    },
    "https://manager1.mycorp.example.com:2377": {
      "httpProxy":  "http://user:pass@example.com:3128",
      "httpsProxy": "https://my-proxy.example.com:3129"
    }
  }
}

实验性功能

实验性功能提供了对未来产品功能的早期访问。 这些功能用于测试和反馈，它们可能会发生变化 在版本之间没有警告，也可以从将来的版本中删除。

从 Docker 20.10 开始，实验性 CLI 功能默认启用， 并且不需要任何配置即可启用它们。

公证人

如果使用您自己的公证服务器和自签名证书或内部 证书颁发机构，您需要将证书放在tls/<registry_url>/ca.crt在您的 Docker 配置目录中。

或者，您可以通过将证书添加到系统的 根证书颁发机构列表。

选项

例子

指定守护程序主机 （-H， --host）

您可以使用-H,--host标志来指定调用时要使用的套接字 一个docker命令。您可以使用以下协议：

如果您未指定-H标志，并且您没有使用自定义上下文， 命令使用以下默认套接字：

• unix:///var/run/docker.sock在 macOS 和 Linux 上
• npipe:////./pipe/docker_engine在 Windows 上

要实现类似的效果，而不必指定-Hflag 命令，您还可以创建一个上下文 或者，使用DOCKER_HOST环境变量.

有关-H标志，请参阅 Daemon 套接字选项。

使用 TCP 套接字

以下示例显示了如何调用docker ps通过 TCP 连接到远程 具有 IP 地址的守护程序174.17.0.1、侦听端口2376:

$ docker -H tcp://174.17.0.1:2376 ps

注意

按照约定，Docker 守护程序使用端口2376对于安全的 TLS 连接， 和端口2375用于不安全的非 TLS 连接。

使用 SSH 套接字

当您使用 SSH 在远程守护程序上调用命令时，请求将被转发 到/var/run/docker.sockSSH 主机上的 Unix 套接字。

$ docker -H ssh://user@192.168.64.5 ps

您可以选择通过附加路径来指定套接字的位置 组件添加到 SSH 地址的末尾。

$ docker -H ssh://user@192.168.64.5/var/run/docker.sock ps

子命令