一，Docker-compose簡介

1，Docker-compose簡介

Docker-Compose項(xiàng)目是Docker官方的開源項(xiàng)目，負(fù)責(zé)實(shí)現(xiàn)對Docker容器集群的快速編排。

Docker-Compose將所管理的容器分為三層，分別是工程（project），服務(wù)（service）以及容器（container）。Docker-Compose運(yùn)行目錄下的所有文件（docker-compose.yml，extends文件或環(huán)境變量文件等）組成一個(gè)工程，若無特殊指定工程名即為當(dāng)前目錄名。一個(gè)工程當(dāng)中可包含多個(gè)服務(wù)，每個(gè)服務(wù)中定義了容器運(yùn)行的鏡像，參數(shù)，依賴。一個(gè)服務(wù)當(dāng)中可包括多個(gè)容器實(shí)例，Docker-Compose并沒有解決負(fù)載均衡的問題，因此需要借助其它工具實(shí)現(xiàn)服務(wù)發(fā)現(xiàn)及負(fù)載均衡。

Docker-Compose的工程配置文件默認(rèn)為docker-compose.yml，可通過環(huán)境變量COMPOSE_FILE或-f參數(shù)自定義配置文件，其定義了多個(gè)有依賴關(guān)系的服務(wù)及每個(gè)服務(wù)運(yùn)行的容器。

使用一個(gè)Dockerfile模板文件，可以讓用戶很方便的定義一個(gè)單獨(dú)的應(yīng)用容器。在工作中，經(jīng)常會(huì)碰到需要多個(gè)容器相互配合來完成某項(xiàng)任務(wù)的情況。例如要實(shí)現(xiàn)一個(gè)Web項(xiàng)目，除了Web服務(wù)容器本身，往往還需要再加上后端的數(shù)據(jù)庫服務(wù)容器，甚至還包括負(fù)載均衡容器等。

Compose允許用戶通過一個(gè)單獨(dú)的docker-compose.yml模板文件（YAML 格式）來定義一組相關(guān)聯(lián)的應(yīng)用容器為一個(gè)項(xiàng)目（project）。

Docker-Compose項(xiàng)目由Python編寫，調(diào)用Docker服務(wù)提供的API來對容器進(jìn)行管理。因此，只要所操作的平臺(tái)支持Docker API，就可以在其上利用Compose來進(jìn)行編排管理。

2，Docker-compose的安裝

　　安裝環(huán)境查看

安裝

apt?install?python-pip

pip?install?docker-compose

PS：centos使用命令yum -y?install python-pip安裝pip

查看安裝的版本

# docker-compose --version

docker-compose version 1.24.0, build 0aa5906

3，Docker-compose卸載

1pip uninstall docker-compose

二，Docker-compose常用命令

1，Docker-compose命令格式

docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]

?命令選項(xiàng)如下

-f --file?FILE指定Compose模板文件，默認(rèn)為docker-compose.yml

-p --project-name NAME 指定項(xiàng)目名稱，默認(rèn)使用當(dāng)前所在目錄為項(xiàng)目名

--verbose? 輸出更多調(diào)試信息

-v，-version 打印版本并退出

--log-level LEVEL 定義日志等級(jí)(DEBUG, INFO, WARNING, ERROR, CRITICAL)

?2，docker-compose up

docker-compose up [options] [--scale SERVICE=NUM...] [SERVICE...]

選項(xiàng)包括：

-d 在后臺(tái)運(yùn)行服務(wù)容器

-no-color 不是有顏色來區(qū)分不同的服務(wù)的控制輸出

-no-deps 不啟動(dòng)服務(wù)所鏈接的容器

--force-recreate 強(qiáng)制重新創(chuàng)建容器，不能與-no-recreate同時(shí)使用

–no-recreate 如果容器已經(jīng)存在，則不重新創(chuàng)建，不能與–force-recreate同時(shí)使用

–no-build 不自動(dòng)構(gòu)建缺失的服務(wù)鏡像

–build 在啟動(dòng)容器前構(gòu)建服務(wù)鏡像

–abort-on-container-exit?停止所有容器，如果任何一個(gè)容器被停止，不能與-d同時(shí)使用

-t, –timeout TIMEOUT 停止容器時(shí)候的超時(shí)（默認(rèn)為10秒）

–remove-orphans 刪除服務(wù)中沒有在compose文件中定義的容器

