Docker(四):Docker 三劍客之 Docker Compose

純潔的微笑發表於2018-03-26

前兩篇文章我們介紹了 Dockerfile 的使用Docker(二):Dockerfile 使用介紹,我們知道使用一個 Dockerfile 模板檔案可以定義一個單獨的應用容器,如果需要定義多個容器就需要服務編排。服務編排有很多種技術方案,今天給大家介紹 Docker 官方產品 Docker Compose 。

Dockerfile 可以讓使用者管理一個單獨的應用容器;而 Compose 則允許使用者在一個模板(YAML 格式)中定義一組相關聯的應用容器(被稱為一個 project,即專案),例如一個 Web 服務容器再加上後端的資料庫服務容器等。

Docker Compose 介紹

Docker-Compose 是 Docker 的一種編排服務,是一個用於在 Docker 上定義並執行復雜應用的工具,可以讓使用者在叢集中部署分散式應用。

通過 Docker-Compose 使用者可以很容易地用一個配置檔案定義一個多容器的應用,然後使用一條指令安裝這個應用的所有依賴,完成構建。Docker-Compose 解決了容器與容器之間如何管理編排的問題。

Docker Compose 工作原理圖

Docker(四):Docker 三劍客之 Docker Compose

Compose 中有兩個重要的概念:

  • 服務 (service) :一個應用的容器,實際上可以包括若干執行相同映象的容器例項。
  • 專案 (project) :由一組關聯的應用容器組成的一個完整業務單元,在 docker-compose.yml 檔案中定義。

一個專案可以由多個服務(容器)關聯而成,Compose 面向專案進行管理,通過子命令對專案中的一組容器進行便捷地生命週期管理。

Compose 專案由 Python 編寫,實現上呼叫了 Docker 服務提供的 API 來對容器進行管理。因此,只要所操作的平臺支援 Docker API,就可以在其上利用 Compose 來進行編排管理。

Docker Compose 安裝

Docker Compose 是 Docker 的獨立產品,因此需要安裝 Docker 之後在單獨安裝 Docker Compose .

方法一:

#下載
sudo curl -L https://github.com/docker/compose/releases/download/1.20.0/docker-compose-`uname -s`-`uname -m` -o /usr/local/bin/docker-compose
#安裝
chmod +x /usr/local/bin/docker-compose
#檢視版本
docker-compose version

方法二:

#安裝pip
yum -y install epel-release
yum -y install python-pip
#確認版本
pip --version
#更新pip
pip install --upgrade pip
#安裝docker-compose
pip install docker-compose 
#檢視版本
docker-compose version

推薦使用方法一進行安裝,安裝成功後輸入docker-compose version會返回 docker-compose 的版本資訊,如下:

[root@localhost ~]# docker-compose version
docker-compose version 1.19.0, build 9e633ef
docker-py version: 2.7.0
CPython version: 2.7.13
OpenSSL version: OpenSSL 1.0.1t  3 May 2016

出現以上資訊,表明 docker-compose 安裝成功

安裝補全工具(可選)

為了方便我們輸入命令,也可以安裝 Docker 的補全提示工具幫忙我們快速輸入命令

#安裝
yum install bash-completion

#下載docker-compose指令碼
curl -L https://raw.githubusercontent.com/docker/compose/$(docker-compose version --short)/contrib/completion/bash/docker-compose > /etc/bash_completion.d/docker-compose

快速上手

沒有什麼比來一個小例子練練手更好的學習方法了,我們以官網上的簡單示例來看看 docker compose 的使用方法。

我們設計這麼一個場景,使用 Python 啟動一個 Web 服務,輸出一個hello()方法,每次訪問的時候在 Redis 快取中進行計數,並且將統計的結果列印到頁面中。

第一步,建立 Python 服務

建立專案路徑:

mkdir composetest
cd composetest

在目錄下建立app.py檔案

import time

import redis
from flask import Flask


app = Flask(__name__)
cache = redis.Redis(host='redis', port=6379)


def get_hit_count():
    retries = 5
    while True:
        try:
            return cache.incr('hits')
        except redis.exceptions.ConnectionError as exc:
            if retries == 0:
                raise exc
            retries -= 1
            time.sleep(0.5)


@app.route('/')
def hello():
    count = get_hit_count()
    return 'Hello World! I have been seen {} times.\n'.format(count)

