Docker學習之Compose介紹(6)

Compose 項目是 Docker 官方的開源項目，負責實現對 Docker 容器集羣的快速編排。其代碼目前在 https://github.com/docker/com... 上開源。

介紹

Compose 定位是 「定義和運行多個 Docker 容器的應用（Defining and runningmulti-container Docker applications）」。

咱們知道經過Dockerfile 模板文件，可讓用戶很方便的定義一個單獨的應用容器。然而，在平常工做中，常常會碰到須要多個容器相互配合來完成某項任務的狀況。例如要實現一個 Web 項目，除了 Web 服務容器自己，每每還須要再加上後端的數據庫服務容器，甚至還包括負載均衡容器等。

Compose 剛好知足了這樣的需求。它容許用戶經過一個單獨的 docker-compose.yml 模板文件（YAML 格式）來定義一組相關聯的應用容器爲一個項目（project）。

Compose 中有兩個重要的概念：

• 服務 ( service )：一個應用的容器，實際上能夠包括若干運行相同鏡像的容器實例。
• 項目 ( project )：由一組關聯的應用容器組成的一個完整業務單元，在docker-compose.yml 文件中定義。

Compose 的默認管理對象是項目，經過子命令對項目中的一組容器進行便捷地生命週期管理。

Compose 項目由 Python 編寫，實現上調用了 Docker 服務提供的 API 來對容器進行管理。所以，只要所操做的平臺支持 Docker API，就能夠在其上利用Compose 來進行編排管理。

安裝與卸載

Compose 支持 Linux、macOS、Windows 10 三大平臺。
Compose 能夠經過 Python 的包管理工具 pip 進行安裝，也能夠直接下載編譯好的二進制文件使用，甚至可以直接在 Docker 容器中運行。
前兩種方式是傳統方式，適合本地環境下安裝使用；最後一種方式則不破壞系統環境，更適合雲計算場景。

接下來看看在Linux系統上的安裝。

二進制包的安裝

在 Linux 上的也安裝十分簡單，從 官方 Github Realease 處直接下載編譯好的二進制文件便可。
好比64爲的linux下能夠經過以下命令進行安裝：

curl -L https://github.com/docker/compose/releases/download/1.17.1/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

PIP 安裝

注： x86_64 架構的 Linux 建議按照上邊的方法下載二進制包進行安裝，若是您計算機的架構是 ARM (例如，樹莓派)，再使用 pip 安裝。
這種方式是將 Compose 看成一個 Python 應用來從 pip 源中安裝。安裝與卸載執行安裝命令：

sudo pip install -U docker-compose

卸載

若是是二進制包方式安裝的，刪除二進制文件便可。

$ sudo rm /usr/local/bin/docker-compose

若是是經過 pip 安裝的，則執行以下命令便可刪除。

$ sudo pip uninstall docker-compose

使用

首先介紹幾個術語。

• 服務 ( service )：一個應用容器，實際上能夠運行多個相同鏡像的實例。
• 項目 ( project )：由一組關聯的應用容器組成的一個完整業務單元。

可見，一個項目能夠由多個服務（容器）關聯而成， Compose 面向項目進行管理。
最多見的項目是 web項目的管理，如python建站項目

下面咱們用 Python 來創建一個可以記錄頁面訪問次數的 web 網站。

新建文件夾，在該目錄中編寫 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! 該頁面已被訪問 {} 次。\n'.format(count)
if __name__ == "__main__":
app.run(host="0.0.0.0", debug=True)

編寫 Dockerfile 文件，內容爲

FROM python:3.6-alpine
ADD . /code
WORKDIR /code
RUN pip install redis flask
CMD ["python", "app.py"]

編寫 docker-compose.yml 文件，這個是 Compose 使用的主模板文件。

version: '2'
services:
web:
    build: .
    ports:
        - "5000:5000"
redis:
    image: "redis:alpine"

