Compose簡介

Compose項目是Docker官方的開源項目，負責實現對Docker容器集群的快速編排。其代碼目前在https://github.com/docker/compose 上開源。

Compose定位是定義和運行多個Docker容器的應用，其前身是開源項目Fig。

通過前面內容的介紹，我們知道使用一個Dockerfile模板文件，可以讓用戶很方便的定義一個單獨的應用容器。然而，在日常工作中，經常會碰到需要多個容器相互配合來完成某任務的情況。例如要實現一個Web項目,除了Web服務容器本身，往往還需要加上后端的數據庫服務容器，甚至還包括負載均衡容器等。

Compose恰好滿足了這樣的需求。它允許用戶通過一個單獨的docker-compose.yml模板文件來定義一組相關聯的應用容器為一個項目(project)。

Compose中有兩個重要的概念：

• 服務(service):一個應用的容器，實際上可以包括若干運行相同鏡像的容器實例。
• 項目(project):由一組關聯的應用容器組成的一個完整業務單元。

Compose的默認管理對象是項目，通過子命令對項目中的一組容器進行便捷地生命周期管理。

Compose項目由Python編寫，實現上調用了Docker服務提供的API來對容器進行管理。

安裝和卸載

Compose支持Linux、macOS、Windows10三大平臺。

Compose可以通過Python的包管理工具pip進行安裝，也可以直接下載編譯好的二進制文件使用，甚至能夠直接在Docker容器中運行。

Docker for Mac、Docker for Windows自帶docker-compose二進制文件，安裝Docker之后可以直接使用。

docker-compose --version

Linux系統需要單獨使用二進制或者pip方式進行安裝。

Linux安裝docker-compose

二進制包

在Linux上的安裝十分簡單，從官方GitHub Release處直接下載編譯好的二進制文件即可。例如，在Linux64位系統上直接下載對應的二進制包。

sudo curl -L "https://github.com/docker/compose/releases/download/1.24.1/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose sudo chmod +x /usr/local/bin/docker-compose #賦予可執行權限

PIP安裝

如果您計算機的架構是ARM(例如，樹莓派),建議使用pip安裝。

sudo pip install -U docker-compose

使用

場景：最常見的項目是web網站，一般的web網站都會依賴第三方提供的服務(比如：DB和cache),我們拿dubbo-admin進行講解(dubbo-admin依賴zookeeper)。

Compose構建dubbo-admin服務

從github上獲取dubbo-admin的master分支源碼

git clone -b master https://github.com/apache/incubator-dubbo-ops.git

修改admin中的application配置，把zookeeper地址改為zookeeper://zookeeper:2181

使用maven進行編譯打包

mvn clean package -Dmaven.test.skip=true

在dubbo-admin目錄下編寫Dockerfile文件，內容為

# FROM,表示使用JDK8環境為基礎鏡像，如果鏡像不是本地會從DockerHub進行下載 FROM openjdk:8-jdk-alpine # 作者 MAINTAINER Simon<xueyao.me@gmail.com> VOLUME /tmp # ADD,拷貝文件并且重命名 ADD ./target/dubbo-admin-0.0.1-SNAPSHOT.jar app.jar # ENTRYPOINT,為了縮短Tomcat啟動時間，添加java.security.egd的系統屬性指向/dev/urandom作為ENTRYPOINT ENTRYPOINT ["java", "-Djava.security.egd=file:/dev/./urandom","-jar","/app.jar"]

使用docker build -t dubbo-admin:1.0 .命令進行構建。

在項目根目錄下編寫docker-compose.yml文件，這個是Compose使用的主模板文件。

version: '3.4' services:zk_server:image: zookeeper:3.4ports:- 2181:2181dubbo-admin:image: dubbo-admin:1.0links:- zk_server:zookeeperdepends_on:- zk_serverports:- 7001:7001

在docker-compose.yml文件所在目錄執行：

docker-compose up

在瀏覽器中訪問http://服務器ip:7001 進行驗證，用戶名密碼為:root/root guest/guest

Compose命令說明

命令對象與格式

執行docker-compose [COMMAND] --help或者docker-compose help [COMMAND]可以查看具體某個命令的使用格式。

docker-compose命令的基本的使用格式是：

docker-compose [-f=<arg>...] [options] [COMMAND] [ARGS...]

命令選項

• -f,--file FILE指定模板文件，默認為docker-compose.yml,可以多次指定。
• -p,--project-name NAME指定項目名稱，默認將使用所在目錄名稱作為項目名。
• --x-networking使用Docker的可拔插網絡后端特性
• --x-network-driver DRIVER指定網絡后端的驅動,默認為bridge
• --verbose輸出更多調試信息。
• -v,--version打印版本并退出。

build

