2. 程式人生 > 實用技巧 >Docker 容器編排利器 Docker Compose

Docker 容器編排利器 Docker Compose

阿新 • • 發佈：2020-09-08

Compose 簡介

　　

　　通過前面幾篇文章的學習，我們可以通過 Dockerfile 檔案讓使用者很方便的定義一個單獨的應用容器。然而，在日常工作中，經常會碰到需要多個容器相互配合來完成某項任務的情況，例如之前我給大家講過的《Docker 搭建 Redis Cluster 叢集》，或者開發一個 Web 應用，除了 Web 服務容器本身，還需要資料庫服務容器、快取容器，甚至還包括負載均衡容器等等。

　　Docker Compose 恰好滿足了這樣的需求，它是用於定義和執行多容器 Docker 應用程式的工具。通過 Compose，您可以使用 YAML 檔案來配置應用程式所需要的服務。然後使用一個命令，就可以通過 YAML

配置檔案建立並啟動所有服務。

　　Docker Compose 專案是 Docker 官方的開源專案，來源於之前的 Fig 專案，使用 Python 語言編寫。負責實現對 Docker 容器叢集的快速編排。專案地址為：https://github.com/docker/compose/releases

　　Docker Compose 使用的三個步驟為：

  • 使用 Dockerfile 檔案定義應用程式的環境；
  • 使用 docker-compose.yml 檔案定義構成應用程式的服務，這樣它們可以在隔離環境中一起執行；
  • 最後，執行 docker-compose up 命令來建立並啟動所有服務。

　　

Compose 安裝

　　

下載

　　

　　官方文件：https://docs.docker.com/compose/install/

　　您可以在 macOS，Windows 和 Linux 上執行 Compose。本文演示基於 Linux 環境的安裝。我們可以使用 curl 命令從 Github 下載它的二進位制檔案來使用，執行以下命令下載 Docker Compose 的當前穩定版本。或者從網頁下載後上傳至伺服器指定目錄 /usr/local/bin 也行。

sudo curl -L "https://github.com/docker/compose/releases/download/1.26.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose

　　

　　因為 Docker Compose 存放在 GitHub，可能不太穩定。你也可以通過執行下面的命令，高速安裝 Compose。該加速通道由 DaoCloud 提供：http://get.daocloud.io/#install-compose

sudo curl -L https://get.daocloud.io/docker/compose/releases/download/1.26.2/docker-compose-`uname -s`-`uname -m` > /usr/local/bin/docker-compose

　　您可以通過修改 URL 中的版本，自定義您所需要的版本檔案。

　　

授權

　　

　　安裝完成以後，檢視指定目錄，發現該檔案沒有可執行許可權，進行授權操作。

# 將可執行許可權應用於該二進位制檔案
sudo chmod +x /usr/local/bin/docker-compose

　　

測試

　　

docker-compose --version

　　

解除安裝

　　

　　解除安裝 Compose 非常簡單，直接刪除二進位制檔案即可。

sudo rm /usr/local/bin/docker-compose

　　

docker-compose.yml 檔案詳解

　　

概念

　　

　　官方文件：https://docs.docker.com/compose/compose-file/

　　Docker Compose 允許使用者通過 docker-compose.yml 檔案（YAML 格式）來定義一組相關聯的容器為一個工程（project）。一個工程包含多個服務（service），每個服務中定義了建立容器時所需的映象、引數、依賴等。

工程名若無特殊指定，即為 docker-compose.yml 檔案所在目錄的名稱。

　　Docker Compose 模板檔案我們需要關注的頂級配置有 version、services、networks、volumes 幾個部分，除 version 外，其他幾個頂級配置下還有很多下級配置，後面也會詳細給大家介紹，先來看看這幾個頂級配置都什麼意思：

  • version：描述 Compose 檔案的版本資訊，當前最新版本為 3.8，對應的 Docker 版本為 19.03.0+；
  • services：定義服務，可以多個，每個服務中定義了建立容器時所需的映象、引數、依賴等；
  • networkds：定義網路，可以多個，根據 DNS server 讓相同網路中的容器可以直接通過容器名稱進行通訊；
  • volumes：資料卷，用於實現目錄掛載。

　　

案例

　　

　　在配置檔案中，所有的容器通過 services 來定義，然後使用 docker-compose 指令碼來啟動，停止和重啟容器，非常適合多個容器組合使用進行開發的場景。我們先從一個簡單的 Compose 案例學起。

　　編寫 docker-compose.yml 檔案。

