Docker Compose 完整指南：多容器應用程式的定義與執行

Mon, 26 Jul 2021 02:21:13 +0800

概述

版本說明：docker-compose（帶連字號，v1 Python 實作）自 2023 年 7 月已停止維護（EOL）。現行版本為 docker compose（空格，v2 Go 實作，已整合進 Docker Desktop 與 Docker Engine）。本文使用 docker compose 指令。

在現代應用程式開發中，一個專案往往由多個服務組成，例如前端、後端 API、資料庫、快取等。這些服務各自運行在不同的容器中，而 Docker Compose 正是為了解決這種多容器應用程式的定義與管理而生。

Docker Compose 允許您使用一個 YAML 檔案 (docker-compose.yml) 來定義應用程式的所有服務、網路和儲存卷，然後透過單一指令啟動、停止或管理整個應用程式堆疊。這極大地簡化了開發、測試和部署的流程。

常用 Docker Compose 指令

以下是 Docker Compose 的一些常用指令，用於管理您的多容器應用程式：

指令	說明	範例
`docker compose version`	顯示 Docker Compose 的版本資訊。	`docker compose version`
`docker compose --help`	顯示 Docker Compose 的幫助訊息。	`docker compose --help`
`docker compose up`	啟動並建立所有服務的容器。如果容器已存在，則會重新建立。	`docker compose up`
`docker compose up -d`	在背景模式 (detached mode) 啟動並建立所有服務的容器。	`docker compose up -d`
`docker compose down`	停止並移除所有服務的容器、網路和預設儲存卷。	`docker compose down`
`docker compose exec <service_name> <command>`	在指定服務的容器中執行指令。	`docker compose exec microService /bin/bash`
`docker compose ps`	列出所有服務的容器狀態。	`docker compose ps`
`docker compose top`	顯示服務容器的運行進程。	`docker compose top`
`docker compose logs <service_name>`	顯示指定服務容器的日誌輸出。	`docker compose logs microService`
`docker compose config`	驗證 `docker-compose.yml` 檔案的語法是否正確，並顯示解析後的配置。	`docker compose config`
`docker compose config -q`	靜默模式驗證配置，只在有錯誤時輸出訊息。	`docker compose config -q`
`docker compose restart <service_name>`	重新啟動指定服務的容器。若未指定服務，則重新啟動所有服務。	`docker compose restart microService`
`docker compose start <service_name>`	啟動指定服務的容器。若未指定服務，則啟動所有已停止的服務。	`docker compose start microService`
`docker compose stop <service_name>`	停止指定服務的容器。若未指定服務，則停止所有運行中的服務。	`docker compose stop microService`

常用組合指令

1
2

# 驗證配置後，停止並重新啟動所有服務
docker compose config -q && docker compose down && docker compose up -d

`docker-compose.yml` 檔案結構詳解

docker-compose.yml 是 Docker Compose 的核心配置檔案，它使用 YAML 語法來定義應用程式的服務。

YAML 語法從入門到實踐

Tue, 29 Jun 2021 13:45:56 +0800

前言

在現代軟體開發中，設定檔是不可或缺的一環。從 Java 的 Spring Boot 框架 (Spring MVC 過往使用大量的 XML)，到我目前使用的 Hugo 靜態網站產生器，都能看到 .properties、.yml 或 .toml 等格式的身影。

雖然這些格式各有優勢，但在雲原生領域，特別是設定 Kubernetes (K8s) 資源時，YAML (YAML Ain’t Markup Language) 已成為事實上的標準。因此，掌握 YAML 的語法至關重要。

核心語法

YAML 的設計目標是易於人類閱讀和撰寫。它的語法主要基於縮排和幾個簡單的符號。

註解: 使用 # 號標示單行註解。
文件開頭: 使用三個連字號 --- 作為文件的開始符號 (選用)。

鍵值對 (Key-Value Pair)

YAML 的基本組成單位是鍵值對，格式為 key: value (注意冒號後面需要一個空格)。

`1`	`apiVersion: v1`

階層/物件 (Objects)

透過換行和縮排 (建議使用兩個空格) 來表示階層關係。這在 JSON 中相當於一個物件。

以下範例等同於 spring.datasource.username = "root"。

1
2
3

spring:
  datasource:
    username: root

陣列/列表 (Arrays/Lists)

陣列有兩種常見的表示方式：

YAML on Bill.Lin's Notes