本文介紹compose配置文件參數(shù)的使用，熟練編寫compose文件

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build: /root/docker_demo/nginx/ports:- "80:80"links:- php:phpvolumes:- "/www:/usr/local/nginx/html"php:image: phpexpose:- "9000"volumes:- "/www:/usr/local/nginx/html"

上面的一個例子version代表版本

什么版本的docker-compose對應什么版本的docker：

services就是compose中定義的服務，compose管理的是project、service、container，project如果沒有指定就是默認的lnmp.yml文件的lnmp

nginx、php就是屬于services的子集欄，定義了兩個service

nginx服務中有各種參數(shù)：

build：和docker中的build構(gòu)建一樣，后面的路徑指向Dockerfile的位置：

[root@docker lnmp]# ll /root/docker_demo/nginx/ total 832 -rw-r--r--. 1 root root 1133 Nov 6 13:40 Dockerfile -rw-r--r--. 1 root root 1033 Nov 6 10:17 fastcgi_params -rw-r--r--. 1 root root 833473 Nov 6 09:35 nginx-1.8.1.tar.gz -rw-r--r--. 1 root root 776 Nov 6 10:16 nginx.conf -rw-r--r--. 1 root root 341 Nov 6 16:43 www.conf

ports參數(shù)就是docker在docker run啟動容器時-p選項的意思差不多，映射到本機host，前者的端口是本機host，后面是container_port

links參數(shù)也是docker run在啟動容器時--link選項的意思差不多，用于與容器間的互聯(lián)訪問，php:php，前者php是定義的service名稱，后者的php是給它定義了一個別名

volumes：與docker run在啟動容器時-v選項的意思差不多，用于host與container之間的映射掛載，前者是host_mount_dir，后面是container中的目錄

volumes:# Just specify a path and let the Engine create a volume- /var/lib/mysql# Specify an absolute path mapping- /opt/data:/var/lib/mysql# Path on the host, relative to the Compose file- ./cache:/tmp/cache# User-relative path- ~/configs:/etc/configs/:ro# Named volume- datavolume:/var/lib/mysql

在下面的php這個service中：

image：代表的就是使用的docker images中的某個鏡像名稱去開啟container（默認tag為latest），如果本地沒有鏡像將會進行pull　

image: redis image: ubuntu:14.04 image: tutum/influxdb image: example-registry.com:4000/postgresql image: a4bc65fd

有了上面的第一個簡單的compose yml文件，于是進行啟動container：

[root@docker lnmp]# docker-compose -f lnmp.yaml up --build

由于我這里進行了配置文件的修改，所以不再單獨的up，而是up --build（If you change a service’s Dockerfile or the contents of its build directory, run?docker-compose build?to rebuild it.）

單獨的docker-compose?-f lnmp.yaml build只會進行build而不會進行啟動容器，之后還需進行docker-compose?-f lnmp.yaml up

?build: /root/docker_demo/nginx/，build參數(shù)這里可以指定解決路徑也可以以compose的項目路徑的相對路徑進行指定

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfile

build參數(shù)的子集也可以根據(jù)Dockerfile構(gòu)建的context來進行build

在build子集中還有args的使用，配合Dockerfile中的ARG結(jié)合使用

[root@docker nginx]# cat Dockerfile FROM centos_init:v2MAINTAINER json_hc@163.com ARG buildno RUN echo "Build number: $buildno"

上面的Dockerfile中定義了build，但是并沒有賦值，RUN執(zhí)行打印這個值，而在compose的yml中：

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:buildno: 2

定義了buildno的值，于是在docker-compose執(zhí)行構(gòu)建時使用了這個值，下面是過程

如果僅僅在yml文件中定義了args變量，而沒有在Dockerfile中定義相同的變量，將會報錯：

[Warning] One or more build-args [foo] were not consumed.

ARG在Dockerfile中的用法：

ARG <name>[=<default value>] 設置變量命令，ARG命令定義了一個變量，在docker build創(chuàng)建鏡像的時候，使用 --build-arg <varname>=<value>來指定參數(shù)ARG user1 ARG buildno 或者定義默認值ARG user1=someuser ARG buildno=1

ARG只是在build構(gòu)建過程中使用，構(gòu)建完成后，變量將會消失和ENV有著明顯的區(qū)別

而在compose的yml文件中args的定義：

build:context: .args:buildno: 1password: secretbuild:context: .args:- buildno=1- password=secret

上面兩種方式都可以

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:- buildno=2

command參數(shù)，覆蓋容器內(nèi)默認的命令

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:- buildno=2command: ["/usr/local/nginx/sbin/nginx"]

這里定義command的命令，而Dockerfile中的nginx的啟動命令：

CMD ["/usr/local/nginx/sbin/nginx","-g","daemon off;"]