# 建立目錄
mkdir -p /usr/local/docker-nginx
# 切換至指定目錄
cd /usr/local/docker-nginx/
# 編寫 docker-compose.yml 檔案
vi docker-compose.yml

　　

　　在檔案中新增以下內容：

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  nginx: # 服務名稱
    image: nginx # 建立容器時所需的映象
    container_name: mynginx # 容器名稱，預設為"工程名稱_服務條目名稱_序號"
    ports: # 宿主機與容器的埠對映關係
      - "80:80" # 左邊宿主機埠:右邊容器埠
    networks: # 配置容器連線的網路，引用頂級 networks 下的條目
      - nginx-net

# 定義網路，可以多個。如果不宣告，預設會建立一個網路名稱為"工程名稱_default"的 bridge 網路
networks:
  nginx-net: # 一個具體網路的條目名稱
    name: nginx-net # 網路名稱，預設為"工程名稱_網路條目名稱"
    driver: bridge # 網路模式，預設為 bridge

　　

　　使用 docker-compose up 建立並啟動所有服務。這個簡單的案例中就只有一個 Nginx 後續我們會來一些複雜的練習：

# 前臺啟動
docker-compose up
# 後臺啟動
docker-compose up -d

　　

　　瀏覽器訪問：http://192.168.10.10/ 結果如下：

　　

　　使用 docker-compose down 可以停止並刪除容器、網路。

　　

version

　　

　　描述 Compose 檔案的版本資訊，當前最新版本為 3.8，對應的 Docker 版本為 19.03.0+。關於每個版本的詳細資訊請參考：https://docs.docker.com/compose/compose-file/compose-versioning/

　　以下為 Compose 檔案的版本資訊所對應的 Docker 版本。

Compose file format Docker Engine release
3.8 19.03.0+
3.7 18.06.0+
3.6 18.02.0+
3.5 17.12.0+
3.4 17.09.0+
3.3 17.06.0+
3.2 17.04.0+
3.1 1.13.1+
3.0 1.13.0+
2.4 17.12.0+
2.3 17.06.0+
2.2 1.13.0+
2.1 1.12.0+
2.0 1.10.0+
1.0 1.9.1.+

　　

services

　　

　　剛才我們提到 docker-compose.yml 檔案中包含很多下級配置項，下面帶大家把一些常用的配置項詳細瞭解一下，先從頂級配置 services 開始。

　　services 用來定義服務，可以多個，每個服務中定義了建立容器時所需的映象、引數、依賴等，就像將命令列引數傳遞給 docker run 一樣。同樣，網路和資料卷的定義也是一樣的。

　　比如，之前我們通過 docker run 命令構建一個 MySQL 應用容器的命令如下：

docker run -di --name mysql8 -p 3306:3306 -v /mydata/docker_mysql/conf:/etc/mysql/conf.d -v /mydata/docker_mysql/data:/var/lib/mysql -e MYSQL_ROOT_PASSWORD=1234 mysql:8

　　使用 docker-compose.yml 以後則可以這樣定義：

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  mysql: # 服務名稱
    image: mysql:8 # 建立容器時所需的映象
    container_name: mysql8 # 容器名稱，預設為"工程名稱_服務條目名稱_序號"
    ports: # 宿主機與容器的埠對映關係
      - "3306:3306" # 左邊宿主機埠:右邊容器埠
    environment: # 建立容器時所需的環境變數
      MYSQL_ROOT_PASSWORD: 1234
    volumes:
      - "/mydata/docker_mysql/conf:/etc/mysql/conf.d"
      - "/mydata/docker_mysql/data:/var/lib/mysql"

　　然後通過 dokcer-compose 相關命令即可完成容器的建立，停止或刪除等一系列操作。

　　

image

　　

　　指定建立容器時所需的映象名稱標籤或者映象 ID。如果映象在本地不存在，會去遠端拉取。

services:
  web:
    image: hello-world

　　

build

　　

　　除了可以基於指定的映象構建容器，還可以基於 Dockerfile 檔案構建，在使用 up 命令時會執行構建任務。

　　通過 build 配置項可以指定 Dockerfile 所在資料夾的路徑。Compose 將會利用 Dockerfile 自動構建映象，然後使用映象啟動服務容器。

　　build 配置項可以使用絕對路徑，也可以使用相對路徑。

# 絕對路徑，在該路徑下基於名稱為 Dockerfile 的檔案構建映象
/usr/local/docker-centos
# 相對路徑，相對當前 docker-compose.yml 檔案所在目錄，基於名稱為 Dockerfile 的檔案構建映象
.

　　