?3，docker-compose ps

docker-compose?ps?[options] [SERVICE...]

列出項(xiàng)目中所有的容器

?4，docker-compose stop

docker-compose stop [options] [SERVICE...]

選項(xiàng)包括

-t, –timeout TIMEOUT 停止容器時(shí)候的超時(shí)（默認(rèn)為10秒）

docker-compose stop

停止正在運(yùn)行的容器，可以通過docker-compose start 再次啟動(dòng)

?5，docker-compose -h

docker-compose -h

查看幫助

?6，docker-compose down

docker-compose down [options]

停止和刪除容器、網(wǎng)絡(luò)、卷、鏡像。

選項(xiàng)包括：

–rmi?type，刪除鏡像，類型必須是：all，刪除compose文件中定義的所有鏡像；local，刪除鏡像名為空的鏡像

-v, –volumes，刪除已經(jīng)在compose文件中定義的和匿名的附在容器上的數(shù)據(jù)卷

–remove-orphans，刪除服務(wù)中沒有在compose中定義的容器

docker-compose down

停用移除所有容器以及網(wǎng)絡(luò)相關(guān)

?7，docker-compose logs

docker-compose logs [options] [SERVICE...]

查看服務(wù)容器的輸出。默認(rèn)情況下，docker-compose將對不同的服務(wù)輸出使用不同的顏色來區(qū)分?？梢酝ㄟ^–no-color來關(guān)閉顏色。

docker-compose logs

查看服務(wù)容器的輸出

-f 跟蹤日志輸出

?8，docker-compose bulid

docker-compose build [options] [--build-arg key=val...] [SERVICE...]

構(gòu)建（重新構(gòu)建）項(xiàng)目中的服務(wù)容器。

選項(xiàng)包括：

–compress 通過gzip壓縮構(gòu)建上下環(huán)境

–force-rm?刪除構(gòu)建過程中的臨時(shí)容器

–no-cache 構(gòu)建鏡像過程中不使用緩存

–pull 始終嘗試通過拉取操作來獲取更新版本的鏡像

-m, –memory MEM為構(gòu)建的容器設(shè)置內(nèi)存大小

–build-arg key=val為服務(wù)設(shè)置build-time變量

服務(wù)容器一旦構(gòu)建后，將會(huì)帶上一個(gè)標(biāo)記名。可以隨時(shí)在項(xiàng)目目錄下運(yùn)行docker-compose build來重新構(gòu)建服務(wù)

?9，docker-compose pull

docker-compose pull [options] [SERVICE...]

拉取服務(wù)依賴的鏡像。

選項(xiàng)包括：

–ignore-pull-failures，忽略拉取鏡像過程中的錯(cuò)誤

–parallel，多個(gè)鏡像同時(shí)拉取

–quiet，拉取鏡像過程中不打印進(jìn)度信息

docker-compose pull

拉取服務(wù)依賴的鏡像

?10，docker-compose restart

docker-compose restart [options] [SERVICE...]

重啟項(xiàng)目中的服務(wù)。

選項(xiàng)包括：

-t, –timeout TIMEOUT，指定重啟前停止容器的超時(shí)（默認(rèn)為10秒）

docker-compose restart

重啟項(xiàng)目中的服務(wù)

?11，docker-compose rm

docker-compose?rm?[options] [SERVICE...]

刪除所有（停止?fàn)顟B(tài)的）服務(wù)容器。

選項(xiàng)包括：

–f, –force，強(qiáng)制直接刪除，包括非停止?fàn)顟B(tài)的容器

-v，刪除容器所掛載的數(shù)據(jù)卷

docker-compose?rm

刪除所有（停止?fàn)顟B(tài)的）服務(wù)容器。推薦先執(zhí)行docker-compose stop命令來停止容器。

12，docker-compose start

docker-compose start [SERVICE...]

docker-compose start

啟動(dòng)已經(jīng)存在的服務(wù)容器。

?13，docker-compose run

docker-compose run [options] [-v?VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]

在指定服務(wù)上執(zhí)行一個(gè)命令。

docker-compose run ubuntu?ping?www.baidu.com

在指定容器上執(zhí)行一個(gè)ping命令。

?14，docker-compose scale

docker-compose scale web=3 db=2

設(shè)置指定服務(wù)運(yùn)行的容器個(gè)數(shù)。通過service=num的參數(shù)來設(shè)置數(shù)量