最後經過docker-compose up命令運行 compose 項目

這樣每刷新一次瀏覽器就看到數字加1了

Compose命令說明

命令對象與格式

對於 Compose 來講，大部分命令的對象既能夠是項目自己，也能夠指定爲項目中的服務或者容器。若是沒有特別的說明，命令對象將是項目，這意味着項目中全部的服務都會受到命令影響。
執行 docker-compose [COMMAND] --help 或者 docker-compose help
[COMMAND] 能夠查看具體某個命令的使用格式。
docker-compose 命令的基本的使用格式是

docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令選項

• -f, --file FILE 指定使用的 Compose 模板文件，默認爲 dockercompose.yml ，能夠屢次指定。
• -p, --project-name NAME 指定項目名稱，默認將使用所在目錄名稱做爲項目名。
• --x-networking 使用 Docker 的可拔插網絡後端特性
• --x-network-driver DRIVER 指定網絡後端的驅動，默認爲 bridge
• --verbose 輸出更多調試信息。
• -v, --version 打印版本並退出。

命令使用說明

build
格式爲 docker-compose build [options] [SERVICE...] 。構建（從新構建）項目中的服務容器。
命令說明
服務容器一旦構建後，將會帶上一個標記名，例如對於 web 項目中的一個 db 容器，多是 web_db。
能夠隨時在項目目錄下運行 docker-compose build 來從新構建服務。
選項包括：
--force-rm 刪除構建過

$ docker-compose kill -s SIGINT

logs
格式爲 docker-compose logs [options] [SERVICE...] 。
查看服務容器的輸出。默認狀況下，docker-compose 將對不一樣的服務輸出使用不一樣的顏色來區分。能夠經過 --no-color 來關閉顏色。
該命令在調試問題的時候十分有用。
pause
格式爲 docker-compose pause [SERVICE...] 。
暫停一個服務容器。
port
格式爲 docker-compose port [options] SERVICE PRIVATE_PORT 。
打印某個容器端口所映射的公共端口。
選項：
--protocol=proto 指定端口協議，tcp（默認值）或者 udp。
--index=index 若是同一服務存在多個容器，指定命令對象容器的序號（默
認爲 1）。
ps
格式爲 docker-compose ps [options] [SERVICE...] 。
列出項目中目前的全部容器。
選項：
-q 只打印容器的 ID 信息。
pull
格式爲 docker-compose pull [options] [SERVICE...] 。
命令說明

拉取服務依賴的鏡像。
選項：
--ignore-pull-failures 忽略拉取鏡像過程當中的錯誤。
push
推送服務依賴的鏡像到 Docker 鏡像倉庫。
restart
格式爲 docker-compose restart [options] [SERVICE...] 。
重啓項目中的服務。
選項：

• -t, --timeout TIMEOUT 指定重啓前中止容器的超時（默認爲 10 秒）。

rm
格式爲 docker-compose rm [options] [SERVICE...] 。
刪除全部（中止狀態的）服務容器。推薦先執行 docker-compose stop 命令來
中止容器。
選項：

• -f, --force 強制直接刪除，包括非中止狀態的容器。通常儘可能不要使用該

選項。

• -v 刪除容器所掛載的數據卷。

run
格式爲 docker-compose run [options] [-p PORT...] [-e KEY=VAL...]SERVICE [COMMAND] [ARGS...] 。
在指定服務上執行一個命令。
例如：
命令說明

$ docker-compose run ubuntu ping docker.com

將會啓動一個 ubuntu 服務容器，並執行 ping docker.com 命令。
默認狀況下，若是存在關聯，則全部關聯的服務將會自動被啓動，除非這些服務已
經在運行中。
該命令相似啓動容器後運行指定的命令，相關卷、連接等等都將會按照配置自動創
建。
兩個不一樣點：

• 給定命令將會覆蓋原有的自動運行命令；
• 不會自動建立端口，以免衝突。