　　接下來我們來個稍微複雜點的練習，通過基礎映象 centos:7，在該映象中安裝 jdk 和 tomcat 以後將其製作為一個新的映象 mycentos:7。

　　建立目錄並編寫 Dockerfile 檔案。

# 建立目錄
mkdir -p /usr/local/docker-centos
# 切換至指定目錄
cd /usr/local/docker-centos/
# 編寫 Dockerfile 檔案
vi Dockerfile

　　Dockerfile 檔案內容如下：

# 指明構建的新映象是來自於 centos:7 基礎映象
FROM centos:7
# 通過映象標籤聲明瞭作者資訊
LABEL maintainer="mrhelloworld.com"
# 設定工作目錄
WORKDIR /usr/local
# 新映象構建成功以後建立指定目錄
RUN mkdir -p /usr/local/java && mkdir -p /usr/local/tomcat
# 拷貝檔案到映象中並解壓
ADD jdk-11.0.6_linux-x64_bin.tar.gz /usr/local/java
ADD apache-tomcat-9.0.37.tar.gz /usr/local/tomcat
# 暴露容器執行時的 8080 監聽埠給外部
EXPOSE 8080
# 設定容器內 JAVA_HOME 環境變數
ENV JAVA_HOME /usr/local/java/jdk-11.0.6/
ENV PATH $PATH:$JAVA_HOME/bin
# 啟動容器時啟動 tomcat 並檢視 tomcat 日誌資訊
CMD ["/usr/local/tomcat/apache-tomcat-9.0.37/bin/catalina.sh", "run"]

　　將所需的資源包 jdk 和 tomcat 上傳至 Dockerfile 同一目錄。

　　建立目錄並編寫 docker-compose.yml 檔案。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  mycentos: # 服務名稱
    build: . # 相對當前 docker-compose.yml 檔案所在目錄，基於名稱為 Dockerfile-alternate 的檔案構建映象
    container_name: mycentos7 # 容器名稱，預設為"工程名稱_服務條目名稱_序號"
    ports: # 宿主機與容器的埠對映關係
      - "8080:8080" # 左邊宿主機埠:右邊容器埠

　　然後通過 dokcer-compose 相關命令即可完成容器的建立，停止或刪除等一系列操作。

　　

context

　　

　　該選項可以是 Dockerfile 檔案的絕對/相對路徑，也可以是遠端 Git 倉庫的 URL，當提供的值是相對路徑時，相對當前 docker-compose.yml 檔案所在目錄。

build:
  context: . # 相對當前 docker-compose.yml 檔案所在目錄，基於名稱為 Dockerfile 的檔案構建映象

　　

dockerfile

　　

　　一般情況下，預設都基於檔名叫 Dockerfile 的檔案構建映象，當然也可以是自定義的檔名，使用 dockerfile 宣告，不過這個選項只能宣告檔名，檔案所在路徑還是要通過 centext 來宣告。

build:
  context: . # 相對當前 docker-compose.yml 檔案所在目錄
  dockerfile: Dockerfile-alternate # 基於名稱為 Dockerfile-alternate 的檔案構建映象

　　

container_name

　　

　　Compose 建立的容器預設生成的名稱格式為：工程名稱_服務條目名稱_序號。如果要使用自定義名稱，使用 container_name 宣告。

services:
  mycentos:
    build: .
    container_name: mycentos7 # 容器名稱，預設為"工程名稱_服務條目名稱_序號"

因為 Docker 容器名稱必須是唯一的，所以如果指定了自定義名稱，就不能將服務擴充套件至多個容器。這樣做可能會導致錯誤。

　　

關於序號

　　

　　序號是幹什麼用的呢，看下面這個例子你就懂了，docker-compose.yml 檔案內容如下：

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  helloworld: # 服務名稱
    image: hello-world

　　

　　然後通過 --scale 指定 helloworld 服務一次性啟動 3 個。

docker-compose up -d --scale helloworld=3

　　

　　通過下圖可以看到有 3 個容器被建立，容器名稱最後的序號是從 1 開始累加的，這就是序號的作用。所以如果指定了自定義名稱，就不能將服務擴充套件至多個容器。

　　

depends_on

　　

　　使用 Compose 最大的好處就是敲最少的命令做更多的事情，但一般專案容器啟動的順序是有要求的，如果直接從上到下啟動容器，必然會因為容器依賴問題而啟動失敗。例如在沒有啟動資料庫容器的情況下啟動了 Web 應用容器，應用容器會因為找不到資料庫而退出。depends_on 就是用來解決容器依賴、啟動先後問題的配置項。

