docker-compose(入门,与docker的区别)
Compose 簡(jiǎn)介
Compose 是用于定義和運(yùn)行多容器 Docker 應(yīng)用程序的工具。通過(guò) Compose,您可以使用 YML 文件來(lái)配置應(yīng)用程序需要的所有服務(wù)。然后,使用一個(gè)命令,就可以從 YML 文件配置中創(chuàng)建并啟動(dòng)所有服務(wù)。
如果你還不了解 YML 文件配置,可以先閱讀?YAML 入門(mén)教程。
Compose 使用的三個(gè)步驟:
-
使用 Dockerfile 定義應(yīng)用程序的環(huán)境。
-
使用 docker-compose.yml 定義構(gòu)成應(yīng)用程序的服務(wù),這樣它們可以在隔離環(huán)境中一起運(yùn)行。
-
最后,執(zhí)行 docker-compose up 命令來(lái)啟動(dòng)并運(yùn)行整個(gè)應(yīng)用程序。
docker-compose.yml 的配置案例如下(配置參數(shù)參考下文):
# yaml 配置實(shí)例 version: '3' services:web:build: .ports:- "5000:5000"volumes:- .:/code- logvolume01:/var/loglinks:- redisredis:image: redis volumes:logvolume01: {}實(shí)力二
Compose 安裝
自動(dòng)化安裝
# yum-util 提供 yum-config-manager 功能, 另外兩個(gè)是 devicemapper 驅(qū)動(dòng)依賴(lài) yum install -y yum-utils device-mapper-persistent-data lvm2 # 設(shè)置 yum 源 yum-config-manager --add-repo https://download.docker.com/linux/centos/docker-ce.repo # 安裝依賴(lài) yum install epel-release #安裝python——pip yum install -y python-pip # 使用pip安裝docker-compose pip install docker-compose # 升級(jí)python包 sudo yum upgrade python*手動(dòng)安裝
Linux
Linux 上我們可以從 Github 上下載它的二進(jìn)制包來(lái)使用,最新發(fā)行的版本地址:https://github.com/docker/compose/releases。
運(yùn)行以下命令以下載 Docker Compose 的當(dāng)前穩(wěn)定版本:
$ sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose要安裝其他版本的 Compose,請(qǐng)?zhí)鎿Q 1.24.1。
將可執(zhí)行權(quán)限應(yīng)用于二進(jìn)制文件:
$ sudo chmod +x /usr/local/bin/docker-compose創(chuàng)建軟鏈:
$ sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose測(cè)試是否安裝成功:
$ docker-compose --version cker-compose version 1.24.1, build 4667896b注意: 對(duì)于 alpine,需要以下依賴(lài)包: py-pip,python-dev,libffi-dev,openssl-dev,gcc,libc-dev,和 make。
macOS
Mac 的 Docker 桌面版和 Docker Toolbox 已經(jīng)包括 Compose 和其他 Docker 應(yīng)用程序,因此 Mac 用戶不需要單獨(dú)安裝 Compose。Docker 安裝說(shuō)明可以參閱?MacOS Docker 安裝。
windows PC
Windows 的 Docker 桌面版和 Docker Toolbox 已經(jīng)包括 Compose 和其他 Docker 應(yīng)用程序,因此 Windows 用戶不需要單獨(dú)安裝 Compose。Docker 安裝說(shuō)明可以參閱?Windows Docker 安裝。
使用
1、準(zhǔn)備
創(chuàng)建一個(gè)測(cè)試目錄:
$ mkdir composetest $ cd composetest在測(cè)試目錄中創(chuàng)建一個(gè)名為 app.py 的文件,并復(fù)制粘貼以下內(nèi)容:
import timeimport redis from flask import Flaskapp = Flask(__name__) cache = redis.Redis(host='redis', port=6379)def get_hit_count():retries = 5while True:try:return cache.incr('hits')except redis.exceptions.ConnectionError as exc:if retries == 0:raise excretries -= 1time.sleep(0.5)@app.route('/') def hello():count = get_hit_count()return 'Hello World! I have been seen {} times.\n'.format(count)在此示例中,redis 是應(yīng)用程序網(wǎng)絡(luò)上的 redis 容器的主機(jī)名,該主機(jī)使用的端口為 6379。
在 composetest 目錄中創(chuàng)建另一個(gè)名為 requirements.txt 的文件,內(nèi)容如下:
flask redis2、創(chuàng)建 Dockerfile 文件
在 composetest 目錄中,創(chuàng)建一個(gè)名為的文件 Dockerfile,內(nèi)容如下:
FROM python:3.7-alpine WORKDIR /code ENV FLASK_APP app.py ENV FLASK_RUN_HOST 0.0.0.0 RUN apk add --no-cache gcc musl-dev linux-headers COPY requirements.txt requirements.txt RUN pip install -r requirements.txt COPY . . CMD ["flask", "run"]Dockerfile 內(nèi)容解釋:
- FROM python:3.7-alpine: 從 Python 3.7 映像開(kāi)始構(gòu)建鏡像。
- WORKDIR /code: 將工作目錄設(shè)置為 /code。
- ENV FLASK_APP app.py
ENV FLASK_RUN_HOST 0.0.0.0
設(shè)置 flask 命令使用的環(huán)境變量。
- RUN apk add --no-cache gcc musl-dev linux-headers: 安裝 gcc,以便諸如 MarkupSafe 和 SQLAlchemy 之類(lèi)的 Python 包可以編譯加速。
- COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
復(fù)制 requirements.txt 并安裝 Python 依賴(lài)項(xiàng)。
- COPY . .: 將 . 項(xiàng)目中的當(dāng)前目錄復(fù)制到 . 鏡像中的工作目錄。
- CMD ["flask", "run"]: 容器提供默認(rèn)的執(zhí)行命令為:flask run。
3、創(chuàng)建 docker-compose.yml
在測(cè)試目錄中創(chuàng)建一個(gè)名為 docker-compose.yml 的文件,然后粘貼以下內(nèi)容:
# yaml 配置 version: '3' services:web:build: .ports:- "5000:5000"redis:image: "redis:alpine"該 Compose 文件定義了兩個(gè)服務(wù):web 和 redis。
- web:該 web 服務(wù)使用從 Dockerfile 當(dāng)前目錄中構(gòu)建的鏡像。然后,它將容器和主機(jī)綁定到暴露的端口 5000。此示例服務(wù)使用 Flask Web 服務(wù)器的默認(rèn)端口 5000 。
- redis:該 redis 服務(wù)使用 Docker Hub 的公共 Redis 映像。
4、使用 Compose 命令構(gòu)建和運(yùn)行您的應(yīng)用
在測(cè)試目錄中,執(zhí)行以下命令來(lái)啟動(dòng)應(yīng)用程序:
docker-compose up如果你想在后臺(tái)執(zhí)行該服務(wù)可以加上?-d?參數(shù):
docker-compose up -dyml 配置指令參考
version
指定本 yml 依從的 compose 哪個(gè)版本制定的。
build
指定為構(gòu)建鏡像上下文路徑:
例如 webapp 服務(wù),指定為從上下文路徑 ./dir/Dockerfile 所構(gòu)建的鏡像:
version: "3.7" services:webapp:build: ./dir或者,作為具有在上下文指定的路徑的對(duì)象,以及可選的 Dockerfile 和 args:
version: "3.7" services:webapp:build:context: ./dirdockerfile: Dockerfile-alternateargs:buildno: 1labels:- "com.example.description=Accounting webapp"- "com.example.department=Finance"- "com.example.label-with-empty-value"target: prod- context:上下文路徑。
- dockerfile:指定構(gòu)建鏡像的 Dockerfile 文件名。
- args:添加構(gòu)建參數(shù),這是只能在構(gòu)建過(guò)程中訪問(wèn)的環(huán)境變量。
- labels:設(shè)置構(gòu)建鏡像的標(biāo)簽。
- target:多層構(gòu)建,可以指定構(gòu)建哪一層。
cap_add,cap_drop
添加或刪除容器擁有的宿主機(jī)的內(nèi)核功能。
cap_add:- ALL # 開(kāi)啟全部權(quán)限cap_drop:- SYS_PTRACE # 關(guān)閉 ptrace權(quán)限cgroup_parent
為容器指定父 cgroup 組,意味著將繼承該組的資源限制。
cgroup_parent: m-executor-abcdcommand
覆蓋容器啟動(dòng)的默認(rèn)命令。
command: ["bundle", "exec", "thin", "-p", "3000"]container_name
指定自定義容器名稱(chēng),而不是生成的默認(rèn)名稱(chēng)。
container_name: my-web-containerdepends_on
設(shè)置依賴(lài)關(guān)系。
- docker-compose up :以依賴(lài)性順序啟動(dòng)服務(wù)。在以下示例中,先啟動(dòng) db 和 redis ,才會(huì)啟動(dòng) web。
- docker-compose up SERVICE :自動(dòng)包含 SERVICE 的依賴(lài)項(xiàng)。在以下示例中,docker-compose up web 還將創(chuàng)建并啟動(dòng) db 和 redis。
- docker-compose stop :按依賴(lài)關(guān)系順序停止服務(wù)。在以下示例中,web 在 db 和 redis 之前停止。
注意:web 服務(wù)不會(huì)等待 redis db 完全啟動(dòng) 之后才啟動(dòng)。
deploy
指定與服務(wù)的部署和運(yùn)行有關(guān)的配置。只在 swarm 模式下才會(huì)有用。
可以選參數(shù):
endpoint_mode:訪問(wèn)集群服務(wù)的方式。
endpoint_mode: vip # Docker 集群服務(wù)一個(gè)對(duì)外的虛擬 ip。所有的請(qǐng)求都會(huì)通過(guò)這個(gè)虛擬 ip 到達(dá)集群服務(wù)內(nèi)部的機(jī)器。 endpoint_mode: dnsrr # DNS 輪詢(xún)(DNSRR)。所有的請(qǐng)求會(huì)自動(dòng)輪詢(xún)獲取到集群 ip 列表中的一個(gè) ip 地址。labels:在服務(wù)上設(shè)置標(biāo)簽。可以用容器上的 labels(跟 deploy 同級(jí)的配置) 覆蓋 deploy 下的 labels。
mode:指定服務(wù)提供的模式。
-
replicated:復(fù)制服務(wù),復(fù)制指定服務(wù)到集群的機(jī)器上。
-
global:全局服務(wù),服務(wù)將部署至集群的每個(gè)節(jié)點(diǎn)。
-
圖解:下圖中黃色的方塊是 replicated 模式的運(yùn)行情況,灰色方塊是 global 模式的運(yùn)行情況。
replicas:mode?為 replicated 時(shí),需要使用此參數(shù)配置具體運(yùn)行的節(jié)點(diǎn)數(shù)量。
resources:配置服務(wù)器資源使用的限制,例如上例子,配置 redis 集群運(yùn)行需要的 cpu 的百分比 和 內(nèi)存的占用。避免占用資源過(guò)高出現(xiàn)異常。
restart_policy:配置如何在退出容器時(shí)重新啟動(dòng)容器。
- condition:可選 none,on-failure 或者 any(默認(rèn)值:any)。
- delay:設(shè)置多久之后重啟(默認(rèn)值:0)。
- max_attempts:嘗試重新啟動(dòng)容器的次數(shù),超出次數(shù),則不再?lài)L試(默認(rèn)值:一直重試)。
- window:設(shè)置容器重啟超時(shí)時(shí)間(默認(rèn)值:0)。
rollback_config:配置在更新失敗的情況下應(yīng)如何回滾服務(wù)。
- parallelism:一次要回滾的容器數(shù)。如果設(shè)置為0,則所有容器將同時(shí)回滾。
- delay:每個(gè)容器組回滾之間等待的時(shí)間(默認(rèn)為0s)。
- failure_action:如果回滾失敗,該怎么辦。其中一個(gè) continue 或者 pause(默認(rèn)pause)。
- monitor:每個(gè)容器更新后,持續(xù)觀察是否失敗了的時(shí)間 (ns|us|ms|s|m|h)(默認(rèn)為0s)。
- max_failure_ratio:在回滾期間可以容忍的故障率(默認(rèn)為0)。
- order:回滾期間的操作順序。其中一個(gè) stop-first(串行回滾),或者 start-first(并行回滾)(默認(rèn) stop-first )。
update_config:配置應(yīng)如何更新服務(wù),對(duì)于配置滾動(dòng)更新很有用。
- parallelism:一次更新的容器數(shù)。
- delay:在更新一組容器之間等待的時(shí)間。
- failure_action:如果更新失敗,該怎么辦。其中一個(gè) continue,rollback 或者pause (默認(rèn):pause)。
- monitor:每個(gè)容器更新后,持續(xù)觀察是否失敗了的時(shí)間 (ns|us|ms|s|m|h)(默認(rèn)為0s)。
- max_failure_ratio:在更新過(guò)程中可以容忍的故障率。
- order:回滾期間的操作順序。其中一個(gè) stop-first(串行回滾),或者 start-first(并行回滾)(默認(rèn)stop-first)。
注:僅支持 V3.4 及更高版本。
devices
指定設(shè)備映射列表。
devices:- "/dev/ttyUSB0:/dev/ttyUSB0"dns
自定義 DNS 服務(wù)器,可以是單個(gè)值或列表的多個(gè)值。
dns: 8.8.8.8dns:- 8.8.8.8- 9.9.9.9dns_search
自定義 DNS 搜索域。可以是單個(gè)值或列表。
dns_search: example.comdns_search:- dc1.example.com- dc2.example.comentrypoint
覆蓋容器默認(rèn)的 entrypoint。
entrypoint: /code/entrypoint.sh也可以是以下格式:
entrypoint:- php- -d- zend_extension=/usr/local/lib/php/extensions/no-debug-non-zts-20100525/xdebug.so- -d- memory_limit=-1- vendor/bin/phpunitenv_file
從文件添加環(huán)境變量。可以是單個(gè)值或列表的多個(gè)值。
env_file: .env也可以是列表格式:
env_file:- ./common.env- ./apps/web.env- /opt/secrets.envenvironment
添加環(huán)境變量。您可以使用數(shù)組或字典、任何布爾值,布爾值需要用引號(hào)引起來(lái),以確保 YML 解析器不會(huì)將其轉(zhuǎn)換為 True 或 False。
environment:RACK_ENV: developmentSHOW: 'true'expose
暴露端口,但不映射到宿主機(jī),只被連接的服務(wù)訪問(wèn)。
僅可以指定內(nèi)部端口為參數(shù):
expose:- "3000"- "8000"extra_hosts
添加主機(jī)名映射。類(lèi)似 docker client --add-host。
extra_hosts:- "somehost:162.242.195.82"- "otherhost:50.31.209.229"以上會(huì)在此服務(wù)的內(nèi)部容器中 /etc/hosts 創(chuàng)建一個(gè)具有 ip 地址和主機(jī)名的映射關(guān)系:
162.242.195.82 somehost 50.31.209.229 otherhosthealthcheck
用于檢測(cè) docker 服務(wù)是否健康運(yùn)行。
healthcheck:test: ["CMD", "curl", "-f", "http://localhost"] # 設(shè)置檢測(cè)程序interval: 1m30s # 設(shè)置檢測(cè)間隔timeout: 10s # 設(shè)置檢測(cè)超時(shí)時(shí)間retries: 3 # 設(shè)置重試次數(shù)start_period: 40s # 啟動(dòng)后,多少秒開(kāi)始啟動(dòng)檢測(cè)程序image
指定容器運(yùn)行的鏡像。以下格式都可以:
image: redis image: ubuntu:14.04 image: tutum/influxdb image: example-registry.com:4000/postgresql image: a4bc65fd # 鏡像idlogging
服務(wù)的日志記錄配置。
driver:指定服務(wù)容器的日志記錄驅(qū)動(dòng)程序,默認(rèn)值為json-file。有以下三個(gè)選項(xiàng)
driver: "json-file" driver: "syslog" driver: "none"僅在 json-file 驅(qū)動(dòng)程序下,可以使用以下參數(shù),限制日志得數(shù)量和大小。
logging:driver: json-fileoptions:max-size: "200k" # 單個(gè)文件大小為200kmax-file: "10" # 最多10個(gè)文件當(dāng)達(dá)到文件限制上限,會(huì)自動(dòng)刪除舊得文件。
syslog 驅(qū)動(dòng)程序下,可以使用 syslog-address 指定日志接收地址。
logging:driver: syslogoptions:syslog-address: "tcp://192.168.0.42:123"network_mode
設(shè)置網(wǎng)絡(luò)模式。
network_mode: "bridge" network_mode: "host" network_mode: "none" network_mode: "service:[service name]" network_mode: "container:[container name/id]"networks
配置容器連接的網(wǎng)絡(luò),引用頂級(jí) networks 下的條目 。
services:some-service:networks:some-network:aliases:- alias1other-network:aliases:- alias2 networks:some-network:# Use a custom driverdriver: custom-driver-1other-network:# Use a custom driver which takes special optionsdriver: custom-driver-2aliases?:同一網(wǎng)絡(luò)上的其他容器可以使用服務(wù)名稱(chēng)或此別名來(lái)連接到對(duì)應(yīng)容器的服務(wù)。
restart
- no:是默認(rèn)的重啟策略,在任何情況下都不會(huì)重啟容器。
- always:容器總是重新啟動(dòng)。
- on-failure:在容器非正常退出時(shí)(退出狀態(tài)非0),才會(huì)重啟容器。
- unless-stopped:在容器退出時(shí)總是重啟容器,但是不考慮在Docker守護(hù)進(jìn)程啟動(dòng)時(shí)就已經(jīng)停止了的容器
注:swarm 集群模式,請(qǐng)改用 restart_policy。
secrets
存儲(chǔ)敏感數(shù)據(jù),例如密碼:
version: "3.1" services:mysql:image: mysqlenvironment:MYSQL_ROOT_PASSWORD_FILE: /run/secrets/my_secretsecrets:- my_secretsecrets:my_secret:file: ./my_secret.txtsecurity_opt
修改容器默認(rèn)的 schema 標(biāo)簽。
security-opt:- label:user:USER # 設(shè)置容器的用戶標(biāo)簽- label:role:ROLE # 設(shè)置容器的角色標(biāo)簽- label:type:TYPE # 設(shè)置容器的安全策略標(biāo)簽- label:level:LEVEL # 設(shè)置容器的安全等級(jí)標(biāo)簽stop_grace_period
指定在容器無(wú)法處理 SIGTERM (或者任何 stop_signal 的信號(hào)),等待多久后發(fā)送 SIGKILL 信號(hào)關(guān)閉容器。
stop_grace_period: 1s # 等待 1 秒 stop_grace_period: 1m30s # 等待 1 分 30 秒默認(rèn)的等待時(shí)間是 10 秒。
stop_signal
設(shè)置停止容器的替代信號(hào)。默認(rèn)情況下使用 SIGTERM 。
以下示例,使用 SIGUSR1 替代信號(hào) SIGTERM 來(lái)停止容器。
stop_signal: SIGUSR1sysctls
設(shè)置容器中的內(nèi)核參數(shù),可以使用數(shù)組或字典格式。
sysctls:net.core.somaxconn: 1024net.ipv4.tcp_syncookies: 0sysctls:- net.core.somaxconn=1024- net.ipv4.tcp_syncookies=0tmpfs
在容器內(nèi)安裝一個(gè)臨時(shí)文件系統(tǒng)。可以是單個(gè)值或列表的多個(gè)值。
tmpfs: /runtmpfs:- /run- /tmpulimits
覆蓋容器默認(rèn)的 ulimit。
ulimits:nproc: 65535nofile:soft: 20000hard: 40000volumes
將主機(jī)的數(shù)據(jù)卷或著文件掛載到容器里。
version: "3.7" services:db:image: postgres:latestvolumes:- "/localhost/postgres.sock:/var/run/postgres/postgres.sock"- "/localhost/data:/var/lib/postgresql/data"?
總結(jié)
以上是生活随笔為你收集整理的docker-compose(入门,与docker的区别)的全部?jī)?nèi)容,希望文章能夠幫你解決所遇到的問(wèn)題。
- 上一篇: git 命令整理
- 下一篇: PHP服务器环境打开配置文件