前兩篇文章我們介紹了 Dockerfile 的使用Docker(二):Dockerfile 使用介紹,我們知道使用一個 Dockerfile 模板檔案可以定義一個單獨的應用容器,如果需要定義多個容器就需要服務編排。服務編排有很多種技術方案,今天給大家介紹 Docker 官方產品 Docker Compose 。
Dockerfile 可以讓使用者管理一個單獨的應用容器;而 Compose 則允許使用者在一個模板(YAML 格式)中定義一組相關聯的應用容器(被稱為一個 project,即專案),例如一個 Web 服務容器再加上後端的資料庫服務容器等。
Docker Compose 介紹
Docker-Compose 是 Docker 的一種編排服務,是一個用於在 Docker 上定義並執行復雜應用的工具,可以讓使用者在叢集中部署分散式應用。
通過 Docker-Compose 使用者可以很容易地用一個配置檔案定義一個多容器的應用,然後使用一條指令安裝這個應用的所有依賴,完成構建。Docker-Compose 解決了容器與容器之間如何管理編排的問題。
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.
重新整理再次訪問返回
Hello World! I have been seen 2 times.
不斷的重新整理數字會不斷的增長。
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