version: "3.8"
services:
  web:
    build: .
    depends_on:
      - db
      - redis
  redis:
    image: redis
  db:
    image: mysql

　　上述 YAML 檔案定義的容器會先啟動 db 和 redis 兩個服務，最後才啟動 web 服務。

　　

ports

　　

　　容器對外暴露的埠，格式：左邊宿主機埠:右邊容器埠。

ports:
  - "80:80"
  - "8080:8080"

　　

expose

　　

　　容器暴露的埠不對映到宿主機，只允許能被連線的服務訪問。

expose:
  - "80"
  - "8080"

　　

restart

　　

　　容器重啟策略，簡單的理解就是 Docker 重啟以後容器要不要一起啟動：

  • no：預設的重啟策略，在任何情況下都不會重啟容器；
  • on-failure：容器非正常退出時，比如退出狀態為非0(異常退出)，才會重啟容器；
  • always：容器總是重新啟動，即使容器被手動停止了，當 Docker 重啟時容器也還是會一起啟動；
  • unless-stopped：容器總是重新啟動，除非容器被停止（手動或其他方式），那麼 Docker 重啟時容器則不會啟動。
services:
  nginx:
    image: nginx
    container_name: mynginx
    ports:
      - "80:80"
    restart: always

　　

environment

　　

　　新增環境變數。可以使用陣列也可以使用字典。布林相關的值（true、false、yes、no）都需要用引號括起來，以確保 YML 解析器不會將它們轉換為真或假。

environment:
  RACK_ENV: development
  SHOW: 'true'
  SESSION_SECRET:

　　或者以下格式：

environment:
  - RACK_ENV=development
  - SHOW=true
  - SESSION_SECRET

　　

env_file

　　

　　從檔案中獲取環境變數，可以指定一個或多個檔案，其優先順序低於 environment 指定的環境變數。

env_file:
  - /opt/runtime_opts.env # 絕對路徑
  - ./common.env # 相對路徑，相對當前 docker-compose.yml 檔案所在目錄
  - ./apps/web.env # 相對路徑，相對當前 docker-compose.yml 檔案所在目錄

注意：env 檔案中的每一行需採用 鍵=值 格式。以 # 開頭的行會被視為註釋並被忽略。空行也會被忽略。

　　

volumes

　　

　　資料卷，用於實現目錄掛載，支援指定目錄掛載、匿名掛載、具名掛載。

  • 指定目錄掛載的格式為：左邊宿主機目錄:右邊容器目錄，或者左邊宿主機目錄:右邊容器目錄:讀寫許可權；
  • 匿名掛載格式為：容器目錄即可，或者容器目錄即可:讀寫許可權；
  • 具名掛載格式為：資料卷條目名稱:容器目錄，或者資料卷條目名稱:容器目錄:讀寫許可權。

關於匿名掛載/具名掛載更多的內容請閱讀《Docker 最常用的映象命令和容器命令》文章中容器相關命令部分的目錄掛載（容器資料卷操作）的內容。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  mysql: # 服務名稱
    image: mysql:8 # 建立容器時所需的映象
    container_name: mysql8 # 容器名稱，預設為"工程名稱_服務條目名稱_序號"
    ports: # 宿主機與容器的埠對映關係
      - "3306:3306" # 左邊宿主機埠:右邊容器埠
    environment: # 建立容器時所需的環境變數
      MYSQL_ROOT_PASSWORD: 1234
    volumes:
      # 絕對路徑
      - "/mydata/docker_mysql/data:/var/lib/mysql"
      # 相對路徑，相對當前 docker-compose.yml 檔案所在目錄
      - “./conf:/etc/mysql/conf.d“
      # 匿名掛載，匿名掛載只需要寫容器目錄即可，容器外對應的目錄會在 /var/lib/docker/volume 中生成
      - "/var/lib/mysql"
      # 具名掛載，就是給資料捲起了個名字，容器外對應的目錄會在 /var/lib/docker/volume 中生成
      - "mysql-data-volume:/var/lib/mysql"

# 定義資料卷，可以多個
volumes:
  mysql-data-volume: # 一個具體資料卷的條目名稱
    name: mysql-data-volume # 資料卷名稱，預設為"工程名稱_資料卷條目名稱"

　　

network_mode

　　

　　設定網路模式，類似 docker run 時新增的引數 --net host 或者 --network host 的用法。

network_mode: "bridge"
network_mode: "host"
network_mode: "none"
network_mode: "service:[service name]"
network_mode: "container:[container name/id]"

　　

networks

　　

