Docker Machine用户指南

说明: Machine 当前处于 beta, 因此某些东西可能会变化. 我们同样不推荐你在生产环境中使用。

Machine使得在你的电脑上，云平台上或者你的数据中心里安装Docker hos变得容易。它创建安装docker到平台上的服务，并配置Docker client使之能与平台进行通话。

一旦你的Docker host 被创建，它有一些命令可以管控他们。

  1. 启动、停止和重启

  2. 更新

  3. 配置Docker client to与你的host通话

安装

Docker Machine 支持Windows, OSX 和 Linux操作系统，为了安装Docker Machine，需要下载对应你系统的二进制文件到你PATH的路径下。

  • Windows - x86_64

  • OSX - x86_64

  • Linux - x86_64

  • Windows - i386

  • OSX - i386

  • Linux - i386

现在你需要通过关docker-machine -v检查安装的版本。

  1. $ docker-machine -v
  3. machine version 0.1.0

使用本地VM开始Docker Machine

让我们看看在VirtualBox里，docker-machine怎样创建，使用和管理Docker host的。

首先，确保VirtualBox 4.3.20安装在你的系统里。

如果你运行docker-machine ls命令，查看所有有效的machine，你会看到当前为止是没有的。

  1. $ docker-machine ls
  3. NAME   ACTIVE   DRIVER   STATE   URL

为了创建一个machine，使用docker-machine create命令，在--driver标志传递字符串virtualbox。其最后的参数，传递machine 的名称，在这里，我们命名为“dev”。

这将下载一个轻量的分布式Linux （boot2docker），顺带安装Docker daemon，并将启动一个带有docker运行的VirtualBox VM。

  1. $ docker-machine create --driver virtualbox dev
  3. INFO[0000]Creating SSH key...
  5. INFO[0000]CreatingVirtualBox VM...
  7. INFO[0007]StartingVirtualBox VM...
  9. INFO[0007]Waitingfor VM to start...
  11. INFO[0038]"dev" has been created andis now the active machine
  13. INFO[0038]To connect: docker $(docker-machine config dev) ps

为了使用Docker CLI，你可以使用env命令来列举需要连接该实例的命令。

  1. $ docker-machine env devexport
  3. DOCKER_TLS_VERIFY=yesexport 
  5. DOCKER_CERT_PATH=/home/ehazlett/.docker/machines/.clientexport 
  7. DOCKER_HOST=tcp://192.168.99.100:2376

你可以看到你创建的machine ，通过运行命令docker-machine ls。

  1. $ docker-machine ls
  3. NAME      ACTIVE   DRIVER       STATE     URL
  5. dev       *        virtualbox   Running   tcp://192.168.99.100:2376

dev后边的*表示是活跃的host。

接下来，我们通过命令docker-machine create命令得知，我们需使用docker-machine config命令联系到docker，例如：

  1. $ docker $(docker-machine config dev) ps

这将传递参数给Docker client指定TLS 设置。为了看到传递了什么，运行docker-machine config dev。

你现在就可以在你的host中运行Docker命令了。

  1. $ docker $(docker-machine config dev) run busybox echo hello world
  3. Unable to find image 'busybox' locally
  5. Pulling repository busybox
  7. e72ac664f4f0:Download complete
  9. 511136ea3c5a:Download complete
  11. df7546f9f060:Download complete
  13. e433a6c5b276:Download complete
  15. hello world

在Docker host的IP地址上暴露任何端口都是有效的，为了知道IP我们使用命令docker-machine ip。

  1. $ docker-machine ip
  3. 192.168.99.100

现在你可以管理许多运行有docker的本地VM，通过运行命令docker-machine create。

如果你停止使用一个host，你可以使用 docker-machine stop停止它，随后使用docker-machine start再次启动它。

  1. $ docker-machine stop
  3. $ docker-machine start

如果你不再指定任何参数，命令docker-machine stop将再次运行活跃的host（这里是VirtualBox VM）。你也可以指定一个host，作为重新运行命令的参数。例如，你可以写：

  1. $ docker-machine stop dev
  3. $ docker-machine start dev

