Containerization on Bill.Lin's Notes

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 解析和更靈活的配置。

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 只有最後一個生效。