mirrorepo Docker镜像文档

一、镜像概述和主要用途

mirrorepo 是一个 Docker 镜像仓库，主要用于缓存 kubeasz（一款轻量级 Kubernetes 集群部署工具）所需的关键依赖镜像。该镜像源自 k8s.gcr.io/dns/k8s-dns-node-cache，并扩展缓存了 kubeasz 部署过程中依赖的其他核心镜像。其核心用途是在网络受限环境（如无法直接访问 k8s.gcr.io 等外部仓库）中，为 kubeasz 提供本地镜像源，简化并加速 Kubernetes 集群的离线或本地化部署流程。

二、核心功能和特性

1. 镜像缓存与分发

• 预缓存 kubeasz 部署 Kubernetes 集群所需的关键镜像（如 k8s-dns-node-cache 等），避免重复从外部仓库拉取。
• 确保缓存镜像版本与 kubeasz 兼容，减少版本匹配问题。

2. 离线部署支持

• 无需依赖外部网络访问 k8s.gcr.io、gcr.io 等仓库，支持完全离线环境下的 Kubernetes 部署。

3. 简化部署流程

• 减少外部仓库依赖，降低因网络波动或访问限制导致的部署失败风险。
• 加速 kubeasz 部署流程，避免长时间等待外部镜像拉取。

4. 版本一致性保障

• 与 kubeasz 版本同步更新，确保缓存的镜像版本与 kubeasz 部署逻辑完全兼容。

三、使用场景和适用范围

1. 网络受限环境

• 适用于无法直接访问 k8s.gcr.io、docker.io 等外部镜像仓库的场景（如企业内网、隔离网络环境）。

2. 离线 Kubernetes 部署

• 通过 kubeasz 部署 Kubernetes 集群时，作为本地镜像源，替代外部仓库，实现完全离线部署。

3. 企业内部镜像管理

• 企业内部统一镜像分发，避免外部仓库依赖，增强部署可控性和安全性。

4. 开发测试环境

• 快速搭建 kubeasz 依赖的镜像环境，缩短开发测试周期，提高部署效率。

四、使用方法和配置说明

1. 获取镜像

根据实际环境选择以下方式获取镜像：

方式 1：从仓库拉取（若有公开仓库地址）

docker pull easzlab/mirrorepo:latest  # 假设镜像托管于 easzlab 仓库，具体地址需参考官方说明

方式 2：本地加载镜像

若通过离线文件传输获取镜像包（如 mirrorepo.tar），使用以下命令加载：

docker load -i mirrorepo.tar

2. 配置 kubeasz 使用本地镜像源

使用 mirrorepo 镜像缓存时，需修改 kubeasz 配置，指定镜像仓库为本地或私有仓库地址。

步骤 1：修改 kubeasz 配置文件

编辑 kubeasz 的全局配置文件 kubeasz/clusters/${cluster-name}/conf/hosts（或 kubeasz/conf/globals.yml），设置镜像仓库相关参数：

# 示例：指定本地镜像仓库地址（若 mirrorepo 镜像已推送到本地仓库）
IMAGE_REPO: "192.168.1.100:5000"  # 本地仓库地址，需替换为实际地址
# 若直接使用本地缓存镜像（无需仓库服务），可设置为 "localhost"

步骤 2：使用 kubeasz 离线部署参数

执行 kubeasz 部署脚本时，添加 --local 或 --offline 参数，强制使用本地镜像源：

# 例如，使用 ezdown 脚本下载依赖并指定本地镜像
cd kubeasz
./ezdown -D -l  # -l 表示使用本地镜像

3. 验证镜像可用性

检查本地缓存的镜像列表，确保包含 kubeasz 所需的关键镜像（如 k8s-dns-node-cache）：

docker images | grep "k8s-dns-node-cache"  # 验证目标镜像是否存在

五、Docker 部署方案示例

示例 1：本地镜像仓库部署（配合 registry 镜像）

若需将 mirrorepo 镜像推送到本地仓库供多节点访问，可使用 Docker Registry 搭建本地仓库：

1. 启动本地仓库服务：

docker run -d -p 5000:5000 --name local-registry registry:2

2. 标记 mirrorepo 镜像并推送到本地仓库：

docker tag easzlab/mirrorepo:latest 192.168.1.100:5000/mirrorepo:latest  # 替换为本地仓库地址
docker push 192.168.1.100:5000/mirrorepo:latest

3. 配置所有节点信任本地仓库（针对 HTTP 仓库，需修改 Docker 配置）：

# 在每个节点的 /etc/docker/daemon.json 中添加
{
  "insecure-registries": ["192.168.1.100:5000"]
}

4. 重启 Docker 服务：

systemctl restart docker

示例 2：直接使用本地镜像缓存部署 K8s

通过 kubeasz 部署 Kubernetes 时，直接引用本地缓存的 mirrorepo 镜像：

# 进入 kubeasz 目录，执行部署命令（假设已完成 hosts 配置）
cd kubeasz
./ezctl setup 1p  # 部署单节点 K8s 集群，自动使用本地镜像

六、注意事项

1. 版本兼容性：确保 mirrorepo 镜像版本与所用 kubeasz 版本匹配，避免因版本不兼容导致部署失败（可参考 kubeasz 官方文档 获取兼容信息）。
2. 镜像完整性：网络受限环境下，建议提前校验镜像文件的完整性（如通过 sha256sum 比对校验值）。
3. 仓库配置：若使用私有仓库，需确保所有节点能访问仓库地址，并配置正确的认证信息（如需）。