Docker 上下文
介绍
本指南介绍了如何使用上下文从单个客户端管理 Docker 守护程序。
每个上下文都包含管理守护程序上资源所需的所有信息。docker context
命令可以轻松配置这些上下文并在它们之间切换。
例如,单个 Docker 客户端可以配置两个上下文
- 在本地运行的默认上下文
- 远程共享上下文
配置好这些上下文后,可以使用 docker context use <context-name>
命令在它们之间切换。
先决条件
要遵循本指南中的示例,您需要
- 支持顶级
context
命令的 Docker 客户端
运行 docker context
以验证您的 Docker 客户端是否支持上下文。
上下文的构成
上下文是几个属性的组合。其中包括
- 名称和描述
- 端点配置
- TLS 信息
要列出可用的上下文,请使用 docker context ls
命令。
$ docker context ls
NAME DESCRIPTION DOCKER ENDPOINT ERROR
default * unix:///var/run/docker.sock
这将显示名为“default”的单个上下文。它配置为通过本地 /var/run/docker.sock
Unix 套接字与守护程序通信。
NAME
列中的星号表示这是活动上下文。这意味着所有 docker
命令都将针对此上下文运行,除非使用环境变量(如 DOCKER_HOST
和 DOCKER_CONTEXT
)或在命令行中使用 --context
和 --host
标志进行覆盖。
使用 docker context inspect
进行更深入的了解。以下示例显示了如何检查名为 default
的上下文。
$ docker context inspect default
[
{
"Name": "default",
"Metadata": {},
"Endpoints": {
"docker": {
"Host": "unix:///var/run/docker.sock",
"SkipTLSVerify": false
}
},
"TLSMaterial": {},
"Storage": {
"MetadataPath": "\u003cIN MEMORY\u003e",
"TLSPath": "\u003cIN MEMORY\u003e"
}
}
]
创建新的上下文
可以使用 docker context create
命令创建新的上下文。
以下示例创建一个名为 docker-test
的新上下文,并将该上下文的宿主端点指定为 TCP 套接字 tcp://docker:2375
。
$ docker context create docker-test --docker host=tcp://docker:2375
docker-test
Successfully created context "docker-test"
新上下文存储在 ~/.docker/contexts/
下的 meta.json
文件中。您创建的每个新上下文都会在 ~/.docker/contexts/
的专用子目录中存储其自己的 meta.json
。
可以使用 docker context ls
和 docker context inspect <context-name>
查看新上下文。
$ docker context ls
NAME DESCRIPTION DOCKER ENDPOINT ERROR
default * unix:///var/run/docker.sock
docker-test tcp://docker:2375
当前上下文用星号 (“*”) 表示。
使用不同的上下文
可以使用 docker context use
在上下文之间切换。
以下命令将使 docker
CLI 使用 docker-test
上下文。
$ docker context use docker-test
docker-test
Current context is now "docker-test"
通过列出所有上下文并确保星号 (“*”) 位于 docker-test
上下文旁来验证操作。
$ docker context ls
NAME DESCRIPTION DOCKER ENDPOINT ERROR
default unix:///var/run/docker.sock
docker-test * tcp://docker:2375
docker
命令现在将针对 docker-test
上下文中定义的端点。
您还可以使用全局 DOCKER_CONTEXT
环境变量设置当前上下文。环境变量将覆盖使用 docker context use
设置的上下文。
使用以下适当的命令使用环境变量将上下文设置为 docker-test
。
> $env:DOCKER_CONTEXT='docker-test'
$ export DOCKER_CONTEXT=docker-test
运行 docker context ls
以验证 docker-test
上下文现在是否为活动上下文。
您还可以使用全局 --context
标志来覆盖上下文。以下命令使用名为 production
的上下文。
$ docker --context production container ls
导出和导入 Docker 上下文
可以使用 docker context export
和 docker context import
命令在不同的主机上导出和导入上下文。
docker context export
命令将现有上下文导出到文件。该文件可以在安装了 docker
客户端的任何主机上导入。
导出和导入上下文
以下示例导出名为 docker-test
的现有上下文。它将被写入名为 docker-test.dockercontext
的文件。
$ docker context export docker-test
Written file "docker-test.dockercontext"
检查导出文件的内容。
$ cat docker-test.dockercontext
在另一台主机上使用 docker context import
导入此文件以创建具有相同配置的上下文。
$ docker context import docker-test docker-test.dockercontext
docker-test
Successfully imported context "docker-test"
可以使用 docker context ls
验证上下文是否已导入。
导入命令的格式为 docker context import <context-name> <context-file>
。
更新上下文
可以使用 docker context update
更新现有上下文中的字段。
以下示例更新现有 docker-test
上下文中的描述字段。
$ docker context update docker-test --description "Test context"
docker-test
Successfully updated context "docker-test"