Docker-Compose

借鑒：https://blog.csdn.net/pushiqiang/article/details/78682323

特點：

Compose 是 Docker 容器進行編排的工具，定義和運行多容器的應用，可以一條命令啟動多個容器。

技術簡介

1、Compose 通過一個配置文件來管理多個Docker容器，在配置文件中，所有的容器通過services來定義

2、使用docker-compose腳本來啟動，停止和重啟應用，和應用中的服務以及所有依賴服務的容器，非常適合組合使用多個容器進行開發的場景。

3、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 啟動整個應用
安裝compose

yum -y install epel-release
yum -y install python-pip
pip install docker-compose

安裝后提示，翻譯如下：

您使用的是PIP版本8.1.2，但是版本18.1可用。
您應該考慮通過“pip install --upgrade pip”命令進行升級。

查詢版本

docker-compose version

docker-compose使用示例

通過docker-compose構建一個在docker中運行的基於python flask框架的web應用

Step 1: 定義python應用

1、創建工程目錄：

$ mkdir compose_test
$ cd compose_test
$ mkdir src      # 源碼文件夾
$ mkdir docker  # docker配置文件夾

目錄結構如下：

2 .（看不懂可以忽略，這只是用來做示例的）在compose_test/src/目錄下創建python flask應用 compose_test/src/app.py文件。

from flask import Flask
from redis import Redis
 
app = Flask(__name__)
redis = Redis(host='redis', port=6379)
 
@app.route('/')
def hello():
    count = redis.incr('hits')
    return 'Hello World! I have been seen {} times.\n'.format(count)
 
if __name__ == "__main__":
    app.run(host="0.0.0.0", debug=True)

創建python 需求文件 compose_test/docker/requirements.txt

文件內容：

flask
redis

Step 2: 創建容器的Dockerfile文件

一個容器一個Dockerfile文件 
為了工程目錄更加清晰，在compose_test/docker/目錄下創建compose_test/docker/web目錄

$ cd docker
$ mkdir web

在compose_test/docker/web/目錄中創建Dockerfile文件：

FROM python:3.4
ADD . /docker      
ADD ../../src /src  #ADD的源路徑應該在Dockerfile文件的上下文環境中（即Dockerfile文件所在根目錄及其子目錄下，如ADD . /src是合法的，而ADD ../../src /src不合法），此處為了清晰的項目結構，只是展示ADD指令，實際中應該用volumes掛載
WORKDIR /src
RUN pip install -r /docker/requirements.txt
CMD ["python", "app.py"]

Dockerfile文件告訴docker了如下信息：

1、從Python 3.4鏡像開始構建一個容器鏡像。
2、復制當前 . （即compose_test/docker）目錄到容器的/docker目錄。
3、復制../../src目錄（即compose_test/src） 到容器中的/src目錄
（此處../../src是不合法的路徑，ADD的源路徑必須在Dockerfile文件的上下文環境中，
即Dockerfile文件所在根目錄或起子目錄中，實際應該使用volumes掛載項目源文件）。
4、將容器的工作目錄設置為/src。 
5、安裝Python依賴關系。
6、將容器的默認命令設置為python app.py。

Step 3: 定義docker-compose腳本
在compose_test/docker/目錄下創建docker-compose.yml文件，並在里面定義服務，內容如下：

version: '3'
services:
  web:
    build: ./web/
    ports:
     - "5000:5000"
  redis:
    image: "redis:3.0.7"

這個compose文件定義了兩個服務，即定義了web和redis兩個容器。 

web容器： 
  * 使用當前的web目錄（compose_test/docker/web/）中的Dockerfile構建映像。 
  * 將容器上的暴露端口5000映射到主機上的端口5000。 使用Flask Web服務器的默認端口5000。 
redis容器： 
  * redis服務使用從Docker Hub提取的官方redis鏡像3.0.7版本。

　　

Step 4: 使用Compose構建並運行您的應用程序
在compose_test/docker/目錄下執行docker-compose.yml文件：

$ docker-compose up
# 若是要后台運行： $ docker-compose up -d

# 若不使用默認的docker-compose.yml 文件名：
$ docker-compose -f server.yml up -d

然后在瀏覽器中輸入http://0.0.0.0:5000/查看運行的應用程序。

docker-compose默認的模板文件是 docker-compose.yml，其中定義的每個服務都必須通過 image 指令指定鏡像或 build 指令（需要 Dockerfile）來自動構建。

 