　　配置容器連線的網路，引用頂級 networks 下的條目。

# 定義服務，可以多個
services:
  nginx: # 服務名稱
    networks: # 配置容器連線的網路，引用頂級 networks 下的條目
      - nginx-net # 一個具體網路的條目名稱

# 定義網路，可以多個。如果不宣告，預設會建立一個網路名稱為"工程名稱_default"的 bridge 網路
networks:
  nginx-net: # 一個具體網路的條目名稱
    name: nginx-net # 網路名稱，預設為"工程名稱_網路條目名稱"
    driver: bridge # 網路模式，預設為 bridge

　　

aliases

　　

　　網路上此服務的別名。同一網路上的其他容器可以使用服務名或此別名連線到服務容器。同一服務在不同的網路上可以具有不同的別名。

# 定義服務，可以多個
services:
  nginx: # 服務名稱
    networks: # 配置容器連線的網路，引用頂級 networks 下的條目
      nginx-net: # 一個具體網路的條目名稱
        aliases: # 服務別名，可以多個
          - nginx1 # 同一網路上的其他容器可以使用服務名或此別名連線到服務容器

# 定義網路，可以多個。如果不宣告，預設會建立一個網路名稱為"工程名稱_default"的 bridge 網路
networks:
  nginx-net: # 一個具體網路的條目名稱
    name: nginx-net # 網路名稱，預設為"工程名稱_網路條目名稱"
    driver: bridge # 網路模式，預設為 bridge

　　

volumes

　　

　　通過頂級配置 services 的學習，大家應該已經明白頂級配置 volumes 是幹嘛的了，這裡再詳細把配置的不同方式講解一下。

　　以下方式的資料卷宣告建立卷時會使用預設的名稱："工程名稱_資料卷條目名稱"。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  mysql:
    image: mysql:8
    container_name: mysql8
    ports:
      - "3306:3306"
    environment
      MYSQL_ROOT_PASSWORD: 1234
    volumes:
      # 具名掛載，就是給資料捲起了個名字，容器外對應的目錄會在 /var/lib/docker/volume 中生成
      - "mysql-data-volume:/var/lib/mysql"

# 定義資料卷，可以多個
volumes:
  mysql-data-volume: # 一個具體資料卷的條目名稱

　　

　　以下方式的資料卷宣告建立卷時會使用自定義的名稱。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  mysql:
    image: mysql:8
    container_name: mysql8
    ports:
      - "3306:3306"
    environment
      MYSQL_ROOT_PASSWORD: 1234
    volumes:
      # 具名掛載，就是給資料捲起了個名字，容器外對應的目錄會在 /var/lib/docker/volume 中生成
      - "mysql-data-volume:/var/lib/mysql"

# 定義資料卷，可以多個
volumes:
  mysql-data-volume: # 一個具體資料卷的條目名稱
    name: mysql-data-volume # 資料卷名稱，預設為"工程名稱_資料卷條目名稱"

　　

networks

　　

　　通過頂級配置 services 的講解，大家其實已經明白頂級配置 volumes 是幹嘛的了，這裡再詳細把配置的不同方式講解一下。

　　如果不宣告網路，每個工程預設會建立一個網路名稱為"工程名稱_default"的 bridge 網路。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  nginx:
    image: nginx
    container_name: mynginx
    ports:
      - "80:80"

# 定義網路，可以多個。如果不宣告，預設會建立一個網路名稱為"工程名稱_default"的 bridge 網路
#networks:

　　

　　以下方式的網路宣告建立網路時會使用預設的名稱："工程名稱_網路條目名稱"，網路模式預設為 bridge。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  nginx:
    image: nginx
    container_name: mynginx
    ports:
      - "80:80"
    networks: # 配置容器連線的網路，引用頂級 networks 下的條目
      nginx-net:

# 定義網路，可以多個
networks:
  nginx-net: # 一個具體網路的條目名稱

　　

　　以下方式的網路宣告建立網路時會使用自定義的名稱，還可以通過 driver 選擇網路模式，預設為 bridge。

# 描述 Compose 檔案的版本資訊
version: "3.8"
# 定義服務，可以多個
services:
  nginx:
    image: nginx
    container_name: mynginx
    ports:
      - "80:80"
    networks: # 配置容器連線的網路，引用頂級 networks 下的條目
      nginx-net:

# 定義網路，可以多個
networks:
  nginx-net: # 一個具體網路的條目名稱
    name: nginx-net # 網路名稱，預設為"工程名稱_網路條目名稱"
    driver: bridge # 網路模式，預設為 bridge

　　