格式為docker-compose build [options] [SERVICE...]。 構建(重新構建)項目中的服務容器。 可以隨時在項目目錄下運行docker-compose build來重新構建服務。 選項包括： * --force-rm 刪除構建過程中的臨時容器。 * --no-cache 構建鏡像過程中不使用cache(將加長構建過程)。 * --pull 始終嘗試通過pull來獲取更新版本的鏡像。

logs

格式為docker-compose logs [options] [SERVICE...]。 查看服務容器的輸出。默認情況下,docker-compose將對不同的服務輸出使用不同的顏色來區分。可以通過--no-color來關閉顏色。

port

格式為docker-compose port [options] SERVICE PRIVATE_PORT。 打印某個容器端口所映射的公共端口。 選項：--protocol=proto指定端口協議，tcp(默認值)或者udp。--index=index如果同一服務存在多個容器，指定命令對象容器的序號(默認為1)。

ps

格式為docker-compose ps [options] [SERVICE...] 列出項目中目前的所有容器。 選項：-q只打印容器的ID信息。

pull

格式為docker-compose pull [options] [SERVICE...]。 拉取服務依賴的鏡像。 選項：--ignore-pull-failures忽略拉取鏡像過程中的錯誤。

restart

格式為docker-compose restart [options] [SERVICE...] 重啟項目中的服務。 選項：-t,--timeout TIMEOUT指定重啟前停止容器的超時(默認為10秒)。

rm

格式為docker-compose rm [options] [SERVICE...] 刪除所有(停止狀態的)服務容器。推薦先執行docker-compose stop命令來停止容器。 選項：-f,--force強制直接刪除，包括非停止狀態的容器。一般盡量不要使用該選項。-v刪除容器所掛載的數據卷。

run

格式為docker-compose run[options] [-p PORT...][-e KEY=VAL...] SERVICE [COMMAND] [ARGS...] 在指定服務上執行一個命令。例如： docker-compose run ubuntu ping docker.com

scale

格式為docker-compose scal [options] [SERVICE=NUM...] 設置指定服務運行的容器個數。例如： docker-compose scale web=3 db=2 將啟動3個容器運行web服務，2個容器運行db服務。

up

該命令十分強大，它將嘗試自動完成包括構建鏡像，(重新)創建服務,啟動服務，并關聯服務相關容器的一系列操作。鏈接的服務都將會被自動啟動，除非已經處于運行狀態。 選項：-d 在后臺運行服務容器。--no-color 不使用顏色來區分不同的服務的控制臺輸出。--no-deps 不啟動服務所鏈接的容器。--force-recreate強制重新創建容器，不能與--no-recreate同時使用。--no-recreate如果容器已經存在了，則不重新創建，不能與--force-recreate同時使用。--no-build 不自動構建缺失的服務鏡像。-t,--timeout TIMEOUT停止容器時候的超時(默認為10秒)。

其它命令如下：

命令說明

version	格式為docker-compose version,打印版本信息
config	驗證Compose格式是否正確，若正確則顯示配置，若格式錯誤顯示錯誤原因。
exec	進入指定的容器
images	列出Compose文件中包含的鏡像
down	停止up命令所啟動的容器，并移除網絡。
help	獲得一個命令的幫助
kill	通過發送SIGKILL信號來強制停止服務容器
pause	格式為docker-compose pause [SERVICE...],暫停一個服務容器。
push	推送服務依賴的鏡像到Docker鏡像倉庫
start	格式為docker-compose start[SERVICE...],啟動已經存在的服務容器。
stop	停止已經存在的服務容器。
top	查看各個服務容器內運行的進程
unpause	格式為docker-compose unpause [SERVICE...],恢復處于暫停狀態中的服務。

Compose模板文件

模板文件是使用Compose的核心，涉及到的指令關鍵字也比較多，大部分指令跟docker run 相關參數的含義都類似。

默認的模板文件名稱為docker-compose.yml,格式為YAML格式。

注意每個服務都必須通過image指令指定鏡像或build指令(需要Dockerfile)等來自動構建生成鏡像。

如果使用build指令,在Dockerfile中設置的選項(例如:CMD,EXPOSE,VOLUME,ENV等)將會自動被獲取，無需在docker-compose.yml中再次設置。下面介紹常用指令的用法。

version: '3' services:webapp:build:context: ./dirdockerfile: Dockerfile-alternateargs:buildno: 1

build

指令Dockerfile所在文件夾的路徑(可以是絕對路徑,或者相對docker-compose.yml文件的路徑)。 Compose將會利用它自動構建這個鏡像,然后使用這個鏡像。 使用context指令指定Dockerfile所在文件夾的路徑 使用dockerfile指令指定Dockerfile文件名 使用arg指令指定構建鏡像時的變量

command

覆蓋容器啟動后默認執行的命令。

command:echo "hello world"