使用Docker Machine创建一个cloud provider

最高兴的事情就是，docker-machine提供了数个drivers，这些driver让你使用相同的接口来创建host，在许多不同的云平台上。这些完成的话，需要使用带有—driver标志的docker-machine create命令。这里我们将展示 Digital Ocean driver（叫做digitalocean），但是driver只有数个平台支持Amazon Web Services, Google Compute Engine, 和Microsoft Azure。

通常，它要求你通过账号验证授权的方式作为docker-machine create命令的标志。这些标志对每一个driver是统一的。例如，为了通过Digital Ocean access token ，你使用—digitalocean-access-token标志。

让我们看看这需要做些什么。

为了生成你的access token：

  1. 进入Digital Ocean administrator panel，点击”Apps and API”。

  2. 点击Generate New Token。

  3. 给token 去一个简洁的名称，例如machine。确保Write checkbox被选择，点击”Generate Token”。

  4. 得到长长的十六进制字符串，安全的保存它到某个地方。

现在，运行docker-machine create，含有digitalocean参数的—driver标志，传递参数给—digitalocean-access-token标志。

例如：

  1. $ docker-machine create \    
  3. --driver digitalocean \    
  5. --digitalocean-access-token 0ab77166d407f479c6701652cee3a46830fef88b8199722b87821621736ab2d4 \    
  7. staging
  9. INFO[0000]Creating SSH key...
  11. INFO[0000]CreatingDigitalOcean droplet...
  13. INFO[0002]Waitingfor SSH...
  15. INFO[0085]"staging" has been created andis now the active machine
  17. INFO[0085]To connect: docker $(docker-machine config dev) staging

为了便利，docker-machine将使用默认值的选择设置，例如VPS基于的镜像，但是他们也被拒绝，通过使用他们分别的标志（例如，—digitalocean-image）。这是有用的，如果你想创建一个大的实例，带有许多内存和CPU（通常docker-machine创建一个小的VPS）。为了获取有效的或默认的 flags/settings 的全部列表，查看 docker-machine create -h的全部输出。

当host的产物被初始化，一个唯一的SSH key（作为操控host的key），将被自动创建，并保存在 client目录下（~/.docker/machines）。在创建SSH key后，docker将安装machine，daemon将被配置，接受远程连接，通过使用TLS作为权限认证。一旦，这个完成，host已经能确保连接上。

从这一点，远程host的行为，就像本地host一样。如果我们看docker-machine，我们将会看到它现在是激活的host。

  1. $ docker-machine active dev
  3. $ docker-machine ls
  5. NAME      ACTIVE   DRIVER         STATE     URL
  7. dev                virtualbox     Running   tcp://192.168.99.103:2376
  9. staging   *        digitalocean   Running   tcp://104.236.50.118:2376

为了选择一个激活的host，你可以使用docker-machine active命令。

  1. $ docker-machine active dev
  3. $ docker-machine ls
  5. NAME      ACTIVE   DRIVER         STATE     URL
  7. dev       *        virtualbox     Running   tcp://192.168.99.103:2376
  9. staging            digitalocean   Running   tcp://104.236.50.118:2376

为了移除一个host和所有的容器或者镜像，使用docker-machine rm。

添加一个host，不包含driver

你可以添加一个host，仅仅通过一个URL并不含driver。因此，它可能被使用存在的host，因此你不必打出URL每次，你运行docker命令的时候。

  1. $ docker-machine create --url=tcp://50.134.234.20:2376 custombox
  3. $ docker-machine ls
  5. NAME        ACTIVE   DRIVER    STATE     URL
  7. custombox   *        none      Running   tcp://50.134.234.20:2376

使用包含docker swarm的docker machine

Docker Machine也支持 Swarm 集群，这里可能使用一些driver或者TLS安全认证。

说明：这里实验特征，因此子命令或者参数可能在未来会被修改。