Step 5: 編輯compose文件以添加文件綁定掛載
上面的代碼是在構建時靜態復制到容器中的，即通過Dockerfile文件中的ADD ./src /src命令實現物理主機中的源碼復制到容器中，這樣在后續物理主機src目錄中代碼的更改不會反應到容器中。 
可以通過volumes 關鍵字實現物理主機目錄掛載到容器中的功能（同時刪除Dockerfile中的ADD指令，不需要創建鏡像時將代碼打包進鏡像，而是通過volums動態掛載，容器和物理host共享數據卷）：

version: '3'
services:
  web:
    build: .
    ports:
     - "5000:5000"
    volumes:
     - ../src :/src
  redis:
    image: "redis:3.0.7"

通過volumes（卷）將主機上的項目目錄（compose_test/src）掛載到容器中的/src目錄下，允許您即時修改代碼，而無需重新構建映像。

Step 6: 重新構建和運行應用程序

使用更新的compose文件構建應用程序，然后運行它。

$ docker-compose up -d

    ===============         示例完成        ================

6.compose常用服務配置參考

Compose文件是一個定義服務、網絡和卷的YAML文件。 Compose文件的默認文件名為docker-compose.yml。

Docker Compose 通過一個配置文件來管理多個Docker容器，在配置文件中，所有的容器通過services來定義，然后使用docker-compose腳本來啟動，停止和重啟應用

**提示：您可以對此文件使用.yml或.yaml擴展名。 他們都工作。

　　與docker運行一樣，默認情況下，Dockerfile中指定的選項（例如，CMD，EXPOSE，VOLUME，ENV）都被遵守，你不需要在docker-compose.yml中再次指定它們。

　　同時你可以使用類似Bash的$ {VARIABLE} 語法在配置值中使用環境變量，有關詳細信息，請參閱變量替換。

本節包含版本3中服務定義支持的所有配置選項。

build
build 可以指定包含構建上下文的路徑：

version: '2'
services:
  webapp:
    build: ./dir

或者，作為一個對象，該對象具有上下文路徑和指定的Dockerfile文件以及args參數值：

version: '2'
services:
  webapp:
    build:
      context: ./dir
      dockerfile: Dockerfile-alternate
      args:
        buildno: 1

webapp服務將會通過./dir目錄下的Dockerfile-alternate文件構建容器鏡像。 
如果你同時指定image和build，則compose會通過build指定的目錄構建容器鏡像，而構建的鏡像名為image中指定的鏡像名和標簽。

build: ./dir
image: webapp:tag

這將由./dir構建的名為webapp和標記為tag的鏡像。

context
包含Dockerfile文件的目錄路徑，或者是git倉庫的URL。 
當提供的值是相對路徑時，它被解釋為相對於當前compose文件的位置。 該目錄也是發送到Docker守護程序構建鏡像的上下文。

dockerfile
備用Docker文件。Compose將使用備用文件來構建。 還必須指定構建路徑。

args
添加構建鏡像的參數，環境變量只能在構建過程中訪問。 
首先，在Dockerfile中指定要使用的參數：

ARG buildno
ARG password

RUN echo "Build number: $buildno"
RUN script-requiring-password.sh "$password"

然后在args鍵下指定參數。 你可以傳遞映射或列表：

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

** 注意：YAML布爾值（true，false，yes，no，on，off）必須用引號括起來，以便解析器將它們解釋為字符串。

image
指定啟動容器的鏡像，可以是鏡像倉庫/標簽或者鏡像id（或者id的前一部分）

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

如果鏡像不存在，Compose將嘗試從官方鏡像倉庫將其pull下來，如果你還指定了build，在這種情況下，它將使用指定的build選項構建它，並使用image指定的名字和標記對其進行標記。

container_name
指定一個自定義容器名稱，而不是生成的默認名稱。

container_name: my-web-container

由於Docker容器名稱必須是唯一的，因此如果指定了自定義名稱，則無法將服務擴展到多個容器。

volumes
卷掛載路徑設置。可以設置宿主機路徑 （HOST:CONTAINER） 或加上訪問模式 （HOST:CONTAINER:ro）,掛載數據卷的默認權限是讀寫（rw），可以通過ro指定為只讀。 
你可以在主機上掛載相對路徑，該路徑將相對於當前正在使用的Compose配置文件的目錄進行擴展。 相對路徑應始終以 . 或者 .. 開始。

volumes:
  # 只需指定一個路徑，讓引擎創建一個卷
  - /var/lib/mysql
  # 指定絕對路徑映射
  - /opt/data:/var/lib/mysql
  # 相對於當前compose文件的相對路徑
  - ./cache:/tmp/cache
  # 用戶家目錄相對路徑
  - ~/configs:/etc/configs/:ro
  # 命名卷
  - datavolume:/var/lib/mysql

