Container on Bill.Lin's Notes

Docker Compose V2 遷移指南

Mon, 15 Jan 2024 00:00:00 +0800

V1 vs V2 的本質差異

	V1	V2
執行檔	`docker-compose`（Python）	`docker compose`（Go，Docker CLI plugin）
安裝方式	獨立 binary，另行安裝	Docker Desktop 內建；Linux 用 `docker compose plugin`
`version:` 欄位	必填（決定語法版本）	已廢棄，出現時忽略並發出警告
網路命名	`<project>_default`（底線）	`<project>-default`（連字號）
啟動指令	`docker-compose up`	`docker compose up`

V1 已於 2023 年 7 月正式 EOL，不再維護。

移除 `version:` 欄位

V1 時代的 version: "3.9" 決定 Compose 文件語法版本。V2 不再有版本差異，統一支援最新語法。

# V1 寫法（過時，V2 會警告）
version: "3.9"
services:
  app:
    image: my-app:latest

# V2 正確寫法（刪除 version 欄位）
services:
  app:
    image: my-app:latest

移除後不影響任何功能，僅消除 the attribute version is obsolete 警告。

Dockerfile 進階多階段建構

Mon, 15 Jan 2024 00:00:00 +0800

基礎複習：Builder + Runtime 模式

# Stage 1: 建構
FROM eclipse-temurin:21-jdk AS builder
WORKDIR /app
COPY . .
RUN ./mvnw package -q -DskipTests

# Stage 2: 執行（只複製 jar，不含 JDK 與 source code）
FROM eclipse-temurin:21-jre-jammy
COPY --from=builder /app/target/app.jar /app.jar
ENTRYPOINT ["java", "-jar", "/app.jar"]

多階段建構的目的：最終 image 只含執行所需的檔案，不含原始碼、建構工具、測試依賴。

Cache Mount：加速重複建構

每次 docker build 若依賴沒有改變，Maven/npm 都會重新下載套件，非常耗時。--mount=type=cache 讓套件管理器的 cache 跨 build 持久化。

Docker MySQL：容器化部署與設定

Tue, 18 Jan 2022 23:56:44 +0800

概述

在現代開發流程中，使用 Docker 部署資料庫已成為主流。將 MySQL 運行在 Docker 容器中，可以帶來許多好處：環境隔離、快速部署、版本控制、以及方便的遷移。這篇文章將引導您如何在 Docker 中設定和管理 MySQL 容器。

啟動 MySQL 容器

鏡像選擇：mysql/mysql-server 是 Oracle 的私有版本（不同於 Docker Hub 官方鏡像），現已標記為 deprecated。請使用官方 mysql 鏡像（docker.io/library/mysql）。

使用 docker run 指令可以快速啟動一個 MySQL 容器。以下是一個常用的範例，包含了密碼設定、埠映射和字元集設定。

docker run \
    --name mysql-server \
    -e MYSQL_ROOT_PASSWORD=your_strong_password \
    -p 3306:3306 \
    -d \
    mysql:8.0 \
    --character-set-server=utf8mb4 \
    --collation-server=utf8mb4_unicode_ci \
    --skip-character-set-client-handshake

指令參數說明

--name mysql-server: 為容器指定一個易於識別的名稱，這裡命名為 mysql-server。
-e MYSQL_ROOT_PASSWORD=your_strong_password: 設定 MySQL root 使用者的密碼。請務必將 your_strong_password 替換為您自己的強密碼。
-p 3306:3306: 將主機的 3306 埠映射到容器的 3306 埠。這樣您就可以從主機透過 3306 埠連接到容器內的 MySQL 服務。
-d: 以背景模式 (detached mode) 運行容器，讓容器在背景執行。
mysql:8.0: 指定要使用的 Docker 映像檔。使用 Docker Hub 官方 mysql 鏡像。
--character-set-server=utf8mb4: 設定 MySQL 伺服器的預設字元集為 utf8mb4，以支援更廣泛的字元，包括表情符號。
--collation-server=utf8mb4_unicode_ci: 設定伺服器的預設排序規則為 utf8mb4_unicode_ci，這是一種不區分大小寫和重音的排序規則。
--skip-character-set-client-handshake: 禁用客戶端字元集握手。這有助於確保客戶端和伺服器之間的字元集一致性，避免亂碼問題。

字元集設定的等效配置

上述字元集相關的 docker run 參數，在 MySQL 的配置檔 (my.cnf) 中，等效於以下設定：

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 語法來定義應用程式的服務。

Docker 網路模式詳解：容器間通訊與外部連接

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

概述

