一础浮，Docker-compose簡(jiǎn)介

1豆同，Docker-compose簡(jiǎn)介

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

Docker-Compose將所管理的容器分為三層枣抱，分別是工程（project）辆床，服務(wù)（service）以及容器（container）讼载。Docker-Compose運(yùn)行目錄下的所有文件（docker-compose.yml，extends文件或環(huán)境變量文件等）組成一個(gè)工程菇篡，若無(wú)特殊指定工程名即為當(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è)容器相互配合來(lái)完成某項(xiàng)任務(wù)的情況痢虹。例如要實(shí)現(xiàn)一個(gè)Web項(xiàng)目奖唯，除了Web服務(wù)容器本身，往往還需要再加上后端的數(shù)據(jù)庫(kù)服務(wù)容器坯墨，甚至還包括負(fù)載均衡容器等捣染。

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

Docker-Compose項(xiàng)目由Python編寫，調(diào)用Docker服務(wù)提供的API來(lái)對(duì)容器進(jìn)行管理扒磁。因此渗磅，只要所操作的平臺(tái)支持Docker API检访，就可以在其上利用Compose來(lái)進(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 不是有顏色來(lái)區(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將對(duì)不同的服務(wù)輸出使用不同的顏色來(lái)區(qū)分主届≌哉埽可以通過–no-color來(lái)關(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 始終嘗試通過拉取操作來(lái)獲取更新版本的鏡像

-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來(lái)重新構(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命令來(lái)停止容器稠诲。

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ù)來(lái)設(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)來(lái)強(qiáng)制停止服務(wù)容器跨释。

支持通過-s參數(shù)來(lái)指定發(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è)容器辕坝，指定命令對(duì)象容器的序號(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模板文件簡(jiǎn)介

Compose允許用戶通過一個(gè)docker-compose.yml模板文件（YAML 格式）來(lái)定義一組相關(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將來(lái)會(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

?　　也可以是相對(duì)路徑，只要上下文確定就可以讀取到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倉(cāng)庫(kù)的url，當(dāng)提供的值是相對(duì)路徑時(shí)榨惰，被解析為相對(duì)于撰寫文件的路徑拜英，此目錄也是發(fā)送到Docker守護(hù)進(jìn)程的context

build:

??context: ./dir

?　　5,dockerfile

　　使用dockerfile文件來(lái)構(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ù)庫(kù)容器的時(shí)候啟動(dòng)應(yīng)用容器，應(yīng)用容器會(huì)因?yàn)檎也坏綌?shù)據(jù)庫(kù)而退出替饿。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格式來(lái)映射端口時(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]格式竿拆，后者對(duì)于容器來(lái)說(shuō)，數(shù)據(jù)卷是只讀的宾尚，可以有效保護(hù)宿主機(jī)的文件系統(tǒng)丙笋。

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

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

volumes:

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

??-?/var/lib/mysql

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

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

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

??- ./cache:/tmp/cache

??//?使用用戶的相對(duì)路徑（~/ 表示的目錄是?/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