所以在[root@docker lnmp]# docker-compose -f lnmp.yaml up --build

構(gòu)建并啟動時并不會成功：

可以明顯的看到command定義的命令替換掉了Dockerfile中的CMD命令

?

container_name：自定義容器名

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:- buildno=2container_name: lnmp-nginx

可以看見nginx服務的容器名已經(jīng)改為lnmp-nginx了

?

depends_on:定義服務間的依賴關系

比如數(shù)據(jù)庫db，必須在web啟動之前進行啟動，也就是說web啟動依賴db的啟動

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:- buildno=2container_name: lnmp-nginxdepends_on:- dbports:- "80:80"links:- php:phpvolumes:- "/www:/usr/local/nginx/html"php:image: phpexpose:- "9000"volumes:- "/www:/usr/local/nginx/html"db:image: mysqlports:- "3306:3306"environment:MYSQL_ROOT_PASSWORD: redhatMYSQL_DATABASE: wordpressMYSQL_USER: wordpressMYSQL_PASSWORD: wordpress

可以看出nginx服務是最后啟動容器的，由于nginx依賴db，而php與nginx有l(wèi)ink，所以nginx最后啟動

?

dns：設置dns

dns: 8.8.8.8 dns:- 8.8.8.8- 9.9.9.9

可以設置是一個單一值，也可以是一個列表

?

dns_search：自定義搜索域：

dns_search: example.com dns_search:- dc1.example.com- dc2.example.com

可以設置為單一值，也可以是一個列表

?

entrypoint：覆蓋Dockerfile中的entrypoint，用法同Dockerfile中的用法

[root@docker lnmp]# cat lnmp.yaml version: '3' services:nginx:build:context: /root/docker_demo/nginx/dockerfile: /root/docker_demo/nginx/Dockerfileargs:- buildno=2container_name: lnmp-nginxentrypoint: ["/usr/local/nginx/sbin/nginx","-g","daemon off;"]

[root@docker lnmp]# docker-compose -f lnmp.yaml ps Name Command State Ports ---------------------------------------------------------------------------- lnmp-nginx /usr/local/nginx/sbin/ngin ... Up 0.0.0.0:80->80/tcp lnmp_db_1 docker-entrypoint.sh mysqld Up 0.0.0.0:3306->3306/tcp lnmp_php_1 /usr/local/php/sbin/php-fpm Up 9000/tcp

?

env_file：將定義的變量編寫在文件中，然后在yml文件中進行添加

env_file: .envenv_file:- ./common.env- ./apps/web.env- /opt/secrets.env

創(chuàng)建env_file文件mysql_env.txt：

[root@docker lnmp]# ll total 16 -rw-r--r--. 1 root root 477 Nov 9 17:00 docker-compose.yml.bak -rw-r--r--. 1 root root 550 Nov 10 15:45 lnmp.yaml -rw-r--r--. 1 root root 271 Nov 10 10:26 lnmp.yaml.bak -rw-r--r--. 1 root root 98 Nov 10 15:46 mysql_env.txt

查看定義的變量：

[root@docker lnmp]# cat mysql_env.txt MYSQL_ROOT_PASSWORD=redhat MYSQL_DATABASE=wordpress MYSQL_USER=wordpress MYSQL_PASSWORD=wordpress

變量的定義格式為這樣

然后進行docker-compose：

[root@docker lnmp]# docker-compose -f lnmp.yaml up --build

進入到db服務中進行驗證變量是否創(chuàng)建成功：

[root@docker nginx]# docker-compose -f /root/compose_project/lnmp/lnmp.yaml exec db sh # mysql -uroot -p Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 3 Server version: 5.7.20 MySQL Community Server (GPL)Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | mysql | | performance_schema | | sys | | wordpress | +--------------------+ 5 rows in set (0.00 sec)mysql>

可以看見MySQL的root密碼已經(jīng)設置，也創(chuàng)建了數(shù)據(jù)庫wordpress等等

?

environment：添加環(huán)境變量，可以是一個字典也可以是數(shù)組

environment:RACK_ENV: developmentSHOW: 'true'SESSION_SECRET:environment:- RACK_ENV=development- SHOW=true- SESSION_SECRET db:image: mysqlports:- "3306:3306"environment:- MYSQL_ROOT_PASSWORD=redhat- MYSQL_DATABASE=wordpress- MYSQL_USER=wordpress- MYSQL_PASSWORD=wordpress

定義完成后進行構(gòu)建并啟動后，進行驗證：