但是，如果要跨多個服務並重用掛載卷，請在頂級volumes關鍵字中命名掛在卷，但是並不強制，如下的示例亦有重用掛載卷的功能，但是不提倡。

version: "3"
 
services:
  web1:
    build: ./web/
    volumes:
      - ../code:/opt/web/code
  web2:
    build: ./web/
    volumes:
      - ../code:/opt/web/code

** 注意：通過頂級volumes定義一個掛載卷，並從每個服務的卷列表中引用它， 這會替換早期版本的Compose文件格式中volumes_from。

version: "3"
 
services:
  db:
    image: db
    volumes:
      - data-volume:/var/lib/db
  backup:
    image: backup-service
    volumes:
      - data-volume:/var/lib/backup/data
 
volumes:
  data-volume:

command
覆蓋容器啟動后默認執行的命令。

command: bundle exec thin -p 3000

該命令也可以是一個類似於dockerfile的列表：

command: ["bundle", "exec", "thin", "-p", "3000"]

links
鏈接到另一個服務中的容器。 請指定服務名稱和鏈接別名（SERVICE：ALIAS），或者僅指定服務名稱。

web:
  links:
   - db
   - db:database
   - redis

在當前的web服務的容器中可以通過鏈接的db服務的別名database訪問db容器中的數據庫應用，如果沒有指定別名，則可直接使用服務名訪問。

鏈接不需要啟用服務進行通信 - 默認情況下，任何服務都可以以該服務的名稱到達任何其他服務。 （實際是通過設置/etc/hosts的域名解析，從而實現容器間的通信。故可以像在應用中使用localhost一樣使用服務的別名鏈接其他容器的服務，前提是多個服務容器在一個網絡中可路由聯通）

links也可以起到和depends_on相似的功能，即定義服務之間的依賴關系，從而確定服務啟動的順序。

external_links
鏈接到docker-compose.yml 外部的容器，甚至並非 Compose 管理的容器。參數格式跟 links 類似。

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

expose
暴露端口，但不映射到宿主機，只被連接的服務訪問。 
僅可以指定內部端口為參數

expose:
 - "3000"
 - "8000"

ports
暴露端口信息。 
常用的簡單格式：使用宿主：容器 （HOST:CONTAINER）格式或者僅僅指定容器的端口（宿主將會隨機選擇端口）都可以。

** 注意：當使用 HOST:CONTAINER 格式來映射端口時，如果你使用的容器端口小於 60 你可能會得到錯誤得結果，因為 YAML 將會解析 xx:yy 這種數字格式為 60 進制。所以建議采用字符串格式。

簡單的短格式：

ports:
 - "3000"
 - "3000-3005"
 - "8000:8000"
 - "9090-9091:8080-8081"
 - "49100:22"
 - "127.0.0.1:8001:8001"
 - "127.0.0.1:5000-5010:5000-5010"
 - "6060:6060/udp"

在v3.2中ports的長格式的語法允許配置不能用短格式表示的附加字段。 
長格式：

ports:
  - target: 80
    published: 8080
    protocol: tcp
    mode: host

target：容器內的端口 
published：物理主機的端口 
protocol：端口協議（tcp或udp） 
mode：host 和ingress 兩總模式，host用於在每個節點上發布主機端口，ingress 用於被負載平衡的swarm模式端口。

restart
no是默認的重啟策略，在任何情況下都不會重啟容器。 指定為always時，容器總是重新啟動。 如果退出代碼指示出現故障錯誤，則on-failure將重新啟動容器。

restart: "no"
restart: always
restart: on-failure
restart: unless-stopped

environment
添加環境變量。 你可以使用數組或字典兩種形式。 任何布爾值; true，false，yes，no需要用引號括起來，以確保它們不被YML解析器轉換為True或False。 
只給定名稱的變量會自動獲取它在 Compose 主機上的值，可以用來防止泄露不必要的數據。

environment:
  RACK_ENV: development
  SHOW: 'true'
  SESSION_SECRET:
 
environment:
  - RACK_ENV=development
  - SHOW=true
  - SESSION_SECRET

** 注意：如果你的服務指定了build選項，那么在構建過程中通過environment定義的環境變量將不會起作用。 將使用build的args子選項來定義構建時的環境變量。

pid
將PID模式設置為主機PID模式。 這就打開了容器與主機操作系統之間的共享PID地址空間。 使用此標志啟動的容器將能夠訪問和操作裸機的命名空間中的其他容器，反之亦然。即打開該選項的容器可以相互通過進程 ID 來訪問和操作。

pid: "host"

dns
配置 DNS 服務器。可以是一個值，也可以是一個列表。

dns: 8.8.8.8
dns:
  - 8.8.8.8
  - 9.9.9.9