Compose 常用命令

　　

　　官方文件：https://docs.docker.com/compose/reference/overview/

　　為了更熟練的使用 Compose，以下常用命令大家多多練習，方可熟能生巧。

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

　　部分命令選項如下：

  • -f，--file：指定使用的 Compose 模板檔案，預設為 docker-compose.yml，可以多次指定，指定多個 yml；
  • -p, --project-name：指定工程名稱，預設使用 docker-compose.yml 檔案所在目錄的名稱；
  • -v：列印版本並退出；
  • --log-level：定義日誌等級（DEBUG, INFO, WARNING, ERROR, CRITICAL）。

　　

help

　　

　　docker-compose -help 檢視幫助。

[root@localhost ~]# docker-compose -help
Define and run multi-container applications with Docker.

Usage:
  docker-compose [-f <arg>...] [options] [COMMAND] [ARGS...]
  docker-compose -h|--help

Options:
  -f, --file FILE             Specify an alternate compose file
                              (default: docker-compose.yml)
  -p, --project-name NAME     Specify an alternate project name
                              (default: directory name)
  -c, --context NAME          Specify a context name
  --verbose                   Show more output
  --log-level LEVEL           Set log level (DEBUG, INFO, WARNING, ERROR, CRITICAL)
  --no-ansi                   Do not print ANSI control characters
  -v, --version               Print version and exit
  -H, --host HOST             Daemon socket to connect to

  --tls                       Use TLS; implied by --tlsverify
  --tlscacert CA_PATH         Trust certs signed only by this CA
  --tlscert CLIENT_CERT_PATH  Path to TLS certificate file
  --tlskey TLS_KEY_PATH       Path to TLS key file
  --tlsverify                 Use TLS and verify the remote
  --skip-hostname-check       Don't check the daemon's hostname against the
                              name specified in the client certificate
  --project-directory PATH    Specify an alternate working directory
                              (default: the path of the Compose file)
  --compatibility             If set, Compose will attempt to convert keys
                              in v3 files to their non-Swarm equivalent
  --env-file PATH             Specify an alternate environment file

Commands:
  build              Build or rebuild services
  config             Validate and view the Compose file
  create             Create services
  down               Stop and remove containers, networks, images, and volumes
  events             Receive real time events from containers
  exec               Execute a command in a running container
  help               Get help on a command
  images             List images
  kill               Kill containers
  logs               View output from containers
  pause              Pause services
  port               Print the public port for a port binding
  ps                 List containers
  pull               Pull service images
  push               Push service images
  restart            Restart services
  rm                 Remove stopped containers
  run                Run a one-off command
  scale              Set number of containers for a service
  start              Start services
  stop               Stop services
  top                Display the running processes
  unpause            Unpause services
  up                 Create and start containers
  version            Show the Docker-Compose version information

　　

config

　　

　　docker-compose config -q 驗證 docker-compose.yml 檔案。當配置正確時，不輸出任何內容，當配置錯誤時，輸出錯誤資訊。

　　

pull

　　

　　docker-compose pull 拉取服務依賴的映象。

# 拉取工程中所有服務依賴的映象
docker-compose pull
# 拉取工程中 nginx 服務依賴的映象
docker-compose pull nginx
# 拉取映象過程中不列印拉取進度資訊
docker-compose pull -q

　　

up

　　

　　docker-compose up 建立並啟動所有服務的容器。指定多個 yml 加 -f 選項。以守護程序模式執行加 -d 選項。

# 前臺啟動
docker-compose up
# 後臺啟動
docker-compose up -d
# -f 指定使用的 Compose 模板檔案，預設為 docker-compose.yml，可以多次指定，指定多個 yml
docker-compose -f docker-compose.yml up -d

　　

logs

　　

　　docker-compose logs 檢視服務容器的輸出日誌。預設情況下，docker-compose 將對不同的服務輸出使用不同的顏色來區分。可以通過 --no-color 來關閉顏色。

# 輸出日誌，不同的服務輸出使用不同的顏色來區分
docker-compose logs
# 跟蹤日誌輸出
docker-compose logs -f
# 關閉顏色
docker-compose logs --no-color

　　

ps

　　

　　docker-compose ps 列出工程中所有服務的容器。

# 列出工程中所有服務的容器
docker-compose ps
# 列出工程中指定服務的容器
docker-compose ps nginx

　　

run

　　

　　docker-compose run 在指定服務容器上執行一個命令。

# 在工程中指定服務的容器上執行 echo "helloworld"
docker-compose run nginx echo "helloworld"

　　

exec

　　