[root@docker nginx]# docker-compose -f /root/compose_project/lnmp/lnmp.yaml exec db sh # mysql -uroot -p Enter password: Welcome to the MySQL monitor. Commands end with ; or \g. Your MySQL connection id is 3 Server version: 5.7.20 MySQL Community Server (GPL)Copyright (c) 2000, 2017, Oracle and/or its affiliates. All rights reserved.Oracle is a registered trademark of Oracle Corporation and/or its affiliates. Other names may be trademarks of their respective owners.Type 'help;' or '\h' for help. Type '\c' to clear the current input statement.mysql> show databases; +--------------------+ | Database | +--------------------+ | information_schema | | mysql | | performance_schema | | sys | | wordpress | +--------------------+ 5 rows in set (0.00 sec)mysql>

?

expose：暴露container的端口，但是并沒有映射到host主機上，用法類似于Dockerfile中的EXPOSE

php:image: phpexpose:- "9000"volumes:- "/www:/usr/local/nginx/html"

?

external_links：

external_links:- redis_1- project_db_1:mysql- project_db_1:postgresql

?鏈接到 docker-compose.yml 外部的容器，甚至 并非?Compose?管理的容器。參數(shù)格式跟?links?類似。

這個參數(shù)下篇文章有介紹

?

extra_hosts：添加hostname映射，類似于docker cli下面的--add-host

extra_hosts:- "www.hcstart.com:192.168.101.14"

然后將這個compose file進行up：

[root@docker lnmp]# docker-compose -f lnmp.yml up --build Creating network "lnmp_net1" with driver "bridge" Creating lnmp-php ... Creating lnmp-php ... done Creating lnmp-nginx ... Creating lnmp-nginx ... done Attaching to lnmp-php, lnmp-nginx [root@docker lnmp]# docker-compose -f lnmp.yml exec nginx cat /etc/hosts 127.0.0.1 localhost ::1 localhost ip6-localhost ip6-loopback fe00::0 ip6-localnet ff00::0 ip6-mcastprefix ff02::1 ip6-allnodes ff02::2 ip6-allrouters 192.168.101.14 www.hcstart.com 172.19.0.3 35cc14084be9

上面的/etc/hosts就可以看見剛剛加入的www.hctsrat.com映射了

?

healthcheck：配置一個檢查去測試服務中的容器是否運行正常

[root@docker lnmp]# cat lnmp.yml|grep health -A 4healthcheck:test: ["CMD", "curl", "-f", "http://localhost"]interval: 1m30stimeout: 10sretries: 3

查看healthcheck的狀態(tài)輸出：

[root@docker lnmp]# docker inspect lnmp-nginx "Health": {"Status": "healthy","FailingStreak": 0,"Log": [{"Start": "2017-10-27T03:52:37.921723965-04:00","End": "2017-10-27T03:52:38.021941235-04:00","ExitCode": 0,"Output": " % Total % Received % Xferd Average Speed Time Time Time Current\n Dload Upload Total Spent Left Speed\n\r 0 0 0 0 0 0 0 0 --:--:-- --:--:-- --:--:-- 0<h1>hello nginx and php</h1>\n\r100 29 100 29 0 0 5741 0 --:--:-- --:--:-- --:--:-- 7250\n"},

healthcheck中選項的詳解：https://docs.docker.com/engine/reference/builder/#healthcheck

?

labels:添加元數(shù)據(jù)到container中，查看現(xiàn)有容器的labels：

[root@docker lnmp]# docker inspect -f {{.Config.Labels}} lnmp-nginx map[com.docker.compose.oneoff:False com.docker.compose.service:nginx com.docker.compose.version:1.17.0 license:GPLv2 vendor:CentOS build-date:20170911 com.docker.compose.config-hash:edaa6c6d8f12639e28cb4bcdffda4961ef5a90f076e9017b204dacda56525e5b com.docker.compose.container-number:1 com.docker.compose.project:lnmp name:CentOS Base Image]

?

logging：為服務配置記錄日志

[root@docker lnmp]# cat lnmp.yml|grep logging -A 4logging:driver: "json-file"options:max-size: "2000k"max-file: "10"

logging支持很多driver，而每一個driver對應的options都不一樣：

[root@docker lnmp]# docker inspect -f {{.HostConfig.LogConfig}} lnmp-nginx {json-file map[max-file:10 max-size:2000k]} [root@docker lnmp]# docker info |grep 'Logging Driver' Logging Driver: json-file

更多其他的driver查看：https://docs.docker.com/engine/admin/logging/overview/

?

sysctls：在容器中設置內(nèi)核參數(shù)

sysctls:net.core.somaxconn: 1024net.ipv4.tcp_syncookies: 0sysctls:- net.core.somaxconn=1024- net.ipv4.tcp_syncookies=0

?

總結(jié)

以上是生活随笔為你收集整理的compose配置文件参数详解的全部內(nèi)容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網(wǎng)站內(nèi)容還不錯，歡迎將生活随笔推薦給好友。