首先，创建一个 Swarm token。随意地，你可以使用另外的发现服务。看Swarm 文档了解更多详细信息。

为了创建token，首先创建一个Machine。这个例子将使用VirtualBox。

  1. $ docker-machine create -d virtualbox local

加载Machine配置。

  1. $ $(docker-machine env local)

运行生成token，使用Swarm Docker镜像。

  1. $ docker run swarm create
  3. 1257e0f0bbb499b5cd04b4c9bdb2dab3

一旦你有token，你可以创建cluster。

Swarm Master

创建 Swarm master

  1. docker-machine create \    
  3. -d virtualbox \    
  5. --swarm \    
  7. --swarm-master \    
  9. --swarm-discovery token://<TOKEN-FROM-ABOVE> \    
  11. swarm-master

使用你的随机token，替换。这将创建Swarm master，并添加本身作为一个Swarm node。

Swarm Nodes

现在，创建更多Swarm nodes。

  1. docker-machine create \    
  3. -d virtualbox \    
  5. --swarm \    
  7. --swarm-discovery token://<TOKEN-FROM-ABOVE> \    
  9. swarm-node-00

你现在又一个包含两个节点的Swarm cluster。为了连接这个Swarm master，使用docker-machine env —swarm swarm-master

例如：

  1. $ docker-machine env --swarm swarm-master
  3. export DOCKER_TLS_VERIFY=yes
  5. export DOCKER_CERT_PATH=/home/ehazlett/.docker/machines/.client
  7. export DOCKER_HOST=tcp://192.168.99.100:3376

你可以加载这些进入你的环境，使用$(docker-machine env —swarm swarm-master)。

现在你可以使用Docker CLI来查询：

  1. $ docker info
  3. Containers:1
  5. Nodes:1
  7. swarm-master:192.168.99.100:2376
  9. └Containers:2
  11. └ReservedCPUs:0/4
  13. └ReservedMemory:0 B /999.9MiB

Subcommands

获取或者设置激活的machine。

active

  1. $ docker-machine ls
  3. NAME      ACTIVE   DRIVER         STATE     URL
  5. dev                virtualbox     Running   tcp://192.168.99.103:2376
  7. staging   *        digitalocean   Running   tcp://104.236.50.118:2376
  11. $ docker-machine active dev
  13. $ docker-machine ls
  15. NAME      ACTIVE   DRIVER         STATE     URL
  17. dev       *        virtualbox     Running   tcp://192.168.99.103:2376
  19. staging            digitalocean   Running   tcp://104.236.50.118:2376

create

创建一个machine

  1. $ docker-machine create --driver virtualbox dev

config

显示docker client配置信息，在machine里。

  1. $ docker-machine config dev

env

设置环境变量，命令docker运行一个命令。

  1. docker-machine env machinename将打印输出export 命令。

运行docker-machine env -u将打印unset命令。

  1. $ env | grep DOCKER
  3. $ $(docker-machine env dev)
  5. $ env | grep DOCKER
  7. DOCKER_HOST=tcp://192.168.99.101:2376
  9. DOCKER_CERT_PATH=/Users/nathanleclaire/.docker/machines/.client
  11. DOCKER_TLS_VERIFY=yes
  13. $ # If you run a docker command, now it will run against that host.
  15. $ $(docker-machine env -u)
  17. $ env | grep DOCKER
  19. $ # The environment variables have been unset.

inspect

检索machine的信息

  1. $ docker-machine inspect dev
  3. {
  5. "DriverName":"virtualbox",
  7. "Driver":{
  9.     "MachineName":"docker-host-128be8d287b2028316c0ad5714b90bcfc11f998056f2f790f7c1f43f3d1e6eda",
  11.     "SSHPort":55834,
  13.     "Memory":1024,
  15.     "DiskSize":20000,
  17.     "Boot2DockerURL":""
  19. }
  21. }

help

显示帮助文本。

ip

获取machine的ip地址。

  1. $ docker-machine ip
  3. 192.168.99.104