?15，docker-compose pause

docker-compose pause [SERVICE...]

暫停一個(gè)服務(wù)容器

?16，docker-compose kill

docker-compose?kill?[options] [SERVICE...]

通過發(fā)送SIGKILL信號(hào)來強(qiáng)制停止服務(wù)容器。

支持通過-s參數(shù)來指定發(fā)送的信號(hào)，例如通過如下指令發(fā)送SIGINT信號(hào)：

docker-compose?kill?-s SIGINT

?17，docker-compose config

docker-compose config [options]

驗(yàn)證并查看compose文件配置。

選項(xiàng)包括：

–resolve-image-digests 將鏡像標(biāo)簽標(biāo)記為摘要

-q, –quiet 只驗(yàn)證配置，不輸出。 當(dāng)配置正確時(shí)，不輸出任何內(nèi)容，當(dāng)文件配置錯(cuò)誤，輸出錯(cuò)誤信息

–services 打印服務(wù)名，一行一個(gè)

–volumes 打印數(shù)據(jù)卷名，一行一個(gè)

18，docker-compose create

docker-compose create [options] [SERVICE...]

為服務(wù)創(chuàng)建容器。

選項(xiàng)包括：

–force-recreate：重新創(chuàng)建容器，即使配置和鏡像沒有改變，不兼容–no-recreate參數(shù)

–no-recreate：如果容器已經(jīng)存在，不需要重新創(chuàng)建，不兼容–force-recreate參數(shù)

–no-build：不創(chuàng)建鏡像，即使缺失

–build：創(chuàng)建容器前　　，生成鏡像

19，docker-compose exec

docker-compose?exec?[options] SERVICE COMMAND [ARGS...]

選項(xiàng)包括：

-d 分離模式，后臺(tái)運(yùn)行命令。

–privileged 獲取特權(quán)。

–user USER 指定運(yùn)行的用戶。

-T 禁用分配TTY，默認(rèn)docker-compose?exec分配TTY。

–index=index，當(dāng)一個(gè)服務(wù)擁有多個(gè)容器時(shí)，可通過該參數(shù)登陸到該服務(wù)下的任何服務(wù)，例如：docker-compose?exec?–index=1 web?/bin/bash?，web服務(wù)中包含多個(gè)容器

20，docker-compose port

docker-compose port [options] SERVICE PRIVATE_PORT

顯示某個(gè)容器端口所映射的公共端口。

選項(xiàng)包括：

–protocol=proto，指定端口協(xié)議，TCP（默認(rèn)值）或者UDP

–index=index，如果同意服務(wù)存在多個(gè)容器，指定命令對象容器的序號(hào)（默認(rèn)為1）

21，docker-compose push

docker-compose push [options] [SERVICE...]

推送服務(wù)依的鏡像。

選項(xiàng)包括：

–ignore-push-failures 忽略推送鏡像過程中的錯(cuò)誤

22，docker-compose stop

docker-compose stop [options] [SERVICE...]

停止運(yùn)行的容器

?23，docker-compose uppause

docker-compose unpause [SERVICE...]

恢復(fù)處于暫停狀態(tài)中的服務(wù)。

?三，Docker-compose模板文件

1，Docker-compose模板文件簡介

Compose允許用戶通過一個(gè)docker-compose.yml模板文件（YAML 格式）來定義一組相關(guān)聯(lián)的應(yīng)用容器為一個(gè)項(xiàng)目（project）。

Compose模板文件是一個(gè)定義服務(wù)、網(wǎng)絡(luò)和卷的YAML文件。Compose模板文件默認(rèn)路徑是當(dāng)前目錄下的docker-compose.yml，可以使用.yml或.yaml作為文件擴(kuò)展名。

Docker-Compose標(biāo)準(zhǔn)模板文件應(yīng)該包含version、services、networks 三大部分，最關(guān)鍵的是services和networks兩個(gè)部分。

舉例

version:?'2'

services:

??web:

????image: dockercloud/hello-world

????ports:

??????- 8080

????networks:

??????- front-tier

??????- back-tier

??redis:

????image: redis

????links:

??????- web

????networks:

??????- back-tier

??lb:

????image: dockercloud/haproxy

????ports:

??????- 80:80

????links:

??????- web

????networks:

??????- front-tier

