Docker Machine 入門

Docker Machine 入門 === ![](https://i.imgur.com/5JFz36P.png =120x) #### 郭柏均 (Titangene) - E-mail: [titangene.tw@gmail.com](mailto:titangene.tw@gmail.com) - GitHub: [Titangene](https://github.com/titangene) - Blog: titangene.github.io --- :::warning 提醒：本篇是在 Windows 10 家用版的 cmd shell 下操作 :::  --- ## Docker Engine ## & ## Docker Machine ---  平常我們講的 "Docker" 指的是 Docker Engine，是由下面所組成的 client-server application： - Docker daemon - 與 daemon 互動的介面：REST API - 與 daemon 通訊的 CLI client ![](https://i.imgur.com/ZVQeC0w.png =200x)[Ref](https://docs.docker.com/machine/overview/) --- ![](https://i.imgur.com/5kTHXzC.png =700x)[Ref](https://docs.docker.com/machine/overview/) --- Docker Machine 是用來設定和管理 Dockerized 主機 (帶有 Docker Engine 的主機) 的工具，通常會在你的 local 主機安裝。裡面包含的指令： - command line client：`docker-machine` - Docker Engine client：`docker` 可以使用 Docker Machine 在你本地的 Mac 或 Windows、公司網路、資料中心或雲端供應商 (例如：Azure、AWS … 等) 上快速建置 Docker 主機而那些 Dockerized 主機可被稱為 "machines"  --- ## 安裝 Docker Machine 至官方的 [Github Release](https://github.com/docker/machine/releases/) 頁面下載詳情請參考官方的文件：[Install Docker Machine](https://docs.docker.com/machine/install-machine/) --- ### `docker-machine -v` 查看目前 Docker Machine 的版本 ```shell $ docker-machine -v docker-machine version 0.13.0, build 9ba6da9 ``` --- ### 本地端未安裝 Docker Daemon 且未連線至遠端 server 時會出現的錯誤訊息像我沒有在本地端上安裝 Docker Daemon (因為 Host 的 OS 是 Windows 家用版，不能安裝 [Docker for Windows](https://docs.docker.com/docker-for-windows/install/)，只能安裝 [Docker Toolbox](https://hackmd.io/c/H1WITKNUz/%2FHyBPRDfDf)) ，所以不管執行任何 `docker` 指令都會出現下面錯誤： ```shell $ docker ps error during connect: Get http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.36/containers/json: open //./pipe/docker_engine: The system cannot find the file specified. In the default daemon configuration on Windows, the docker client must be run elevated to connect. This error may also indicate that the docker daemon is not running. ```  --- 執行 `docker version` 指令不會顯示 Server 的部分： ```shell $ docker version Client: Version: 18.02.0-ce API version: 1.36 Go version: go1.9.4 Git commit: fc4de447b5 Built: Mon Feb 12 19:03:38 2018 OS/Arch: windows/amd64 Experimental: false Orchestrator: swarm error during connect: Get http://%2F%2F.%2Fpipe%2Fdocker_engine/v1.36/version: open //./pipe/docker_engine: The system cannot find the file specified. In the default daemon configuration on Windows, the docker client must be run elevated to connect. This error may also indicate that the docker daemon is not running. ``` --- ## Docker Machine 指令 --- ### `docker-machine create` 建立新的 Docker Machine - `-d`，`--driver`：設定建立 Docker Machine 的 driver，Docker 官方支援多種 driver，包括 AWS、Azure、GCE ... 等，詳情請參考官方的 [Machine drivers | Docker Documentation](https://docs.docker.com/) 文件 --- 以 VirtualBox 為例： ```shell $ docker-machine create -d [driver] [machine-name] ``` ```shell $ docker-machine create -d virtualbox dev Running pre-create checks... Creating machine... (dev) Copying C:\Users\Titan\.docker\machine\cache\boot2docker.iso to C:\Users\Titan\.docker\machine\machines\dev\boot2docker.iso... (dev) Creating VirtualBox VM... (dev) Creating SSH key... (dev) Starting the VM... (dev) Check network to re-create if needed... (dev) Windows might ask for the permission to configure a dhcp server. Sometimes, such confirmation window is minimized in the taskbar. (dev) Waiting for an IP... Waiting for machine to be running, this may take a few minutes... Detecting operating system of created instance... Waiting for SSH to be available... Detecting the provisioner... Provisioning with boot2docker... Copying certs to the local machine directory... Copying certs to the remote machine... Setting Docker configuration on the remote daemon... Checking connection to Docker... Docker is up and running! To see how to connect your Docker Client to the Docker Engine running on this virtual machine, run: docker-machine env dev ``` --- ### `docker-machine ls` 查看所有 Docker Machine 相關資訊 ```shell $ docker-machine ls NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS default * virtualbox Running tcp://192.168.99.100:2376 v18.02.0-ce dev - virtualbox Running tcp://192.168.99.101:2376 v18.02.0-ce ``` --- 列出訊息的欄位介紹： - `ACTIVE`：顯示 `*` 表示正在操作的 Docker Engine (使用 `docker-machine env` 指令最後的提示設定，將本地的 Docker Client 連接到在 VM 上執行的 Docker Engine)，而顯示 `-` 則反之。 - `STATE`：Docker Engine 狀態 - `URL`：Docker Engine 所在 IP - `SWARM`：是否為 SWARM master or node - `DOCKER`：建立 Docker 時所安裝的 Docker 版本 --- ### `docker-machine env` ```shell $ docker-machine env [machine-name] ``` 可以將該 Docker Machine 連線時所需的環境變數列出來，方便切換環境。該指令輸出的最後有個小提示，在不同的 shell 會有不同的指令，使用那段指令可以快速地把環境變數設定在目前的環境上，也就是可以將本地的 Docker Client 連接到在 VM 上執行的 Docker Engine。 --- 使用 `cmd` 的輸出結果： ```shell $ docker-machine env default SET DOCKER_TLS_VERIFY=1 SET DOCKER_HOST=tcp://192.168.99.100:2376 SET DOCKER_CERT_PATH=C:\Users\Titan\.docker\machine\machines\default SET DOCKER_MACHINE_NAME=default SET COMPOSE_CONVERT_WINDOWS_PATHS=true REM Run this command to configure your shell: REM @FOR /f "tokens=*" %i IN ('docker-machine env default') DO @%i ``` --- 使用 `bash` 的輸出結果： ```shell $ docker-machine env default export DOCKER_TLS_VERIFY="1" export DOCKER_HOST="tcp://192.168.99.100:2376" export DOCKER_CERT_PATH="C:\Users\Titan\.docker\machine\machines\default" export DOCKER_MACHINE_NAME="default" export COMPOSE_CONVERT_WINDOWS_PATHS="true" # Run this command to configure your shell: # eval $("D:\Program Files\Docker Toolbox\docker-machine.exe" env default) ``` --- ## 連結遠端 Docker daemon 執行 `docker-machine env` 指令輸出的最後小提示，就可以將本地的 Docker Client 連接到在 VM 上執行的 Docker Engine  ```shell $ @FOR /f "tokens=*" %i IN ('docker-machine env default') DO @%i ``` --- 接著就可以看到 `docker-machine ls` 指令中的 `ACTIVE` 欄位已從 `-` 變成 `*`，那就代表已成功連接 ```shell $ docker-machine ls NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS default * virtualbox Running tcp://192.168.99.100:2376 v18.02.0-ce ``` --- 使用 `docker version` 指令也可以看到 Docker server 的版本資訊： ```shell $ docker version Client: Version: 18.02.0-ce API version: 1.36 Go version: go1.9.4 Git commit: fc4de447b5 Built: Mon Feb 12 19:03:38 2018 OS/Arch: windows/amd64 Experimental: false Orchestrator: swarm Server: Engine: Version: 18.02.0-ce API version: 1.36 (minimum version 1.12) Go version: go1.9.3 Git commit: fc4de44 Built: Wed Feb 7 21:20:09 2018 OS/Arch: linux/amd64 Experimental: false ``` --- ### `docker-machine ssh` 連線到指定的 Docker Machine ```shell $ docker-machine ssh [machine-name] ``` ![](https://i.imgur.com/8qqywAd.png) --- ### `docker-machine ip` 查詢指定 Docker Machine 的 IP ```shell $ docker-machine ip [machine-name] ``` ```shell $ docker-machine ip default 192.168.99.100 ``` --- ### `docker-machine start` 執行 Docker Machine ```shell $ docker-machine start [machine-name] ``` ```shell $ docker-machine start default Starting "default"... (default) Check network to re-create if needed... (default) Windows might ask for the permission to configure a dhcp server. Sometimes, such confirmation window is minimized in the taskbar. (default) Waiting for an IP... Machine "default" was started. Waiting for SSH to be available... Detecting the provisioner... Started machines may have new IP addresses. You may need to re-run the `docker-machine env` command. $ docker-machine ls NAME ACTIVE DRIVER STATE URL SWARM DOCKER ERRORS default - virtualbox Running tcp://192.168.99.100:2376 v18.02.0-ce ``` --- ### `docker-machine restart` 重新啟動 Docker Machine ```shell $ docker-machine restart [machine-name] ``` ```shell $ docker-machine restart default Restarting "default"... (default) Check network to re-create if needed... (default) Windows might ask for the permission to configure a dhcp server. Sometimes, such confirmation window is minimized in the taskbar. (default) Waiting for an IP... Waiting for SSH to be available... Detecting the provisioner... Restarted machines may have new IP addresses. You may need to re-run the `docker-machine env` command. ``` --- ### `docker-machine rm` 刪除 Docker Machine ```shell $ docker-machine rm [machine-name] ``` ```shell $ docker-machine rm dev About to remove dev WARNING: This action will delete both local reference and remote instance. Are you sure? (y/n): y Successfully removed dev ``` --- ## 參考來源 - [Docker Machine | Docker Documentation](https://docs.docker.com/machine/)

Syntax	Example	Reference
# Header	Header	基本排版
- Unordered List	Unordered List
1. Ordered List	Ordered List
- [ ] Todo List	Todo List
> Blockquote	Blockquote
Bold font	Bold font
Italics font	Italics font
~~Strikethrough~~	~~Strikethrough~~
19^th^	19^th
H~2~O	H₂O
++Inserted text++	Inserted text
==Marked text==	Marked text
[link text](https:// "title")	Link
![image alt](https:// "title")	Image
`Code`	`Code`	在筆記中貼入程式碼
```javascript var i = 0; ```	`var i = 0;`
:smile:		Emoji list
{%youtube youtube_id %}	Externals
$L^aT_eX$	L^aT_eX
:::info This is a alert area. :::	This is a alert area.