Docker(四):Docker 三劍客之 Docker Compose
前兩篇文章我們介紹了 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 .
方法一:
- 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
- #確認版本
- 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