Docker(四):Docker 三劍客之 Docker Compose
前兩篇文章我們介紹了 Dockerfile 的使用Docker(二):Dockerfile 使用介紹,我們知道使用一個(gè) Dockerfile 模板文件可以定義一個(gè)單獨(dú)的應(yīng)用容器,如果需要定義多個(gè)容器就需要服務(wù)編排。服務(wù)編排有很多種技術(shù)方案,今天給大家介紹 Docker 官方產(chǎn)品 Docker Compose 。
Dockerfile 可以讓用戶管理一個(gè)單獨(dú)的應(yīng)用容器;而 Compose 則允許用戶在一個(gè)模板(YAML 格式)中定義一組相關(guān)聯(lián)的應(yīng)用容器(被稱為一個(gè) project,即項(xiàng)目),例如一個(gè) Web 服務(wù)容器再加上后端的數(shù)據(jù)庫服務(wù)容器等。
Docker Compose 介紹
Docker-Compose 是 Docker 的一種編排服務(wù),是一個(gè)用于在 Docker 上定義并運(yùn)行復(fù)雜應(yīng)用的工具,可以讓用戶在集群中部署分布式應(yīng)用。
通過 Docker-Compose 用戶可以很容易地用一個(gè)配置文件定義一個(gè)多容器的應(yīng)用,然后使用一條指令安裝這個(gè)應(yīng)用的所有依賴,完成構(gòu)建。Docker-Compose 解決了容器與容器之間如何管理編排的問題。
Docker Compose 工作原理圖
Compose 中有兩個(gè)重要的概念:
- 服務(wù) (service) :一個(gè)應(yīng)用的容器,實(shí)際上可以包括若干運(yùn)行相同鏡像的容器實(shí)例。
- 項(xiàng)目 (project) :由一組關(guān)聯(lián)的應(yīng)用容器組成的一個(gè)完整業(yè)務(wù)單元,在 docker-compose.yml 文件中定義。
一個(gè)項(xiàng)目可以由多個(gè)服務(wù)(容器)關(guān)聯(lián)而成,Compose 面向項(xiàng)目進(jìn)行管理,通過子命令對(duì)項(xiàng)目中的一組容器進(jìn)行便捷地生命周期管理。
Compose 項(xiàng)目由 Python 編寫,實(shí)現(xiàn)上調(diào)用了 Docker 服務(wù)提供的 API 來對(duì)容器進(jìn)行管理。因此,只要所操作的平臺(tái)支持 Docker API,就可以在其上利用 Compose 來進(jìn)行編排管理。
Docker Compose 安裝
Docker Compose 是 Docker 的獨(dú)立產(chǎn)品,因此需要安裝 Docker 之后在單獨(dú)安裝 Docker Compose .
方法一:
- curl -L https://github.com/docker/compose/releases/download/1.19.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
- #確認(rèn)版本
- pip --version
- #更新pip
- pip install --upgrade pip
- #安裝docker-compose
- pip install docker-compose
- #查看版本
- docker-compose version
推薦使用方法一進(jìn)行安裝,安裝成功后輸入 docker-compose version會(huì)返回 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
出現(xiàn)以上信息,表明 docker-compose 安裝成功
安裝補(bǔ)全工具(可選)
為了方便我們輸入命令,也可以安裝 Docker 的補(bǔ)全提示工具幫忙我們快速輸入命令
- #安裝
- 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
快速上手
沒有什么比來一個(gè)小例子練練手更好的學(xué)習(xí)方法了,我們以官網(wǎng)上的簡單示例來看看 docker compose 的使用方法。
我們?cè)O(shè)計(jì)這么一個(gè)場景,使用 Python 啟動(dòng)一個(gè) Web 服務(wù),輸出一個(gè) hello()方法,每次訪問的時(shí)候在 Redis 緩存中進(jìn)行計(jì)數(shù),并且將統(tǒng)計(jì)的結(jié)果打印到頁面中。
***步,創(chuàng)建 Python 服務(wù)
創(chuàng)建項(xiàng)目路徑:
- mkdir composetest
- cd composetest
在目錄下創(chuàng)建 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)
在這個(gè)例子中, redis 使用了容器內(nèi)的網(wǎng)絡(luò)默認(rèn)端口是6379。這段 Python 程序的內(nèi)容就是,啟動(dòng)后連接 Redis 并且輸出 hello()方法,當(dāng)每次訪問的時(shí)候累計(jì)訪問次數(shù)并且將結(jié)果放回到頁面。
在同目錄下創(chuàng)建 requirements.txt文件,添加項(xiàng)目依賴的python包:
- flask
- redis
Flask 是 Python 中一個(gè)微型的 Web 開發(fā)框架。
第二步,創(chuàng)建 Dockerfile
我們來寫一個(gè) Dockerfile 來定義 Docker 鏡像,此鏡像包含了 Python 的依賴包和 Python 環(huán)境。
同樣在此目錄下,我們創(chuàng)建一個(gè) Dockerfile 文件。
- FROM python:3.4-alpine
- ADD . /code
- WORKDIR /code
- RUN pip install -r requirements.txt
- CMD ["python", "app.py"]
這段代碼表示:
- 使用基礎(chǔ)鏡像 Python 3.4
- 將當(dāng)前目錄映射到鏡像 /code目錄下
- 設(shè)置工作目錄為 /code
- 安裝 Python 依賴包
- 啟動(dòng) app.py 程序
第三步,使用 Compose 文件定義一個(gè)服務(wù)
在當(dāng)期目錄下,我們創(chuàng)建一個(gè) docker-compose.yml 文件,內(nèi)容如下:
- version: '2'
- services:
- web:
- build: .
- ports:
- - "5000:5000"
- redis:
- image: "redis:alpine"
這個(gè) Compose 文件定義了兩個(gè)服務(wù), 一個(gè) Pyhon Web 服務(wù)和 redis 服務(wù)。
- Pyhon Web 服務(wù):使用 Dockerfile 構(gòu)建了當(dāng)前鏡像。將 Web 容器內(nèi)部的5000端口映射到 host 的5000端口;并將 Web 容器與 redis 容器連接。
- redis服務(wù):該容器直接由官方的 redis 鏡像創(chuàng)建。
第四步,使用 Compose 編譯啟動(dòng)應(yīng)用
使用命令 docker-compose up啟動(dòng)
- version: '2'
- services:
- web:
- build: .
- command: python app.py
- ports:
- - "5000:5000"
- volumes:
- - .:/code
- redis:
- image: "redis:alpine"
啟動(dòng)成功之后,在瀏覽器訪問: http://ipaddress:5000/ ,返回如下:
- Hello World! I have been seen 1 times.
刷新再次訪問返回
- Hello World! I have been seen 2 times.
不斷的刷新數(shù)字會(huì)不斷的增長。
Docker Compose 常用命令
使用 docker-compose up -d在后臺(tái)啟動(dòng)服務(wù)
- [root@localhost composetest]# docker-compose up -d
- Starting composetest_web_1 ...
- Starting composetest_web_1 ... done
使用 docker-compose ps命令查看啟動(dòng)的服務(wù)
- [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停止服務(wù)。
- [root@localhost composetest]# docker-compose stop
- Stopping composetest_web_1 ... done
- Stopping composetest_redis_1 ... done
其它常用命令
- #查看幫助
- docker-compose -h
- # -f 指定使用的 Compose 模板文件,默認(rèn)為 docker-compose.yml,可以多次指定。
- docker-compose -f docker-compose.yml up -d
- #啟動(dòng)所有容器,-d 將會(huì)在后臺(tái)啟動(dòng)并運(yùn)行所有的容器
- docker-compose up -d
- #停用移除所有容器以及網(wǎng)絡(luò)相關(guān)
- docker-compose down
- #查看服務(wù)容器的輸出
- docker-compose logs
- #列出項(xiàng)目中目前的所有容器
- docker-compose ps
- #構(gòu)建(重新構(gòu)建)項(xiàng)目中的服務(wù)容器。服務(wù)容器一旦構(gòu)建后,將會(huì)帶上一個(gè)標(biāo)記名,例如對(duì)于 web 項(xiàng)目中的一個(gè) db 容器,可能是 web_db。可以隨時(shí)在項(xiàng)目目錄下運(yùn)行 docker-compose build 來重新構(gòu)建服務(wù)
- docker-compose build
- #拉取服務(wù)依賴的鏡像
- docker-compose pull
- #重啟項(xiàng)目中的服務(wù)
- docker-compose restart
- #刪除所有(停止?fàn)顟B(tài)的)服務(wù)容器。推薦先執(zhí)行 docker-compose stop 命令來停止容器。
- docker-compose rm
- #在指定服務(wù)上執(zhí)行一個(gè)命令。
- docker-compose run ubuntu ping docker.com
- #設(shè)置指定服務(wù)運(yùn)行的容器個(gè)數(shù)。通過 service=num 的參數(shù)來設(shè)置數(shù)量
- docker-compose scale web=3 db=2
- #啟動(dòng)已經(jīng)存在的服務(wù)容器。
- docker-compose start
- #停止已經(jīng)處于運(yùn)行狀態(tài)的容器,但不刪除它。通過 docker-compose start 可以再次啟動(dòng)這些容器。
- docker-compose stop