2. 环境准备：Docker Desktop 与 Docker Engine 的安装与版本验证，配置国内镜像加速器

在开始数据库缓存回归冒烟测试之前，必须搭建标准化的容器运行时环境。本章将指导你完成 Docker Desktop（适用于 macOS/Windows）与 Docker Engine（适用于 Linux）的安装、版本验证，并配置国内镜像加速器以提升镜像拉取速度。

2.1 运行时选择：Docker Desktop vs Docker Engine

根据宿主操作系统选择对应的 Docker 运行时。下表列出了两者的核心差异与适用场景：

2.2 安装步骤与版本验证

2.2.1 Docker Desktop（macOS / Windows）

1. 访问 Docker Desktop 官方下载页，选择对应操作系统的稳定版安装包。
2. 双击安装包，按向导完成安装。macOS 用户需允许系统扩展；Windows 用户需启用 WSL2 或 Hyper-V。
3. 启动 Docker Desktop，等待右下角鲸鱼图标变为稳定状态（绿色指示灯）。
4. 打开终端，执行版本验证命令：

# 验证 Docker Engine 版本
docker version --format '{{.Server.Version}}'

# 验证 Docker Compose 版本
docker compose version

# 验证 Docker Desktop 版本（仅 Desktop 可用）
docker --version

2.2.2 Docker Engine（Linux）

1. 卸载旧版本（如有）：

sudo apt-get remove docker docker-engine docker.io containerd runc

2. 安装依赖并添加 Docker 官方 GPG 密钥与仓库（以 Ubuntu 为例）：

sudo apt-get update
sudo apt-get install ca-certificates curl gnupg
sudo install -m 0755 -d /etc/apt/keyrings
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /etc/apt/keyrings/docker.gpg
sudo chmod a+r /etc/apt/keyrings/docker.gpg

echo \
  "deb [arch=$(dpkg --print-architecture) signed-by=/etc/apt/keyrings/docker.gpg] https://download.docker.com/linux/ubuntu \
  $(. /etc/os-release && echo "$VERSION_CODENAME") stable" | \
  sudo tee /etc/apt/sources.list.d/docker.list > /dev/null

3. 安装 Docker Engine 与 Compose 插件：

sudo apt-get update
sudo apt-get install docker-ce docker-ce-cli containerd.io docker-buildx-plugin docker-compose-plugin

4. 启动 Docker 并设置开机自启：

sudo systemctl enable docker
sudo systemctl start docker

5. 将当前用户加入 docker 组（避免每次使用 sudo）：

sudo usermod -aG docker $USER
newgrp docker

6. 验证安装：

docker version --format '{{.Server.Version}}'
docker compose version

2.3 配置国内镜像加速器

由于 Docker Hub 服务器位于海外，直接拉取镜像可能速度缓慢或超时。配置国内镜像加速器可以显著提升拉取效率。以下为常用加速器地址：

2.3.1 Docker Desktop 配置加速器

1. 打开 Docker Desktop，点击右上角设置齿轮图标。
2. 导航到 Docker Engine 选项卡。
3. 在 JSON 配置中添加 registry-mirrors 字段：

{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}

4. 点击 Apply & Restart 使配置生效。

2.3.2 Docker Engine（Linux）配置加速器

1. 创建或编辑 Docker 守护进程配置文件：

sudo mkdir -p /etc/docker
sudo tee /etc/docker/daemon.json <<- 'EOF'
{
  "registry-mirrors": [
    "https://docker.mirrors.ustc.edu.cn",
    "https://hub-mirror.c.163.com"
  ]
}
EOF

2. 重新加载配置并重启 Docker：

sudo systemctl daemon-reload
sudo systemctl restart docker

3. 验证加速器是否生效：

docker info | grep -A 5 "Registry Mirrors"

预期输出应显示你配置的镜像加速器地址列表。

2.4 环境验证流程图

以下 SVG 图展示了从安装到验证的完整流程，帮助你快速定位环境准备中的关键步骤：

2.5 常见问题与排查