目錄
- docker compose的使用場景
- 一個基本的demo演示
- 找一個目錄，在其中創建一個python檔案app.py
- 在相同的檔案夾下，創建requirements.txt檔案
- 在相同的檔案夾下，創建Dockerfile
- 在相同的檔案下，創建docker-compose.yml檔案
- 基礎運維
- 啟動基于docker-compose.yml編織好的服務
- 查看compose服務對應的容器服務串列
- 停止service的container
- 停止service的container，并且洗掉對應的container
- 停止service的container，并且洗掉對應的container和對應的volumes資料
- 如何登進對應的service
- 如何顯示指定compose file
- docker-compose up和docker-compose run的區別
- 一些擴展知識點
- 環境變數
- 在docker-compose.yml中執行
- 在執行docker-compose 命令之前設定shell環境變數
- 通過env_file檔案設定
- 直接在compose 檔案中，指定其加載的env_file
- 以上變數值設定優先級從高到底
- 查看最終生效的環境變數
- 專案名設定
- 網路
- 默認網路
- 對默認網路進行獨立配置
- 配置和使用非默認網路
- 多service的執行順序
- 環境變數
- docker compose的安裝
- docker compose和docker stack的異同
- 參考資料
docker compose的使用場景
我們開發的時候，一個應用往往依賴多個服務，采用傳統的docker run方式，要挨個啟動多個服務，甚至需要配置對應的網路,程序比較繁瑣，很不方便， docker compose旨在通過將多服務的構建和依賴關系都撰寫在docker-compose.yml中，通過docker-compose命令，即可完成對整個服務集群的啟動，關閉等操作，
一個基本的demo演示
demo的功能是一個簡單的python程式，暴露一個web服務，該服務用于統計當前服務被訪問的次數，次數的累加和存盤，都是基于redis進行的，也即該程式本身除了自己的服務，還要依賴一個redis服務，以下是詳細步驟
找一個目錄，在其中創建一個python檔案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)
在相同的檔案夾下，創建requirements.txt檔案
requirements.txt檔案用來宣告python程式需要使用到的依賴lib，有點像java中的maven pom檔案，上述代碼使用的組件有flask和redis，所以requirements.txt檔案內容為
flask
redis
在相同的檔案夾下，創建Dockerfile
Dockerfile用來將我們的程式構建成一個docker 鏡像，即docker image，一般Dockerfile中會定義我們的代碼運行的基本環境，程式啟動命令，執行埠等，本例的Dockerfile如下
FROM python:3.7-alpine
WORKDIR /code
ENV FLASK_APP=app.py
ENV FLASK_RUN_HOST=0.0.0.0
COPY requirements.txt requirements.txt
RUN pip install -r requirements.txt
EXPOSE 5000
COPY . .
CMD ["flask", "run"]
在相同的檔案下，創建docker-compose.yml檔案
上述幾步完成后，我們得到了我們服務本身的docker化執行的能力，但該服務依賴redis service，所以我們通過docker-compose.yml來組織服務的依賴關系，內容如下：
version: "3.8"
services:
web:
build: .
ports:
- "5000:5000"
redis:
image: "redis:alpine"
檔案中定義了兩個服務web和redis , web中的build:. 會在當前目錄下基于前面定義的Dockerfile將我們的代碼構建成一個image，然后啟動成一個container時，會對外暴露5000埠，映射到當前宿主機的埠也是5000
redis服務直接使用現成的image redis:alpine，沒有指定埠，將暴露redis的默認埠
基礎運維
所有docker-compose相關的命令，都要在docker-compose.yml所在的路徑下執行才行
啟動基于docker-compose.yml編織好的服務
在docker-compose.yml所在的目錄，使用命令docker-compose up即可，但該命令在console關閉時，對應的docker service也會被關閉，可以是使用docker-compose up -d 以后臺detach模式去執行，
docker-compose up 也可以單獨啟動compolse file中的某個服務及其依賴
查看compose服務對應的容器服務串列
docker-compose ps
輸出結果樣例
# docker-compose ps
Name Command State Ports
----------------------------------------------------------------------------------------------
docker_compose_learn_redis_1 docker-entrypoint.sh redis ... Up 6379/tcp
docker_compose_learn_web_1 flask run Up 0.0.0.0:5000->5000/tcp
服務前綴docker_compose_learn是當前專案的名稱，專案名稱可以通過環境變數COMPOSE_PROJECT_NAME來指定，如果未指定，默認的專案名稱為compose 檔案所在檔案夾的名字，本例中的檔案夾名為docker_compose_learn
當然compose的一系列服務，最終也是啟動了一系列的container. 所以也可使用docker container命令族進行管理，但是太麻煩
停止service的container
需要在docker-compose.yml所在的路徑，使用命令docker-compose stop
停止service的container，并且洗掉對應的container
需要在docker-compose.yml所在的路徑，使用命令
docker-compose down
停止service的container，并且洗掉對應的container和對應的volumes資料
需要在docker-compose.yml所在的路徑，使用命令
docker-compose down --volumes
該命令并不會洗掉掛載的宿主作業系統的檔案，
如何登進對應的service
想要登錄到compose中，具體某個service的命令列，使用如下命令
docker-compose exec ***servicename*** bash
如何顯示指定compose file
docker-compose -f docker-compose.yml -f docker-compose.admin.yml run backup_db
docker-compose up和docker-compose run的區別
docker-compose up會基于compose file 啟動所有的的服務，并對外暴露埠
docker-compose run需要指定特定的服務進行啟動，比如docker-compose run web bash只會啟動compolse檔案中的web服務和其依賴的service，并且不會對外暴露埠，以免跟docker-compose up啟動的服務埠沖突，
docker-compose run僅用在臨時啟動某個服務定位問題的場景
一些擴展知識點
環境變數
docker-compose.yml的內容本身可以使用變數占位符，其具體的變數值定義在具體的環境變數中，這樣方便同一份docker-compose.yml檔案在不同的環境有不同的執行行為，典型的，我們希望依賴服務的image的tag版本，隨環境不同而不同，
那么我們在docker-compose.yml對應的服務配置中以占位符配置其tag，以下用${TAG}配置web服務的image tag
web:
image: "webapp:${TAG}"
除了指定以的變數意外，還有多個docker內置的變數可以設定，他們用來配置docker的或者docker compose的執行行為，這些內置變數是
- COMPOSE_API_VERSION
- COMPOSE_CONVERT_WINDOWS_PATHS
- COMPOSE_FILE
- COMPOSE_HTTP_TIMEOUT
- COMPOSE_TLS_VERSION
- COMPOSE_PROJECT_NAME
- DOCKER_CERT_PATH
- DOCKER_HOST
- DOCKER_TLS_VERIFY
具體含義參見；https://docs.docker.com/compose/reference/envvars/
以占位符TAG為例，講解變數的設定可以有以下幾種方式
在docker-compose.yml中執行
在compolse檔案中，通過environment配置項指定
web:
image: "webapp:${TAG}"
environment:
- TAG=dev
在執行docker-compose 命令之前設定shell環境變數
$ export TAG=v2.0
$ docker-compose up
通過env_file檔案設定
docker-compose up默認會找命令執行路徑下的.env檔案，去其中找變數替換的值，.env檔案以key=value的形式配置，例如
TAG=dev
如果環境變數的名字不為.env或不在當前命令執行的路徑下，可以在使用--env-file引數顯示加載
docker-compose --env-file ./config/.env.dev up
直接在compose 檔案中，指定其加載的env_file
version: '3'
services:
api:
image: 'node:6-alpine'
env_file:
- ./Docker/api/api.env
environment:
- NODE_ENV=production
以上變數值設定優先級從高到底
查看最終生效的環境變數
如果不確定最終生效環境變數是什么樣，可以使用以下命令來查看
docker-compose run web env
專案名設定
一個compose對應的一組服務有一個公用的專案名(project name), 它會體現在compose服務的容器名前綴中，網路前綴中，
專案名稱可以通過環境變數COMPOSE_PROJECT_NAME來指定，如果未指定，默認的專案名稱為compose 檔案所在檔案夾的名字，
網路
默認網路
默認情況下，compose中的多個服務會加入一個名為default的網路，這些服務在default網路中是互通的，該default網路的全稱是以compose檔案所在檔案夾名字做為前綴，比如檔案夾為hello_world的compose，其一組服務對應的網路名為：hello_world_default， 這組service在該網路中，以compose檔案中的第二組埠通信，
version: "3"
services:
web:
build: .
ports:
- "8000:8000"
db:
image: postgres
ports:
- "8001:5432"
比如上述配置中，在hello_world_default網路中，web服務使用8000埠和db服務的5432埠通信，第一組埠8000和8001是宿主機訪問web和db服務的埠，
對默認網路進行獨立配置
如果想改變默認網路的配置，可以在compose檔案中，單獨通過networks項來改變，比如以下改變默認網路驅動
networks:
default:
# Use a custom driver
driver: custom-driver-1
配置和使用非默認網路
定義多個網路，并使用
version: "3"
services:
proxy:
build: ./proxy
networks:
- frontend
app:
build: ./app
networks:
- frontend
- backend
db:
image: postgres
networks:
- backend
networks:
frontend:
# Use a custom driver
driver: custom-driver-1
backend:
# Use a custom driver which takes special options
driver: custom-driver-2
driver_opts:
foo: "1"
bar: "2"
上述配置定義了兩個網路，frontend 和 backend，其中app 能訪問這兩個網路，proxy服務只能訪問frontend網路，db只能訪問backend網路
多service的執行順序
一個compose的多個service可能會有依賴關系，比如web服務依賴db服務，我們希望先啟動db服務，再啟動web服務，這種啟動的先后順序，也可以在compose檔案中使用depends_on指定
version: "2"
services:
web:
build: .
ports:
- "80:8000"
depends_on:
- "db"
command: ["./wait-for-it.sh", "db:5432", "--", "python", "app.py"]
db:
image: postgres
docker compose的安裝
docker mac版和windows版，默認都帶有docker compose ， 只有linux版需要單獨安裝
docker compose和docker stack的異同
- docker compose主要目標是在同一臺機器上啟動并管理多個服務
- docker stack主要用于在多個機器上，啟動并管理多個服務
- docker compose 和docker stack都可以使用docker-compose.yml檔案，雙方會自動忽略對自己不生效的配置
- docker compose的服務可以使用build動態構建，而docker stack的服務只能基于image
參考資料
https://docs.docker.com/compose/gettingstarted/
https://docs.docker.com/compose/
https://stackoverflow.com/questions/43099408/whats-the-difference-between-a-stack-file-and-a-compose-file
https://nickjanetakis.com/blog/docker-tip-23-docker-compose-vs-docker-stack
https://vsupalov.com/difference-docker-compose-and-docker-stack/
https://stackoverflow.com/questions/33066528/should-i-use-docker-compose-up-or-run
歡迎關注我的個人公眾號"西北偏北UP"，記錄代碼人生，行業思考，科技評論
轉載請註明出處，本文鏈接：https://www.uj5u.com/qita/191171.html
標籤：其他
上一篇：NLP：不要重新造輪子