　　docker-compose exec 進入服務容器。

# 進入工程中指定服務的容器
docker-compose exec nginx bash
# 當一個服務擁有多個容器時，可通過 --index 引數進入到該服務下的任何容器
docker-compose exec --index=1 nginx bash

　　

pause

　　

　　docker-compose pause 暫停服務容器。

# 暫停工程中所有服務的容器
docker-compose pause
# 暫停工程中指定服務的容器
docker-compose pause nginx

　　

unpause

　　

　　docker-compose unpause 恢復服務容器。

# 恢復工程中所有服務的容器
docker-compose unpause
# 恢復工程中指定服務的容器
docker-compose unpause nginx

　　

restart

　　

　　docker-compose restart 重啟服務容器。

# 重啟工程中所有服務的容器
docker-compose restart
# 重啟工程中指定服務的容器
docker-compose restart nginx

　　

start

　　

　　docker-compose start 啟動服務容器。

# 啟動工程中所有服務的容器
docker-compose start
# 啟動工程中指定服務的容器
docker-compose start nginx

　　

stop

　　

　　docker-compose stop 停止服務容器。

# 停止工程中所有服務的容器
docker-compose stop
# 停止工程中指定服務的容器
docker-compose stop nginx

　　

kill

　　

　　docker-compose kill 通過傳送 SIGKILL 訊號停止指定服務的容器。

# 通過傳送 SIGKILL 訊號停止工程中指定服務的容器
docker-compose kill nginx

　　

rm

　　

　　docker-compose rm 刪除服務（停止狀態）容器。

# 刪除所有（停止狀態）服務的容器
docker-compose rm
# 先停止所有服務的容器，再刪除所有服務的容器
docker-compose rm -s
# 不詢問是否刪除，直接刪除
docker-compose rm -f
# 刪除服務容器掛載的資料卷
docker-compose rm -v
# 刪除工程中指定服務的容器
docker-compose rm -sv nginx

　　

create

　　

　　docker-compose create 為服務建立容器，已不推薦使用。推薦使用 docker-compose up 來實現該功能。

　　

scale

　　

　　docker-compose scale 設定指定服務執行的容器個數，已不推薦使用。

　　推薦使用 --scale service=num 的引數來設定數量。

# 通過 --scale 指定 helloworld 服務一次性啟動 3 個
docker-compose up -d --scale helloworld=3

　　

images

　　

　　docker-compose images 列印服務容器所對應的映象。

# 列印所有服務的容器所對應的映象
docker-compose images
# 列印指定服務的容器所對應的映象
docker-compose images nginx

　　

port

　　

　　docker-compose port 列印指定服務容器的某個埠所對映的宿主機埠。

[root@localhost docker-nginx]# docker-compose port nginx 80
0.0.0.0:80

　　

top

　　

　　docker-compose top 顯示正在執行的程序。

# 顯示工程中所有服務的容器正在執行的程序
docker-compose top
# 顯示工程中指定服務的容器正在執行的程序
docker-compose top nginx

　　

總結

　　

　　Docker Compose 的整體使用步驟還是比較簡單的，三個步驟為：

  • 使用 Dockerfile 檔案定義應用程式的環境；
  • 使用 docker-compose.yml 檔案定義構成應用程式的服務，這樣它們可以在隔離環境中一起執行；
  • 最後，執行 docker-compose up 命令來建立並啟動所有服務。

　　雖然 docker-compose.yml 檔案詳解和Compose 常用命令這兩大塊的內容比較多，但是如果要快速入門使用 Compose，其實只需要瞭解其中部分內容即可。後期大家可在專案生產環境中根據自身情況再進一步深入學習即可。

　　接下來我們使用 Docker Compose 搭建一遍 Redis Cluster 叢集環境，感受感受與之前的區別。

　　

參考資料

　　

本文采用 知識共享「署名-非商業性使用-禁止演繹 4.0 國際」許可協議。

大家可以通過 分類 檢視更多關於 Docker 的文章。

　　

相關推薦

Docker 容器編排利器 Docker Compose

Compose 簡介 　　 　　通過前面幾篇文章的學習，我們可以通過 Dockerfile 檔案讓使用者很方便的定義一個單獨的應用容器。然而，在日常工作中，經常會碰到需要多個容器相互配合來完成某項任務的情況，例如之前我給大

Docker系列--容器編排工具Docker Compose詳解

1、Docker Compose概述 　　Compose是一個用於定義和執行多容器Docker應用程式的工具。使用Compose，您可以使用Compose檔案來配置應用程式的服務。然後，使用單個命令，您可以從配置中建立並啟動所有服務。

