本篇是关于 docker 三剑客中的 docker machine。
注:环境为 CentOS7,docker 19.03。
docker-machine 是 docker 官方三剑客项目之一,它是一个命令行工具。利用 docker-machine 我们可以快速创建一个 docker 环境。同时它支持多种云计算环境,让用户能在多种平台上安装和维护 docker 运行环境。
上图是 docker-machine 的原理图,它连接不同类型的操作平台是通过对应驱动来实现的, ⽬前已经集成了包括AWS、 IBM、 Google, 以及OpenStack、 VirtualBox、 vSphere等多种云平台的⽀持。
安装 docker-machine
在 linux 上安装 docker-machine 只需要从官方的release库中直接下载编译好的二进制文件即可
base=https://github.com/docker/machine/releases/download/v0.16.0 &&
curl -L $base/docker-machine-$(uname -s)-$(uname -m) >/tmp/docker-machine &&
sudo mv /tmp/docker-machine /usr/local/bin/docker-machine
chmod +x /usr/local/bin/docker-machine
安装完成后,查看其版本信息:
# docker-machine version
docker-machine version 0.16.0, build 702c267f
docker-machine 支持命令的补全,需要下载 machine 库中的bash文件
base=https://raw.githubusercontent.com/docker/machine/v0.16.0
for i in docker-machine-prompt.bash docker-machine-wrapper.bash docker-machine.bash
do
sudo wget "$base/contrib/completion/bash/${i}" -P /etc/bash_completion.d
done
然后执行
source /etc/bash_completion.d/docker-machine-prompt.bash
要启用 docker-machine shell 提示,请添加$(__docker_machine_ps1)
到 PS1 设置中 ~/.bashrc。PS1='[\u@\h \W$(__docker_machine_ps1)]\$ '
使用 docker-machine
安装 docker
docker-machine 支持多种环境的安装,这里我们介绍几种
virtualbox
docker-machine 支持通过 virtualbox 驱动安装并配置 docker 主机,前提是我需要安装 virtualbox (https://www.virtualbox.org/wiki/Downloads)
docker-machine create --driver virtualbox default
genernic
genernic 方式可以通过 ssh 直接在远程上安装 docker,但在这之前先要配置 ssh 认证
1.生成密钥
# ssh-keygen
Generating public/private rsa key pair.
Enter file in which to save the key (/root/.ssh/id_rsa):
Enter passphrase (empty for no passphrase):
Enter same passphrase again:
Your identification has been saved in /root/.ssh/id_rsa.
Your public key has been saved in /root/.ssh/id_rsa.pub.
The key fingerprint is:
SHA256:V7kl+8c0paW/yGFCA+TOvBoH86MtLdKBBZ432TwlrN0 root@centos1
The key's randomart image is:
+---[RSA 2048]----+
| .. |
| . oo . . |
| . o *o+ + . o|
| o *+=.E = +.|
| +oS+ooo o..|
| . .+.o .. +.|
| ..o= . o. +|
| . +*.. + o..|
| .oo. o . |
+----[SHA256]-----+
2.主机上安装密钥
# ssh-copy-id root@192.168.10.11
这样一来本机就可以不需要密码登陆远程主机了。
3.genernic安装docker
# docker-machine create --driver generic --generic-ip-address 192.168.10.11 --generic-ssh-key ~/.ssh/id_rsa --generic-ssh-user=root centos2
注:如果主机上没有安装 docker,这一过程的等待时间就会较长。
4.查看主机
# docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
centos2 - generic Running tcp://192.168.10.11:2376 v19.03.1
其他平台
其他平台的安装方式这里就不再详细说明,需要的话可以查阅 https://docs.docker.com/machine。
docker-machine 命令
docker-machine 提供一系列的子命令,对应不同的功能。
下面介绍这些命令的具体用法
active
格式为 docker-machine active [arg...]
。⽀持-timeout, -t "10"
选项, 代表超时时间, 默认为10s。 查看当前激活状态的Docker主机。 激活状态意味着当前的DOCKER_HOST环境变量指向该主机。 例如, 下⾯命令列出当前激活主机为dev主机:
# docker-machine ls
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
centos2 - generic Running tcp://192.168.10.11:2376 v19.03.1
config
格式为 docker-machine config [OPTIONS] [arg...]
。⽀持 --swarm
参数, 表⽰打印Swarm集群信息, ⽽不是Docker信息。 查看到Docker主机的连接配置信息。 例如, 下⾯显⽰dev主机的连接信息:
# docker-machine config centos2
--tlsverify
--tlscacert="/root/.docker/machine/machines/centos2/ca.pem"
--tlscert="/root/.docker/machine/machines/centos2/cert.pem"
--tlskey="/root/.docker/machine/machines/centos2/key.pem"
-H=tcp://192.168.10.11:2376
create
格式为 docker-machine create [OPTIONS] [arg...]
。 创建⼀个Docker主机环境。 ⽀持的选项包括:
- --driver, -d "virtualbox": 指定驱动类型;
- --engine-install-url "https://get.docker.com": 配置Docker主机时的安装URL;
- --engine-opt option: 以键值对格式指定所创建Docker引擎的参数;
- --engine-insecure-registry option: 以键值对格式指定所创建Docker引擎允许访问的不⽀持认证的注册仓库服务;
- --engine-registry-mirror option: 指定使⽤注册仓库镜像;
- --engine-label option: 为所创建的Docker引擎添加标签;
- --engine-storage-driver: 存储后端驱动类型;
- --engine-env option: 指定环境变量;
- --swarm: 配置Docker主机加⼊到Swarm集群中;
- --swarm-image"swarm: latest": 使⽤Swarm时候采⽤的镜像;
- --swarm-master: 配置机器作为Swarm集群的master节点;
- --swarm-discovery: Swarm集群的服务发现机制参数;
- --swarm-strategy“spread”: Swarm默认调度策略;
- --swarm-opt option: 任意传递给Swarm的参数;
- --swarm-host "tcp: //0.0.0.0: 3376": 指定地址将监听Swarm master节点请求;
- --swarm-addr: 从指定地址发送⼴播加⼊Swarm集群服务。
例如, 通过如下命令可以创建⼀个Docker主机的虚拟机镜像:
# docker-machine create -d virtualbox \
--engine-storage-driver overlay \
--engine-label name=testmachine \
--engine-label year=2018 \
--engine-opt dns=8.8.8.8 \
--engine-env HTTP_PROXY=http://proxy.com:3128 \
--engine-insecure-registry registry.private.com \
mydockermachine
所创建Docker主机虚拟机中的Docker引擎将:
- 使⽤overlay类型的存储驱动;·带有name=testmachine和year=2015两个标签;
- 引擎采⽤8.8.8.8作为默认DNS;
- 环境变量中指定HTTP代理服务http://proxy.com:3128。
- 允许使⽤不带验证的注册仓库服务registry.private.com。
env
格式为 docker-machine env [OPTIONS] [arg...]
。显⽰连接到某个主机需要的环境变量。 ⽀持的选项包括:
·-swarm: 显⽰Swarm集群配置;
·-shell: 指定所⾯向的Shell环境, 默认为当前⾃动探测;
·-unset, -u: 取消对应的环境变量;
·-no-proxy: 添加对象主机地址到NO_PROXY环境变量。
例如, 显⽰连接到default主机所需要的环境变量:
# docker-machine env centos2
export DOCKER_TLS_VERIFY="1"
export DOCKER_HOST="tcp://192.168.10.11:2376"
export DOCKER_CERT_PATH="/root/.docker/machine/machines/centos2"
export DOCKER_MACHINE_NAME="centos2"
# Run this command to configure your shell:
# eval $(docker-machine env centos2)
inspect
格式为 docker-machine inspect [OPTIONS] [arg...]
。以json格式输出指定Docker主机的详细信息。 ⽀持 -format, -f 选项使⽤指定的Go模板格式化输出。
ip
获取指定Docker主机地址。 例如, 获取 centos2 主机的地址, 可以⽤如下命令:
# docker-machine ip centos2
192.168.10.11
kill
直接杀死指定的Docker主机。指定Docker主机会强⾏停⽌。
ls
列出所有管理的主机。 格式为 docker-machine ls [OPTIONS] [arg...]
。可以通过--filter
只输出某些Docker主机, ⽀持过滤器包括名称正则表达式、 驱动类型、 Swarm管理节点名称、 状态等。 例如:
# docker-machine ls --filter state=Running
NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS
centos2 - generic Running tcp://192.168.10.11:2376 v19.03.1
⽀持选项包括:
- --quiet, -q: 减少⽆关输出信息;
- --filter [--filter option--filter option]: 只输出符合过滤条件主机;
- -timeout, -t "10": 命令执⾏超时时间, 默认为10s;
- -format, -f: 使⽤所指定的Go模板格式化输出。