if __name__ == "__main__":
    app.run(host="0.0.0.0", debug=True)

在這個例子中, redis 使用了容器內的網路預設埠是6379。這段 Python 程式的內容就是,啟動後連線 Redis 並且輸出 hello()方法,當每次訪問的時候累計訪問次數並且將結果放回到頁面。

在同目錄下建立requirements.txt檔案,新增專案依賴的python包:

flask
redis

Flask 是 Python 中一個微型的 Web 開發框架。

第二步,建立 Dockerfile

我們來寫一個 Dockerfile 來定義 Docker 映象,此映象包含了 Python 的依賴包和 Python 環境。

同樣在此目錄下,我們建立一個 Dockerfile 檔案。

FROM python:3.4-alpine
ADD . /code
WORKDIR /code
RUN pip install -r requirements.txt
CMD ["python", "app.py"]

這段程式碼表示:

  • 使用基礎映象 Python 3.4
  • 將當前目錄對映到映象/code目錄下
  • 設定工作目錄為 /code
  • 安裝 Python 依賴包
  • 啟動 app.py 程式

第三步,使用 Compose 檔案定義一個服務

在當期目錄下,我們建立一個 docker-compose.yml 檔案,內容如下:

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

這個 Compose 檔案定義了兩個服務, 一個 Pyhon Web 服務和 redis 服務。

  • Pyhon Web 服務:使用 Dockerfile 構建了當前映象。將 Web 容器內部的5000埠對映到 host 的5000埠;並將 Web 容器與 redis 容器連線。
  • redis服務:該容器直接由官方的 redis 映象建立。

第四步,使用 Compose 編譯啟動應用

使用命令docker-compose up啟動

version: '2'
services:
  web:
    build: .
    command: python app.py
    ports:
     - "5000:5000"
    volumes:
     - .:/code
  redis:
    image: "redis:alpine"

啟動成功之後,在瀏覽器訪問:http://ipaddress:5000/ ,返回如下:

Hello World! I have been seen 1 times.

Docker(四):Docker 三劍客之 Docker Compose

重新整理再次訪問返回

Hello World! I have been seen 2 times.

Docker(四):Docker 三劍客之 Docker Compose

不斷的重新整理數字會不斷的增長。

Docker Compose 常用命令

使用docker-compose up -d在後臺啟動服務

[root@localhost composetest]# docker-compose up -d
Starting composetest_web_1 ... 
Starting composetest_web_1 ... done

使用docker-compose ps命令檢視啟動的服務

[root@localhost composetest]# docker-compose ps
       Name                      Command               State           Ports         
-------------------------------------------------------------------------------------
composetest_redis_1   docker-entrypoint.sh redis ...   Up      6379/tcp              
composetest_web_1     python app.py                    Up      0.0.0.0:5000->5000/tcp

使用docker-compose stop停止服務。

[root@localhost composetest]# docker-compose stop
Stopping composetest_web_1   ... done
Stopping composetest_redis_1 ... done

其它常用命令

#檢視幫助
docker-compose -h

# -f  指定使用的 Compose 模板檔案,預設為 docker-compose.yml,可以多次指定。
docker-compose -f docker-compose.yml up -d 

#啟動所有容器,-d 將會在後臺啟動並執行所有的容器
docker-compose up -d

#停用移除所有容器以及網路相關
docker-compose down

#檢視服務容器的輸出
docker-compose logs

#列出專案中目前的所有容器
docker-compose ps

#構建(重新構建)專案中的服務容器。服務容器一旦構建後,將會帶上一個標記名,例如對於 web 專案中的一個 db 容器,可能是 web_db。可以隨時在專案目錄下執行 docker-compose build 來重新構建服務
docker-compose build

#拉取服務依賴的映象
docker-compose pull

#重啟專案中的服務
docker-compose restart

#刪除所有(停止狀態的)服務容器。推薦先執行 docker-compose stop 命令來停止容器。
docker-compose rm 

#在指定服務上執行一個命令。
docker-compose run ubuntu ping docker.com

#設定指定服務執行的容器個數。通過 service=num 的引數來設定數量
docker-compose scale web=3 db=2

#啟動已經存在的服務容器。
docker-compose start

#停止已經處於執行狀態的容器,但不刪除它。通過 docker-compose start 可以再次啟動這些容器。
docker-compose stop

參考

Get started with Docker Compose
使用Docker-Compose編排容器

相關文章