若是不但願自動啓動關聯的容器，可使用 --no-deps 選項，例如

$ docker-compose run --no-deps web python manage.py shell

將不會啓動 web 容器所關聯的其它容器。
選項：

• -d 後臺運行容器。
• --name NAME 爲容器指定一個名字。
• --entrypoint CMD 覆蓋默認的容器啓動指令。
• -e KEY=VAL 設置環境變量值，可屢次使用選項來設置多個環境變量。
• -u, --user="" 指定運行容器的用戶名或者 uid。
• --no-deps 不自動啓動關聯的服務容器。
• --rm 運行命令後自動刪除容器， d 模式下將忽略。
• -p, --publish=[] 映射容器端口到本地主機。
• --service-ports 配置服務端口並映射到本地主機。

-T 不分配僞 tty，意味着依賴 tty 的指令將沒法運行。
命令說明
scale
格式爲 docker-compose scale [options] [SERVICE=NUM...] 。
設置指定服務運行的容器個數。
經過 service=num 的參數來設置數量。例如：

$ docker-compose scale web=3 db=2

將啓動 3 個容器運行 web 服務，2 個容器運行 db 服務。
通常的，當指定數目多於該服務當前實際運行容器，將新建立並啓動容器；反之，將中止容器。
選項：

• -t, --timeout TIMEOUT 中止容器時候的超時（默認爲 10 秒）。

start
格式爲 docker-compose start [SERVICE...] 。
啓動已經存在的服務容器。
stop
格式爲 docker-compose stop [options] [SERVICE...] 。
中止已經處於運行狀態的容器，但不刪除它。經過 docker-compose start 能夠再次啓動這些容器。
選項：

• -t, --timeout TIMEOUT 中止容器時候的超時（默認爲 10 秒）。

top
查看各個服務容器內運行的進程。
unpause
格式爲 docker-compose unpause [SERVICE...] 。
命令說明
恢復處於暫停狀態中的服務。
up
格式爲 docker-compose up [options] [SERVICE...] 。
該命令十分強大，它將嘗試自動完成包括構建鏡像，（從新）建立服務，啓動服務，並關聯服務相關容器的一系列操做。連接的服務都將會被自動啓動，除非已經處於運行狀態。能夠說，大部分時候均可以直接經過該命令來啓動一個項目。
默認狀況， docker-compose up 啓動的容器都在前臺，控制檯將會同時打印全部容器的輸出信息，能夠很方便進行調試。
當經過 Ctrl-C 中止命令時，全部容器將會中止。
若是使用 docker-compose up -d ，將會在後臺啓動並運行全部的容器。通常推薦生產環境下使用該選項。
默認狀況，若是服務容器已經存在， docker-compose up 將會嘗試中止容器，而後從新建立（保持使用 volumes-from 掛載的卷），以保證新啓動的服務匹配docker-compose.yml 文件的最新內容。若是用戶不但願容器被中止並從新建立，可使用 docker-compose up --no-recreate 。這樣將只會啓動處於中止狀態的容器，而忽略已經運行的服務。若是用戶只想從新部署某個服務，可使用docker-compose up --no-deps -d <SERVICE_NAME> 來從新建立服務並後臺中止舊服務，啓動新服務，並不會影響到其所依賴的服務。
選項：

• -d 在後臺運行服務容器。
• --no-color 不使用顏色來區分不一樣的服務的控制檯輸出。
• --no-deps 不啓動服務所連接的容器。
• --force-recreate 強制從新建立容器，不能與 --no-recreate 同時使用。
• --no-recreate 若是容器已經存在了，則不從新建立，不能與 --forcerecreate 同時使用。命令說明
• --no-build 不自動構建缺失的服務鏡像。
• -t, --timeout TIMEOUT 中止容器時候的超時（默認爲 10 秒）。

version格式爲 docker-compose version 。打印版本信息。