Docker 網路是容器化應用程式的基石，它決定了容器如何與外部世界通訊，以及容器之間如何互相連接。理解 Docker 的網路模式對於建構穩健、可擴展的容器化應用程式至關重要。本文將詳細介紹 Docker 提供的幾種主要網路模式及其應用場景。

Docker 網路模式

Docker 提供了多種網路驅動程式，每種驅動程式都提供不同的網路功能。最常用的包括 bridge、host、none 和 container。

1. Bridge (橋接模式)

說明：這是 Docker 的預設網路模式。當您不指定網路模式時，Docker 會自動為容器分配一個 IP 位址，並將其連接到一個名為 docker0 的虛擬橋接器上。每個容器都會獲得一個獨立的網路堆疊。
工作原理：
- Docker 會在主機上建立一個名為 docker0 的虛擬橋接器。
- 每個容器都會建立一對虛擬乙太網卡 (veth pair)，其中一端連接到容器內的 eth0，另一端連接到 docker0 橋接器。
- 容器可以透過 docker0 橋接器與同一橋接器上的其他容器通訊，也可以透過主機的網路介面與外部網路通訊。
優點：提供良好的隔離性，容器間預設不直接暴露埠。
缺點：容器需要透過埠映射才能從外部訪問。

2. Host (主機模式)

說明：在主機模式下，容器不會有自己的獨立網路堆疊，而是直接使用主機的網路堆疊。這意味著容器會直接使用主機的 IP 位址和埠。
工作原理：容器內的應用程式會直接綁定到主機的網路介面和埠上。
優點：網路效能最佳，因為沒有額外的網路層。
缺點：
- 容器不再與主機隔離，容器內應用程式使用的埠不能與主機上已佔用的埠衝突。
- 安全性較低，因為容器直接暴露在主機網路中。
使用方式：--network host

3. None (無網路模式)

說明：在無網路模式下，容器會建立一個獨立的網路堆疊，但不會對其進行任何網路配置。容器將沒有網路介面，無法與外部通訊。
工作原理：容器只包含一個 lo (loopback) 介面。
優點：適用於只需要計算資源而不需要網路連接的特殊場景，或者需要手動配置網路的進階情況。
缺點：容器無法進行任何網路通訊，除非手動配置。
使用方式：--network none

4. Container (容器模式)

說明：在容器模式下，新建立的容器不會有自己的網路堆疊，而是與另一個已存在的容器共享其網路堆疊。這意味著兩個容器會共享同一個 IP 位址和埠空間。
工作原理：兩個容器共享同一個網路命名空間。
優點：適用於需要緊密協同工作的應用程式，例如主應用程式容器和一個代理或日誌收集容器。
缺點：兩個容器會共享埠，可能導致埠衝突。
使用方式：--network container:<name_or_id>

常用 Docker 網路指令

指令	說明	範例
`docker network ls`	列出所有 Docker 網路。	`docker network ls`
`docker network prune`	刪除所有未使用的網路。	`docker network prune`
`docker network inspect <network_name_or_id>`	顯示指定網路的詳細資訊，包括連接到該網路的容器。	`docker network inspect bridge`
`docker inspect <container_id>`	顯示指定容器的詳細資訊，包括其網路配置。	`docker inspect <container_id>`

自訂網路 (User-defined Bridge Networks)

雖然 Docker 預設的 bridge 網路 (docker0) 已經足夠應付許多情況，但強烈建議您建立自訂橋接網路 (User-defined Bridge Networks)。自訂網路提供了更好的隔離性、內建的 DNS 解析和更靈活的配置。

Selenium Grid Multi-Architecture Docker 映像建構

Sun, 25 Jul 2021 02:21:13 +0800

檔名說明：本文原名 Dockerfile-docker_in_docker.md，但實際內容是 Selenium 多架構映像建構，與 DinD（Docker in Docker）技術無關。標題已更正以符合實際內容。

概述

在自動化測試和網路爬蟲等場景中，經常需要將應用程式與瀏覽器自動化工具 (如 Selenium) 打包到同一個 Docker 容器中。此外，為了支援不同的運行環境（例如 ARM64 或 x86_64 架構，以及 Firefox 或 Chrome 瀏覽器），我們需要一個靈活的建構流程。

本文將深入解析一個多階段 Dockerfile，它展示了如何：

建構一個包含 Node.js 應用程式的基礎映像檔。
利用這個基礎映像檔，為不同的 CPU 架構和瀏覽器環境建立多個最終的 Selenium 應用程式映像檔。
透過一個通用的 entrypoint.sh 腳本，在容器啟動時自動判斷環境並執行對應的測試。

Dockerfile 詳解

