Docker系列06:Docker-compose
1 什麽是Docker-Compose
Compose項目來源於之前的fig項目,使用python語言編寫,與docker/swarm配合度很高。
Compose 是 Docker 容器進行編排的工具,定義和運行多容器的應用,可以一條命令啟動多個容器,使用Docker Compose不再需要使用shell腳本來啟動容器。
Compose 通過一個配置文件來管理多個Docker容器,在配置文件中,所有的容器通過services來定義,然後使用docker-compose腳本來啟動,停止和重啟應用,和應用中的服務以及所有依賴服務的容器,非常適合組合使用多個容器進行開發的場景。
docker-compose默認的模板文件是 docker-compose.yml,其中定義的每個服務都必須通過 image 指令指定鏡像或 build 指令(需要 Dockerfile)來自動構建。
其它大部分指令都跟 docker run 中的類似。
如果使用 build 指令,在 Dockerfile 中設置的選項(例如:CMD, EXPOSE, VOLUME, ENV 等) 將會自動被獲取,無需在 docker-compose.yml 中再次設置。
使用Compose 基本上分為三步:
1.Dockerfile 定義應用的運行環境
2.docker-compose.yml 定義組成應用的各服務
3.docker-compose up 啟動整個應用
2.安裝Compose
兩種docker-compose安裝方式
2.1 從github上下載docker-compose二進制文件安裝
下載最新版的docker-compose文件
$ sudo curl -L https://github.com/docker/compose/releases/download/1.23.2/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
添加可執行權限
$ sudo chmod +x /usr/local/bin/docker-compose
測試安裝結果
$ docker-compose --version docker-compose version 1.23.2, build 1110ad01
2.2 pip安裝
2..2.1 安裝python-pip
sudo yum -y install epel-release sudo yum -y install python-pip
2.2.2 安裝docker-compose
sudo pip install docker-compose
待安裝完成後,執行查詢版本的命令,即可安裝docker-compose
$ docker-compose version docker-compose version 1.23.2, build 1110ad01 docker-py version: 3.3.0 CPython version: 2.7.5 OpenSSL version: OpenSSL 1.0.2k-fips 26 Dec 2018
3 docker-compose.yml 配置文件詳解
docker-compose文件結構,官方提供了一個 yaml Docker Compose 配置文件的標準例子
version: "3"
services:
redis:
image: redis:alpine
ports:
- "6379"
networks:
- frontend
deploy:
replicas: 2
update_config:
parallelism: 2
delay: 10s
restart_policy:
condition: on-failure
db:
image: postgres:9.4
volumes:
- db-data:/var/lib/postgresql/data
networks:
- backend
deploy:
placement:
constraints: [node.role == manager]
vote:
image: dockersamples/examplevotingapp_vote:before
ports:
- 5000:80
networks:
- frontend
depends_on:
- redis
deploy:
replicas: 2
update_config:
parallelism: 2
restart_policy:
condition: on-failure
result:
image: dockersamples/examplevotingapp_result:before
ports:
- 5001:80
networks:
- backend
depends_on:
- db
deploy:
replicas: 1
update_config:
parallelism: 2
delay: 10s
restart_policy:
condition: on-failure
worker:
image: dockersamples/examplevotingapp_worker
networks:
- frontend
- backend
deploy:
mode: replicated
replicas: 1
labels: [APP=VOTING]
restart_policy:
condition: on-failure
delay: 10s
max_attempts: 3
window: 120s
placement:
constraints: [node.role == manager]
visualizer:
image: dockersamples/visualizer:stable
ports:
- "8080:8080"
stop_grace_period: 1m30s
volumes:
- "/var/run/docker.sock:/var/run/docker.sock"
deploy:
placement:
constraints: [node.role == manager]
networks:
frontend:
backend:
volumes:
db-data:
一份標準配置文件應該包含 version、services、networks 三大部分,其中最關鍵的就是 services 和 networks 兩個部分
3.1 文件配置
compose 文件是一個定義服務、 網絡和卷的 YAML 文件 。Compose 文件的默認路徑是 ./docker-compose.yml
服務定義包含應用於為該服務啟動的每個容器的配置,就像傳遞命令行參數一樣 docker container create。同樣,網絡和卷的定義類似於 docker network create 和 docker volume create。
正如 docker container create 在 Dockerfile 指定選項,如 CMD、 EXPOSE、VOLUME、ENV,在默認情況下,你不需要再次指定它們docker-compose.yml。
可以使用 Bash 類 ${VARIABLE} 語法在配置值中使用環境變量。
提示: 可以是用 .yml 或 .yaml 作為文件擴展名
3.2 版本
Compose目前為止有三個版本分別為Version 1,Version 2,Version 3,Compose區分Version 1和Version 2(Compose 1.6.0+,Docker Engine 1.10.0+)。Version 2支持更多的指令。Version 1沒有聲明版本默認是"version 1"。Version 1將來會被棄用。
3.3 配置選項
3.3.1 bulid
服務除了可以基於指定的鏡像,還可以基於一份 Dockerfile,在使用 up 啟動之時執行構建任務,這個構建標簽就是 build,它可以指定 Dockerfile 所在文件夾的路徑。Compose 將會利用它自動構建這個鏡像,然後使用這個鏡像啟動服務容器
build: /path/to/build/dir
也可以是相對路徑
build: ./dir
設定上下文根目錄,然後以該目錄為準指定 Dockerfile
build: context: ../ dockerfile: path/of/Dockerfile
3.3.2 context
context 選項可以是 Dockerfile 的文件路徑,也可以是到鏈接到 git 倉庫的url,當提供的值是相對路徑時,它被解析為相對於撰寫文件的路徑,此目錄也是發送到 Docker 守護進程的 context
build: context: ./dir
3.3.3. dockerfile
使用此 dockerfile 文件來構建,必須指定構建路徑
build:
context: .
dockerfile: Dockerfile-alternate
3.3.4 image
services:
web:
image: nginx
在 services 標簽下的第二級標簽是 web,這個名字是用戶自己自定義,它就是服務名稱。
image 則是指定服務的鏡像名稱或鏡像 ID。如果鏡像在本地不存在,Compose 將會嘗試拉取這個鏡像。
例如下面這些格式都是可以的:
image: redis image: ubuntu:14.04 image: tutum/influxdb image: a4bc65fd
3.3.5 args
添加構建參數,這些參數是僅在構建過程中可訪問的環境變量
首先, 在Dockerfile中指定參數:
ARG fendo ARG password RUN echo "Build number: $fendo" RUN script-requiring-password.sh "$password"
然後指定 build 下的參數,可以傳遞映射或列表
build: context: . args: fendo: 1 password: fendo
或
build: context: . args: - fendo=1 - password=fendo
3.3.6 command
使用 command 可以覆蓋容器啟動後默認執行的命令。
command: bundle exec thin -p 3000
該命令也可以是一個列表,方法類似於 dockerfile:
command: ["bundle", "exec", "thin", "-p", "3000"]
3.3.7 container_name
Compose 的容器名稱格式是:<項目名稱><服務名稱><序號>
雖然可以自定義項目名稱、服務名稱,但是如果你想完全控制容器的命名,可以使用這個標簽指定:
container_name: app
這樣容器的名字就指定為 app 了。
3.3.8 depends_on
在使用 Compose 時,最大的好處就是少打啟動命令,但是一般項目容器啟動的順序是有要求的,如果直接從上到下啟動容器,必然會因為容器依賴問題而啟動失敗。
例如在沒啟動數據庫容器的時候啟動了應用容器,這時候應用容器會因為找不到數據庫而退出,為了避免這種情況我們需要加入一個標簽,就是 depends_on,這個標簽解決了容器的依賴、啟動先後的問題。
例如下面容器會先啟動 redis 和 db 兩個服務,最後才啟動 web 服務:
version: ‘3‘ services: web: build: . depends_on: - db - redis redis: image: redis db: image: postgres
註意的是,默認情況下使用 docker-compose up web 這樣的方式啟動 web 服務時,也會啟動 redis 和 db 兩個服務,因為在配置文件中定義了依賴關系。
3.3.9 pid
pid: "host"
將PID模式設置為主機PID模式,跟主機系統共享進程命名空間。容器使用這個標簽將能夠訪問和操縱其他容器和宿主機的名稱空間。
3.3.10 ports
映射端口的標簽。
使用HOST:CONTAINER格式或者只是指定容器的端口,宿主機會隨機映射端口。
ports: - "3000" - "8000:8000" - "49100:22" - "127.0.0.1:8001:8001"
註意:當使用HOST:CONTAINER格式來映射端口時,如果你使用的容器端口小於60你可能會得到錯誤得結果,因為YAML將會解析xx:yy這種數字格式為60進制。所以建議采用字符串格式。
3.3.11 extra_hosts
添加主機名的標簽,就是往/etc/hosts文件中添加一些記錄,與Docker client的--add-host類似:
extra_hosts: - "somehost:162.242.195.82" - "otherhost:50.31.209.229"
啟動之後查看容器內部hosts:
162.242.195.82 somehost 50.31.209.229 otherhost
12.volumes
掛載一個目錄或者一個已存在的數據卷容器,可以直接使用 [HOST:CONTAINER] 這樣的格式,或者使用 [HOST:CONTAINER:ro] 這樣的格式,後者對於容器來說,數據卷是只讀的,這樣可以有效保護宿主機的文件系統。
Compose的數據卷指定路徑可以是相對路徑,使用 . 或者 .. 來指定相對目錄。
數據卷的格式可以是下面多種形式:
volumes: // 只是指定一個路徑,Docker 會自動在創建一個數據卷(這個路徑是容器內部的)。 - /var/lib/mysql // 使用絕對路徑掛載數據卷 - /opt/data:/var/lib/mysql // 以 Compose 配置文件為中心的相對路徑作為數據卷掛載到容器。 - ./cache:/tmp/cache // 使用用戶的相對路徑(~/ 表示的目錄是 /home/<用戶目錄>/ 或者 /root/)。 - ~/configs:/etc/configs/:ro // 已經存在的命名的數據卷。 - datavolume:/var/lib/mysql
如果你不使用宿主機的路徑,你可以指定一個volume_driver。
volume_driver: mydriver
Docker系列06:Docker-compose