Docker-Compose 是什么黍少?
Docker-Compose 項(xiàng)目是 Docker 官方的開源項(xiàng)目,負(fù)責(zé)實(shí)現(xiàn)對(duì) Docker 容器集群的快速編排筷凤。Docker-Compose 的工程配置文件名是默認(rèn)為 docker-compose.yml
的活合,在整個(gè)文件中,我們可以通過環(huán)境變量 COMPOSE_FILE
或者 -f
參數(shù)來對(duì)配置進(jìn)行定義过椎。我們可以看一個(gè)很簡(jiǎn)單的 docker-compose.yml
的配置文件:
couchdb:
container_name: couchdb
image: hyperledger/fabric-couchdb
# Populate the COUCHDB_USER and COUCHDB_PASSWORD to set an admin user and password
# for CouchDB. This will prevent CouchDB from operating in an "Admin Party" mode.
environment:
- COUCHDB_USER=
- COUCHDB_PASSWORD=
# Comment/Uncomment the port mapping if you want to hide/expose the CouchDB service,
# for example map it to utilize Fauxton User Interface in dev environments.
ports:
- "5984:5984"
這就是一個(gè)通過 docker-compose.yml
配置實(shí)現(xiàn) CouchDB 在 Docker 中運(yùn)行的配置實(shí)例。
Docker-Compose 是用 Python 來編寫的戏仓,我們可以通過 pip
命令進(jìn)行對(duì) Docker-Compose 的安裝疚宇,之后就調(diào)用Docker服務(wù)提供的API來對(duì)容器進(jìn)行管理。因此赏殃,只要所操作的平臺(tái)支持Docker API敷待,就可以在其上利用Compose來進(jìn)行編排管理。
Docker-Compose 怎么用仁热?
具體的安裝過程榜揖,因?yàn)榉N類繁多,而且可以很容易的找到,因此在這里不過多說明举哟。但是在 Windows 中使用時(shí)钳幅,一定要保證 Windows 是可以安裝 Docker 的。我們具體要說的是關(guān)于 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)將使用所在目錄名稱作為項(xiàng)目名。
-x-network-driver 使用 Docker 的可拔插網(wǎng)絡(luò)后端特性(需要Docker 1.9+版本)
-x-network-driver DRIVER 指定網(wǎng)絡(luò)后端的驅(qū)動(dòng)扼睬,默認(rèn)為 bridge(需要Docker 1.9+版本)
-verbose 輸出更多調(diào)試信息
-v逮栅,–version 打印版本并退出
2、Docker-Compose 啟動(dòng)格式
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文件中定義的容器
–scale SERVICE=NUM 設(shè)置服務(wù)運(yùn)行容器的個(gè)數(shù),將覆蓋在compose中通過scale指定的參數(shù)
docker-compose up
啟動(dòng)所有服務(wù)--這是我們最常用的命令格式
docker-compose up -d
在后臺(tái)所有啟動(dòng)服務(wù)--需要在后臺(tái)使用時(shí)可以通過添加 -d 來后臺(tái)啟動(dòng)
-f 指定使用的 Compose 模板文件粪躬,默認(rèn)為docker-compose.yml担败,可以多次指定。
3镰官、Docker-Compose 查看格式
docker-compose ps [options] [SERVICE...]
這條命令與 Docker 中查看容器的命令基本功能和方法是一樣的提前。一般我們使用的是 docker-compose ps
。
4泳唠、Docker-Compose 終止格式
docker-compose stop [options] [SERVICE...]
選項(xiàng)包括:
-t, –timeout TIMEOUT 停止容器時(shí)候的超時(shí)(默認(rèn)為10秒)
我們?cè)趫?zhí)行 stop 命令之后狈网,是需要通過 docker-compose start
來啟動(dòng)的,而不是剛才我們所講的 up
命令警检。
5孙援、Docker-Compose 停止格式
docker-compose down [options]
選項(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)--最常用的格式
6哨苛、Docker-Compose 日志格式
docker-compose logs [options][SERVICE...]
默認(rèn)情況下使用 docker-compose logs
來查看服務(wù)容器的輸出鸽凶,或者我們可以通過指定 --no-color
來關(guān)閉顏色。
7建峭、Docker-Compose build
docker-compose build [options] [--build-arg key=val...] [SERVICE...]
選項(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ù)凑兰。
8、Docker-Compose pull
docker-compose pull [options] [SERVICE...]
選項(xiàng)包括:
–ignore-pull-failures边锁,忽略拉取鏡像過程中的錯(cuò)誤
–parallel姑食,多個(gè)鏡像同時(shí)拉取
–quiet,拉取鏡像過程中不打印進(jìn)度信息
docker-compose pull
拉取服務(wù)依賴的鏡像茅坛。
9音半、Docker-Compose restart
docker-compose restart [options] [SERVICE...]
選項(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命令來停止容器斥铺。
10物延、Docker-Compose start
docker-compose start [SERVICE...]
啟動(dòng)已經(jīng)存在的服務(wù)容器。
11仅父、Docker-Compose run
docker-compose run [options] [-v VOLUME...] [-p PORT...] [-e KEY=VAL...] SERVICE [COMMAND] [ARGS...]
docker-compose run ubuntu ping www.baidu.com
在指定容器上執(zhí)行一個(gè)ping命令叛薯。
12、Docker-Compose scale
docker-compose scale web=3 db=2
設(shè)置指定服務(wù)運(yùn)行的容器個(gè)數(shù)笙纤。通過service=num
的參數(shù)來設(shè)置數(shù)量耗溜。
13、Docker-Compose pause
docker-compose pause [SERVICE...]
暫停一個(gè)服務(wù)容器省容。
14抖拴、Docker-Compose rm
docker-compose rm [options] [SERVICE...]
選項(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命令來停止容器笼蛛。
15洒放、Docker-Compose kill
docker-compose kill [options] [SERVICE...]
支持通過 -s
參數(shù)來指定發(fā)送的信號(hào),例如通過如下指令發(fā)送 SIGINT 信號(hào):
docker-compose kill -s SIGINT
16滨砍、Docker-Compose config
docker-compose [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è)
17、Docker-Compose create
docker-compose create [options] [SERVICE...]
選項(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)建容器前,生成鏡像
18葬燎、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è)容器
19、Docker-Compose port
docker-compose port [options] SERVICE PRIVATE_PORT
選項(xiàng)包括:
–protocol=proto导盅,指定端口協(xié)議较幌,TCP(默認(rèn)值)或者UDP
–index=index,如果同意服務(wù)存在多個(gè)容器白翻,指定命令對(duì)象容器的序號(hào)(默認(rèn)為1)
20乍炉、Docker-Compose push
docker-compose push [options] [SERVICE...]
選項(xiàng)包括:
–ignore-push-failures 忽略推送鏡像過程中的錯(cuò)誤
21、Docker-Compose unpause
docker-compose unpause [SERVICE...]
恢復(fù)處于暫停狀態(tài)中的服務(wù)滤馍。
22岛琼、Docker-Compose version
docker-compose version
用于打印版本信息。
Docker-Compose 怎么寫巢株?
Docker-Compose標(biāo)準(zhǔn)模板文件應(yīng)該包含version槐瑞、services、networks 三大部分纯续,最關(guān)鍵的是services和networks兩個(gè)部分随珠。我們想要實(shí)現(xiàn)對(duì)其的配置灭袁,就要通過 docker-compose.yml 來實(shí)現(xiàn)猬错。
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ì)被棄用拉讯。
image
image是指定服務(wù)的鏡像名稱或鏡像ID。如果鏡像在本地不存在鳖藕,Compose將會(huì)嘗試?yán)$R像魔慷。
image: dockercloud/hello-world
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ù)容器。
build: /path/to/build/dir
也可以是相對(duì)路徑伍茄,只要上下文確定就可以讀取到Dockerfile栋盹。
build: ./dir
設(shè)定上下文根目錄,然后以該目錄為準(zhǔn)指定Dockerfile敷矫。
context
context 選項(xiàng)可以是 Dockerfile 的文件路徑例获,也可以是到鏈接到 git 倉(cāng)庫(kù)的 url,當(dāng)提供的值是相對(duì)路徑時(shí)曹仗,被解析為相對(duì)于撰寫文件的路徑榨汤,此目錄也是發(fā)送到 Docker 守護(hù)進(jìn)程的 context
build:
context: ./dir
dockerfile
使用dockerfile文件來構(gòu)建,必須指定構(gòu)建路徑
build:
context: ./dir
dockerfile: Dokcerfile-alternate
command
使用command可以覆蓋容器啟動(dòng)后默認(rèn)執(zhí)行的命令
command:
bundle exec thin -p 3000
container_name
Compose的容器名稱格式是:<項(xiàng)目名稱><服務(wù)名稱><序號(hào)>
可以自定義項(xiàng)目名稱整葡、服務(wù)名稱件余,但如果想完全控制容器的命名,可以使用標(biāo)簽指定:
container_name:
app
depends_on
depends_on:
- couchdb
- redis
這里就是代替啟動(dòng)命令的執(zhí)行內(nèi)容遭居,一般按照順序來執(zhí)行啼器。例如上面這個(gè)語(yǔ)句,執(zhí)行的就是 couchdb 和 redis 兩個(gè)服務(wù)俱萍。
ports
ports用于映射端口的標(biāo)簽端壳。
ports:
- "3000:3000"
extra_hosts
添加主機(jī)名的標(biāo)簽,會(huì)在/etc/hosts文件中添加一些記錄枪蘑。
extra_hosts:
- "somehost:162.242.195.82"
- "otherhost:50.31.209.229"
volumes
掛載一個(gè)目錄或者一個(gè)已存在的數(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
dns
dns: 8.8.8.8
dns:
- 8.8.8.8
自定義一個(gè) dns 服務(wù)器闯参。
dns_search
dns_search: example.com
dns_search:
- domin1.example.com
- domin2.example.com
配置DNS搜索域”ⅲ可以是一個(gè)值鹿寨,也可以是一個(gè)列表。
entrypoint
定義接入點(diǎn)薪夕,覆蓋 Dockerfile 中的定義:
entrypoint: /code/entrypoint.sh
env_file
定義一個(gè)專門存放變量的文件:
env_file:
- ./common.env
- ./apps/web.env
- /opt/secrets.env
如果有變量名稱與 environment 指令沖突脚草,則以后者為準(zhǔn)。
cap_add
增加指定容器的內(nèi)核能力(capacity):
cap_add:
- ALL
cap_drop
與上面一條命令相反原献,去掉指定容器的內(nèi)核能力(capacity):
cap_drop:
- NET_ADMIN
cgroup_parent
創(chuàng)建一個(gè) cgroup 組:
cgroup_parent: cgroups_1
devices
指定設(shè)備映射關(guān)系:
devices:
- "/dev/ttyUSB1:/DEV/ttyUSB0"
expose
暴露端口馏慨,但不映射到宿主機(jī),只允許能被連接的服務(wù)訪問嚼贡。僅可以指定內(nèi)部端口為參數(shù):
expose:
- "3000"
- "8000"
extends
基于其他模板文件進(jìn)行擴(kuò)展:
webapp:
build: ./webapp
environment:
- DEBUG=false
- SEND_EMAILS=false
再編寫一個(gè)新的 development.yml
文件熏纯,使用 common.yml
中的webapp
服務(wù)進(jìn)行擴(kuò)展:
# development.yml
web:
extends:
file: common.yml
service: webapp
ports:
- "8000:8000"
links:
- db
environment:
- DEBUG=true
db:
image: mysql
后者會(huì)自動(dòng)繼承 common.yml
中的 webapp
服務(wù)及環(huán)境變量定義。
external_links
鏈接到docker-compose.yml
外部的容器粤策,可以是非Compose管理的外部容器樟澜。
external_links:
- redis_1
- project_db_1:mysql
- project_db_1:postgresql
label
為容器添加元數(shù)據(jù)信息:
labels:
com.startupteam.description: "webapp for a startup team"
links
鏈接到其它服務(wù)中的容器:
links:
- db
- db:database
- redis
log_driver
指定日志驅(qū)動(dòng)類型。目前支持三種日志驅(qū)動(dòng)類型:
log_driver: "json-file"
log_driver: "syslog"
log_driver: "none"
log_opt
日志驅(qū)動(dòng)的相關(guān)參數(shù):
log_driver: "syslog"
log_opt:
syslog-address: "tcp://192.168.0.42:8080"
net
設(shè)置網(wǎng)絡(luò)格式:
net: "bridge"
net: "none"
net: "host"
security_opt
指定容器模板標(biāo)簽(label)機(jī)制的默認(rèn)屬性(用戶叮盘、角色秩贰、類型、級(jí)別等)柔吼。例如毒费,配置標(biāo)簽的用戶名和角色名:
security_opt:
- label:user:USER
- label:role:ROLE