??????- back-tier

????volumes:

??????-?/var/run/docker.sock:/var/run/docker.sock

networks:

??front-tier:

????driver: bridge

??back-tier:

????driver: bridge

?　　Compose目前有三個(gè)版本分別為Version 1，Version 2，Version 3，Compose區(qū)分Version 1和Version 2（Compose 1.6.0+，Docker Engine 1.10.0+）。Version 2支持更多的指令。Version 1將來會(huì)被棄用。

2，image

　　image是指定服務(wù)的鏡像名稱或鏡像ID。如果鏡像在本地不存在，Compose將會(huì)嘗試?yán)＄R像。

services:

????web:

????????image: hello-world

3，build

　　服務(wù)除了可以基于指定的鏡像，還可以基于一份Dockerfile，在使用up啟動(dòng)時(shí)執(zhí)行構(gòu)建任務(wù)，構(gòu)建標(biāo)簽是build，可以指定Dockerfile所在文件夾的路徑。Compose將會(huì)利用Dockerfile自動(dòng)構(gòu)建鏡像，然后使用鏡像啟動(dòng)服務(wù)容器。

1build:?/path/to/build/dir

?　　也可以是相對路徑，只要上下文確定就可以讀取到Dockerfile。

1build: ./dir

?　　設(shè)定上下文根目錄，然后以該目錄為準(zhǔn)指定Dockerfile。

build:

??context: ../

??dockerfile: path/of/Dockerfile

build都是一個(gè)目錄，如果要指定Dockerfile文件需要在build標(biāo)簽的子級(jí)標(biāo)簽中使用dockerfile標(biāo)簽指定。

如果同時(shí)指定image和build兩個(gè)標(biāo)簽，那么Compose會(huì)構(gòu)建鏡像并且把鏡像命名為image值指定的名字。

4,context

　　context選項(xiàng)可以是Dockerfile的文件路徑，也可以是到鏈接到git倉庫的url，當(dāng)提供的值是相對路徑時(shí)，被解析為相對于撰寫文件的路徑，此目錄也是發(fā)送到Docker守護(hù)進(jìn)程的context

build:

??context: ./dir

?　　5,dockerfile

　　使用dockerfile文件來構(gòu)建，必須指定構(gòu)建路徑

build:

??context: .

??dockerfile: Dockerfile-alternate

?6,commond

　　使用command可以覆蓋容器啟動(dòng)后默認(rèn)執(zhí)行的命令。

command: bundle?exec?thin -p 3000

?7,container_name

Compose的容器名稱格式是：<項(xiàng)目名稱><服務(wù)名稱><序號(hào)>

可以自定義項(xiàng)目名稱、服務(wù)名稱，但如果想完全控制容器的命名，可以使用標(biāo)簽指定：

container_name: app

?8,depends_on

在使用Compose時(shí)，最大的好處就是少打啟動(dòng)命令，但一般項(xiàng)目容器啟動(dòng)的順序是有要求的，如果直接從上到下啟動(dòng)容器，必然會(huì)因?yàn)槿萜饕蕾噯栴}而啟動(dòng)失敗。例如在沒啟動(dòng)數(shù)據(jù)庫容器的時(shí)候啟動(dòng)應(yīng)用容器，應(yīng)用容器會(huì)因?yàn)檎也坏綌?shù)據(jù)庫而退出。depends_on標(biāo)簽用于解決容器的依賴、啟動(dòng)先后的問題

version:?'2'

services:

??web:

????build: .

????depends_on:

??????- db

??????- redis

??redis:

????image: redis

??db:

????image: postgres

?　　上述YAML文件定義的容器會(huì)先啟動(dòng)redis和db兩個(gè)服務(wù)，最后才啟動(dòng)web 服務(wù)。

9,PID

pid: "host"

將PID模式設(shè)置為主機(jī)PID模式，跟主機(jī)系統(tǒng)共享進(jìn)程命名空間。容器使用pid標(biāo)簽將能夠訪問和操縱其他容器和宿主機(jī)的名稱空間。

10,ports

ports用于映射端口的標(biāo)簽。

使用HOST:CONTAINER格式或者只是指定容器的端口，宿主機(jī)會(huì)隨機(jī)映射端口。

ports:

?-?"3000"

?-?"8000:8000"

?-?"49100:22"

?-?"127.0.0.1:8001:8001"

