Docker 17参考手册
机器 | Machine
docker-machine ls
Usage: docker-machine ls [OPTIONS] [arg...]
List machines
Options:
--quiet, -q Enable quiet mode
--filter [--filter option --filter option] Filter output based on conditions provided
--timeout, -t "10" Timeout in seconds, default to 10s
--format, -f Pretty-print machines using a Go template
超时
该ls
命令尝试并行访问每个主机。如果给定主机在10秒内没有应答,则该ls
命令将声明该主机处于Timeout
状态。在某些情况下(连接不良,负载过高或故障排除时),您可能需要增加或减少此值。您可以使用-t标志来达到此目的,并以秒为单位的数值。
例
$ docker-machine ls -t 12
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
default - virtualbox Running tcp://192.168.99.100:2376 v1.9.1
过滤
过滤标志(--filter
)格式是一key=value
对。如果有多个过滤器,则传递多个标志(例如--filter "foo=bar" --filter "bif=baz"
)
目前支持的过滤器是:
- 驱动程序(驱动名)
- 群(群名)
- 状态(
Running|Paused|Saved|Stopped|Stopping|Starting|Error
)
- 名称(由驱动程序返回的机器名称,支持golang风格的正则表达式)
- 标签(机器创建的
--engine-label
选项,可以过滤label=<key>[=<value>]
)
实例
$ docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
dev - virtualbox Stopped
foo0 - virtualbox Running tcp://192.168.99.105:2376 v1.9.1
foo1 - virtualbox Running tcp://192.168.99.106:2376 v1.9.1
foo2 * virtualbox Running tcp://192.168.99.107:2376 v1.9.1
$ docker-machine ls --filter name=foo0
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
foo0 - virtualbox Running tcp://192.168.99.105:2376 v1.9.1
$ docker-machine ls --filter driver=virtualbox --filter state=Stopped
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
dev - virtualbox Stopped v1.9.1
$ docker-machine ls --filter label=com.class.app=foo1 --filter label=com.class.app=foo2
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
foo1 - virtualbox Running tcp://192.168.99.105:2376 v1.9.1
foo2 * virtualbox Running tcp://192.168.99.107:2376 v1.9.1
格式化
格式化选项(--format
)将使用Go模板漂亮地打印机器。
Go模板的有效占位符列在下面:
占位符 |
描述 |
---|---|
.Name |
机器名称 |
.Active |
机器是否活动? |
.ActiveHost |
机器是非主动主机吗? |
.ActiveSwarm |
该机器是一个活跃的群主? |
.DriverName |
司机的名字 |
.State |
机器状态(正在运行,停止...) |
.URL |
机器网址 |
.Swarm |
机器群名称 |
.Error |
机器错误 |
.DockerVersion |
Docker守护进程版本 |
.ResponseTime |
主持人回应的时间 |
当使用--format
选项,ls
命令将按照模板声明的方式输出数据,或者在使用表指令时,也将包括列标题。
下面的示例使用没有标头的模板,并输出Name
和Driver
所有正在运行的机器都用冒号分隔的条目:
$ docker-machine ls --format "{{.Name}}: {{.DriverName}}"
default: virtualbox
ec2: amazonec2
若要以表格格式列出所有计算机名称及其驱动程序,可以使用:
$ docker-machine ls --format "table {{.Name}} {{.DriverName}}"
NAME DRIVER
default virtualbox
ec2 amazonec2
machine, ls, subcommand
机器 | Machine相关
Docker 是一个开源的应用容器引擎,让开发者可以打包他们的应用以及依赖包到一个可移植的容器中,然后发布到任何流行的 Linux 机器上,也可以实现虚拟化。容器是完全使用沙箱机制,相互之间不会有任何接口。
主页 | https://docker.com/ |
源码 | https://github.com/docker/docker |
版本 | 17 |
发布版本 | 17.06 |