kill

kill一个machine。

  1. $ docker-machine ls
  3. NAME   ACTIVE   DRIVER       STATE     URL
  5. dev    *        virtualbox   Running   tcp://192.168.99.104:2376
  7. $ docker-machine kill dev
  9. $ docker-machine ls
  11. NAME   ACTIVE   DRIVER       STATE     URL
  13. dev    *        virtualbox   Stopped

ls

列举machine。

  1. $ docker-machine ls
  3. NAME   ACTIVE   DRIVER       STATE     URL
  5. dev             virtualbox   Stopped
  7. foo0            virtualbox   Running   tcp://192.168.99.105:2376
  9. foo1            virtualbox   Running   tcp://192.168.99.106:2376
  11. foo2            virtualbox   Running   tcp://192.168.99.107:2376
  13. foo3            virtualbox   Running   tcp://192.168.99.108:2376
  15. foo4   *        virtualbox   Running   tcp://192.168.99.109:2376

restart

重启machine。时常，这个等价于docker-machine stop; machine start;

  1. $ docker-machine restart
  3. INFO[0005]Waitingfor VM to start...

rm

移除一个machine。这将移除一个本地引用，或者删除在云端的provider或者虚拟管理平台。

  1. $ docker-machine ls
  3. NAME   ACTIVE   DRIVER       STATE     URL
  5. foo0            virtualbox   Running   tcp://192.168.99.105:2376
  7. foo1            virtualbox   Running   tcp://192.168.99.106:2376
  9. $ docker-machine rm foo1
  11. $ docker-machine ls
  13. NAME   ACTIVE   DRIVER       STATE     URL
  15. foo0            virtualbox   Running   tcp://192.168.99.105:2376

ssh

使用SSH登陆machine。

  1. $ docker-machine ssh dev
  3. Boot2Docker version 1.4.0, build master :69cf398-FriDec1201:39:42 UTC 2014
  5. docker@boot2docker:~$ ls
  7. /Users/   dev/     home/    lib/     mnt/     proc/    run/     sys/     usr/bin/     etc/     init     linuxrc  opt/     root/    sbin/    tmp      var/

你也可以指定命令来参数来运行docker-machine ssh。

  1. $ docker-machine ssh dev free             
  3. total         used         free       shared      buffers
  5. Mem:1023556183136840420030920
  7. -/+ buffers:152216871340
  9. Swap:121203601212036

如果命令添加标志，例如df -h。你可以使用标志解析终端(—)，以此来避免混淆docker-machine client。将另外中断他们作为标志，你故意传递给它。

  1. $ docker-machine ssh dev -- df -h
  3. Filesystem    Size    UsedAvailableUse%    Mounted on
  5. rootfs                  899.6M    85.9M    813.7M    10%    /
  7. tmpfs                   899.6M     85.9M    813.7M  10% /
  9. tmpfs                   499.8M    0    499.8M    0%    /dev/shm
  11. /dev/sda1                18.2G    58.2M    17.2G    0%    /mnt/sda1
  13. cgroup                  499.8M    0    499.8M    0%    /sys/fs/cgroup
  15. /dev/sda1                18.2G    58.2M    17.2G    0%    /mnt/sda1/var/lib/docker/aufs

start

启动一个machine。

  1. $ docker-machine restart
  3. INFO[0005]Waitingfor VM to start...

stop

停止一个machine。

  1. $ docker-machine ls
  3. NAME   ACTIVE   DRIVER       STATE     URL
  5. dev    *        virtualbox   Running   tcp://192.168.99.104:2376
  7. $ docker-machine stop dev
  9. $ docker-machine ls
  11. NAME   ACTIVE   DRIVER       STATE     URL
  13. dev    *        virtualbox   Stopped

upgrade

更新一个machine到最新的docker版本。

  1. $ docker-machine upgrade dev

url

获取一个主机的URL

  1. $ docker-machine url

tcp://192.168.99.109:2376

Drivers

（省略）