這個 Dockerfile 採用了多階段建構 (Multi-stage Builds) 的方式，以確保最終映像檔的輕量化和模組化。

第一階段：應用程式建構 (`build` 階段)

這個階段負責準備 Node.js 環境並打包應用程式。

FROM ubuntu:22.04 AS build

# 設定環境變數
ENV NVM_DIR /opt/nvm          # NVM (Node Version Manager) 的安裝目錄
ENV NODE_VERSION v16.13.2     # 指定要安裝的 Node.js 版本
ENV APP_DIR /app              # 應用程式的工作目錄

# 建立必要的目錄
RUN [ -d $APP_DIR ] || mkdir -p $APP_DIR
RUN [ -d $NVM_DIR ] || mkdir -p $NVM_DIR

# 更新套件列表並安裝 curl (用於下載 NVM)
RUN apt-get update && apt-get install curl -y

# 安裝 NVM 和指定版本的 Node.js
# 從 GitHub 下載 NVM 安裝腳本
RUN curl -o $NVM_DIR/install.sh https://raw.githubusercontent.com/nvm-sh/nvm/master/install.sh
# 執行 NVM 安裝腳本（只安裝 NVM 本身，尚未安裝 Node.js）
RUN /bin/bash $NVM_DIR/install.sh
# 使用 NVM 安裝並啟用指定版本的 Node.js（必須在 PATH 設定前完成）
RUN . "$NVM_DIR/nvm.sh" && nvm install $NODE_VERSION && nvm use $NODE_VERSION && nvm alias default $NODE_VERSION
# 安裝完成後再設定 PATH，確保路徑實際存在
ENV PATH $NVM_DIR/versions/node/$NODE_VERSION/bin:$PATH

# 複製應用程式檔案
COPY test /app/test          # 複製 'test' 目錄
COPY *.js /app/              # 複製所有 .js 檔案
COPY *.json /app/            # 複製所有 .json 檔案
COPY *.sh /app/              # 複製所有 .sh 腳本
RUN chmod 0755 /app/*.sh     # 為腳本添加執行權限

# 設定工作目錄並安裝 Node.js 依賴
WORKDIR $APP_DIR
RUN npm install

第二階段：Selenium 瀏覽器映像檔建構 (多個 `FROM` 階段)

這個 Dockerfile 為不同的 CPU 架構 (ARM64, x86_64) 和瀏覽器 (Firefox, Chrome) 定義了多個最終映像檔。每個階段都從一個預先建構好的 Selenium 映像檔開始，並將第一階段建構好的應用程式複製進來。

Dockerfile 基礎：建構 Docker 映像檔的核心指令

Sat, 24 Jul 2021 02:21:13 +0800

概述

Dockerfile 是一個包含一系列指令的文字檔案，Docker 引擎會讀取這些指令，並自動建構出 Docker 映像檔 (Image)。它定義了映像檔的內容、運行環境以及啟動時執行的指令。理解 Dockerfile 是掌握 Docker 容器化技術的關鍵一步。

Dockerfile 核心指令詳解

1. 基礎指令

FROM：指定基礎映像檔。Dockerfile 的第一條指令必須是 FROM。
- 語法：FROM <image>[:<tag>]
- 範例：FROM ubuntu:18.04 (使用 Ubuntu 18.04 作為基礎映像檔)
- 注意：如果未指定 tag，預設為 latest。建議明確指定版本，以確保建構的可重複性。
MAINTAINER：指定映像檔的維護者資訊。
- 語法：MAINTAINER <name> [email]
- 範例：MAINTAINER Bill.Lin <zzx123bill@gmail.com>
- 注意：此指令已過時，建議使用 LABEL 指令來替代，例如 LABEL maintainer="Bill.Lin <zzx123bill@gmail.com>"。

2. 執行指令

RUN：在建構映像檔時執行命令。每個 RUN 指令都會在映像檔中建立一個新的層 (layer)。
- 語法：
  - RUN <command> (shell 模式，預設使用 /bin/sh -c 執行)
  - RUN ["executable", "param1", "param2"] (exec 模式，直接執行可執行檔)
- 範例 (shell 模式)：
  1 2
  
  RUN apt-get update -y \ && apt-get install nginx -y
  - 注意：使用 && 將多個命令串聯起來，可以減少映像檔層數，優化映像檔大小。
- 範例 (exec 模式)：
  1 2
  
  RUN ["./test.php", "dev", "offline"] # 等同於在容器內執行 `./test.php dev offline`
CMD：設定容器啟動時預設執行的命令。如果 docker run 命令後帶有參數，CMD 的命令會被覆蓋。一個 Dockerfile 中只能有一個 CMD，多個 CMD 只有最後一個生效。