?　　當(dāng)使用HOST:CONTAINER格式來映射端口時(shí)，如果使用的容器端口小于60可能會(huì)得到錯(cuò)誤得結(jié)果，因?yàn)閅AML將會(huì)解析xx:yy這種數(shù)字格式為60進(jìn)制。所以建議采用字符串格式。

11,extra_hosts

　　添加主機(jī)名的標(biāo)簽，會(huì)在/etc/hosts文件中添加一些記錄。

extra_hosts:

?-?"somehost:162.242.195.82"

?-?"otherhost:50.31.209.229"

?　　啟動(dòng)后查看容器內(nèi)部hosts：

162.242.195.82? somehost

50.31.209.229?? otherhost

12,volumes

掛載一個(gè)目錄或者一個(gè)已存在的數(shù)據(jù)卷容器，可以直接使用 [HOST:CONTAINER]格式，或者使用[HOST:CONTAINER:ro]格式，后者對于容器來說，數(shù)據(jù)卷是只讀的，可以有效保護(hù)宿主機(jī)的文件系統(tǒng)。

Compose的數(shù)據(jù)卷指定路徑可以是相對路徑，使用 . 或者 .. 來指定相對目錄。

數(shù)據(jù)卷的格式可以是下面多種形式

volumes:

??//?只是指定一個(gè)路徑，Docker 會(huì)自動(dòng)在創(chuàng)建一個(gè)數(shù)據(jù)卷（這個(gè)路徑是容器內(nèi)部的）。

??-?/var/lib/mysql

??//?使用絕對路徑掛載數(shù)據(jù)卷

??-?/opt/data:/var/lib/mysql

??//?以 Compose 配置文件為中心的相對路徑作為數(shù)據(jù)卷掛載到容器。

??- ./cache:/tmp/cache

??//?使用用戶的相對路徑（~/ 表示的目錄是?/home/<用戶目錄>/ 或者?/root/）。

??- ~/configs:/etc/configs/:ro

??//?已經(jīng)存在的命名的數(shù)據(jù)卷。

??- datavolume:/var/lib/mysql

如果不使用宿主機(jī)的路徑，可以指定一個(gè)volume_driver。

　　volume_driver: mydriver

13,volumes_from

　　從另一個(gè)服務(wù)或容器掛載其數(shù)據(jù)卷：

volumes_from:

???- service_name???

?????- container_name

?14,dns

　　自定義DNS服務(wù)器。可以是一個(gè)值，也可以是一個(gè)列表。

dns：8.8.8.8

dns：

????- 8.8.8.8???

??????- 9.9.9.9

?15,expose

　　暴露端口，但不映射到宿主機(jī)，只允許能被連接的服務(wù)訪問。僅可以指定內(nèi)部端口為參數(shù)，如下所示：

expose:

????-?"3000"

????-?"8000"

16,links

　　鏈接到其它服務(wù)中的容器。使用服務(wù)名稱（同時(shí)作為別名），或者“服務(wù)名稱:服務(wù)別名”（如 SERVICE:ALIAS），例如：

links:

????- db

????- db:database

????- redis

?　　17,net

　　設(shè)置網(wǎng)絡(luò)模式。

net:?"bridge"

net:?"none"

net:?"host"

四，Docker-compose模板文件示例

1，Docker-compose模板文件編寫

　　docker-compose.yml

version:?'2'

services:

??web1:

????image: nginx

????ports:

??????-?"6061:80"

????container_name:?"web1"

????networks:

??????- dev

??web2:

????image: nginx

????ports:

??????-?"6062:80"

????container_name:?"web2"

????networks:

??????- dev

??????- pro

??web3:

????image: nginx

????ports:

??????-?"6063:80"

????container_name:?"web3"

????networks:

??????- pro

networks:

??dev:

????driver: bridge

??pro:

????driver: bridge

?　　docker-compose.yml文件指定了3個(gè)web服務(wù)

2，啟動(dòng)應(yīng)用

　　創(chuàng)建一個(gè)webapp目錄，將docker-compose.yaml文件拷貝到webapp目錄下，使用docker-compose啟動(dòng)應(yīng)用。

docker-compose up -d

3，服務(wù)訪問

　　通過瀏覽器訪問web1，web2，web3

http://127.0.0.1:6061

http://127.0.0.1:6062

http://127.0.0.1:6063