Container_name

指令容器名稱。默認將會使用項目名稱_服務名稱_序號這樣的格式。

container_name:docker-web-container

configs

僅用于Swarm mode, 詳細內容后頁面swarm mode會進到。

deploy

僅用于Swarm mode,詳細內容后面swarm mode會進到。

devices

指定設備映射關系。

devices:- "/dev/ttyUSB1:/ttyUSB0"

depends_on

解決容器的依賴、啟動先后的問題。

dns

自定義DNS服務器?？梢允且粋€值，也可以是一個列表。

dns: 8.8.8.8 dns:- 8.8.8.8- 114.114.114.114

environment

設置環境變量。你可以使用數組或字典兩種格式。
只給定名稱的變量會自動獲取運行Compose主機上對應變量的值，可以用來防止泄露不必要的數據。

environment:RACK_ENV: developmentSESSION_SECRET: environment:- RACK_ENV=development- SESSION_SECRET

expose

顯露端口，但不映射到宿主機，只被連接的服務訪問。僅可以指定內部端口為參數

expose:- "3000"- "8000"

extra_hosts

類似Docker中的--add-host參數，指定額外的host名稱映射信息。
會在啟動后的服務容器中/etc/hosts文件中添加一條條目。8.8.8.8 googledns

extra_hosts:- "googledns:8.8.8.8"

healthcheck

通過命令容器是否健康運行。

healthcheck:test:["CMD","curl","-f","http://localhost"]interval:1m30stimeout:10sretries:3

image

指定為鏡像名稱或鏡像ID。如果鏡像在本地不存在，Compose將會嘗試拉去這個鏡像

image:session-web:latest

lables

為容器添加Docker元數據(metadata)信息。例如可以為容器添加輔助說明信息。

labels:com.study.department:"devops department"com.study.release:"v1.0"

links

連接到其他容器。注意：不推薦使用該指令。
應該使用docker network,建立網絡,而docker run --network來連接特定網絡?；蛘呤褂胿ersion:'2'和更高版本的docker-compose.yml直接定義自定義網絡并使用。

network_mode

設置網絡模式。使用和docker run的--network參數一樣的值。

network_mode:"bridge" network_mode:"host" network_mode:"none"

networks

配置容器連接的網絡。

version:"3" services:some-service:networks:- some-network networks:some-network:

ports

暴露端口信息。使用宿主端口：容器端口(HOST:CONTAINER)格式，或者僅僅指定容器的端口(宿主將會隨機選擇端口)都可以。

ports:- "3000"- "8000:8000"

volumes

數據卷所掛載路徑設置，可以設置宿主機路徑，同時支持相關路徑。

volumes:- /var/lib/mysql- cache/:/tmp/cache- ~/configs:/etc/configs/:ro

ulimits

指定容器的ulimits限制值。
例如，指定最大進程數為65535,指定文件句柄數為20000(軟限制,應用可以隨時修改,不能超過硬限制)和40000(系統硬限制，只能root用戶提高)。

ulimits:nproc: 65535nofile:soft: 20000hard: 40000

此外，還有包括domainname,entrypoint,hostname,ipc,mac_address,privileged,read_only,shm_size,restart,stdin_open,tty,user,working_dir等指令，基本跟docker run中對應參數的功能相同。

指定服務容器啟動后執行的入口文件

entrypoint: /code/entrypoint.sh

指定容器中運行應用的用戶名

user:nginx

指定容器中工作目錄

working_dir: /code

指定容器中搜索域名、主機名、mac地址等

domainname:your_website.com hostname:test mac_address:08-00-27-00-0C-0A

允許容器中運行一些特權命令

privileged:true

指定容器退出后的重啟策略為始終重啟。在生產環境中推薦配置為always或者unless-stopped

restart:alwarys

以只讀模式掛載容器的root文件系統，意味著不能對容器內容進行修改

read_only:true

打開標準輸入，可以接受外部輸入

stdin_open:true

模擬一個偽終端

tty:true

Compose模板文件支持動態讀取主機的系統環境變量和當前目錄下的.env文件中的變量。例如，下面的Compose文件將從運行它的環境中讀取變量${MONGO_VERSION}的值，并寫入執行的指令中。

version: "3" services:db:image: "mongo:${MONGO_VERSION}"

如果執行MONGO_VERSION=3.2 docker-compose up則會啟動一個mongo:3.2鏡像的容器。若當前目錄存在.env文件，執行docker-compose命令時將從該文件中讀取變量。

轉載于:https://www.cnblogs.com/loveyous/p/11375832.html

總結

以上是生活随笔為你收集整理的Docker入门-docker compose的使用的全部內容，希望文章能夠幫你解決所遇到的問題。

如果覺得生活随笔網站內容還不錯，歡迎將生活随笔推薦給好友。