將本地的docker容器push至docker hub

技術標籤：docker 經常會遇到一個問題，run了一個docker映象之後，在裡面做了修改，比如更改環境變數或者配置安裝一些包等。退出容器再執行進入後，又要重新進行配置，繁瑣且耗時。因此將容器儲存為新的映象，就

Docker基本管理（2）——Docker容器操作、Docker網路

Docker容器操作 #容器建立:就是將映象載入到容器的過程。 新建立的容器預設處於停止狀態,不執行任何程式,需要在其中發起一個程序來啟動容器。

如何在 Docker 容器中執行 Docker?

　　在本部落格中，我將向您介紹在docker中執行docker所需的三種不同方法。 　　Docker In Docker的用處

IDEA中使用Docker Compose容器編排的實現

（一）確保idea 中連線到docker （二）打包映象 我這裡測試的是前後分離專案 如果是微服務中呢，由於前文中在pom.xml 中綁定了idea docker 打包外掛 在其 父工程中使用 打包命令 即可將其子模組 打成一個個映象

AspNetCore容器化(Docker)部署(三) —— Docker Compose容器編排

一.前言 上一篇部署了一個最基礎的helloworld應用，建立了兩個容器和一個network，還算應付得過來。

Docker Compose 容器編排 NET Core 6+MySQL 8+Nginx + Redis

Docker Compose 容器編排 NET Core 6+MySQL 8+Nginx + Redis 環境： CentOS 8.5.2111Docker 20.10.10Docker-Compose 2.1.0

Dockerfile映象製作 與 Docker-Compose容器編排

Dockerfile映象製作 docker/podman中， 映象是容器的基礎，每次執行docker run的時候都會指定哪個基本映象作為容器執行的基礎。我們之前的docker的操作都是使用來自dockerhub提供的官方映象，直接使用這些映象只能滿

Docker容器學習（四）之Docker Compose

之前的文章中，我們使用docker run 命令來啟動一個容器，而作為真正的線上業務環境，我們服務肯定不止一個，也就說明容器肯定不止一個，而如果還是手動的一個個來啟動容器這未免會讓人頭皮發麻，幸好有Docker Com

使用docker-compose管理docker容器

目錄一、作用二、安裝三、使用1.docker-compose.yaml2.指令3.啟動、關閉4、官方示例

docker容器對映UDP埠-通過docker-compose.yml

技術標籤：dockerdockerudptcp網路協議docker-compose 一、概念 Docker 埠對映即對映容器內應用的服務埠到本機宿主機器。

Docker容器自動啟動、網路型別、容器互聯、容器跨宿主機通訊、docker-compose使用-Day03

1. 重啟docker服務，容器全部退出解決辦法 1.1 方法1，執行容器時新增引數（推薦使用）

[Docker Compose定義執行多個Docker容器]

[Docker Compose定義執行多個Docker容器] Docker Compose 定義和運⾏多個 Docker 容器的應⽤（Defining and running multi-container Dockerapplications）

docker4-docker網路，容器編排，叢集部署

1，docker網路 1.1，docker0 有三個網路環境，那麼docker是如何處理容器網路訪問的？

Docker編排利器DockerCompose

Docker 編排利器 DockerCompose，編排之後可以一次性通過一條命令啟動一組服務 例如一條命令啟動 SpringBoot 專案，同時啟動 SpringBoot 專案依賴的其他中介軟體（MySQL、Redis等）

Docker與k8s的恩怨情仇（六）—— “容器編排”上演“終結者”大片

轉載請註明出處：葡萄城官網，葡萄城為開發者提供專業的開發工具、解決方案和服務，賦能開發者。

5. Docker編排三劍客之Compose

Docker-Compose 一、 Docker Compose簡介 Compose為Python編寫的，後期Docker官方又用 GO語言重寫了Docker Compose，並將其作為了docker cli的子命令，稱之為Compose V2

Docker compose 管理多個Docker容器組網實現負載均衡的方案

Compose 是用於定義和執行多容器 Docker 應用程式的工具。通過 Compose 可以使用YML檔案來配置應用程式需要的所有服務。然後，使用一個命令，就可以從YML檔案配置中建立並啟動所有服務。他是用來描述和處理複雜的但是

docker-compose（Docker服務編排）

docker 服務編排docker 服務編排也叫docker compose，它的出現是應來解決使用docker部署大型應用的業務場景的問題。通常在生產環境中，使用docker部署一個應用需要使用多個容器，例如部署前端、後端、依賴服務、資料