etcd镜像文档

1. 镜像概述

本镜像为etcd的轻量级容器化实现，仅包含基础的etcd软件包，未集成任何预设配置、初始化脚本或特殊优化。其设计目标是提供一个纯净的etcd运行环境，允许用户完全自主控制etcd的配置与启动参数。

2. 核心功能与特性

• 极简纯净：仅包含etcd官方软件包，无多余依赖或附加组件
• 零预设配置：不包含任何默认配置文件或启动参数，完全由用户自定义
• 轻量级：镜像体积小，专注于核心etcd功能

3. 使用场景

• 开发测试环境中快速部署独立etcd实例
• 需要高度自定义配置的etcd部署场景
• 作为基础镜像构建包含特定配置的etcd衍生镜像
• 学***或调试etcd功能时的简易运行环境

4. 使用方法

4.1 基本启动命令

docker run -d \
  --name etcd-instance \
  etcd:latest \
  etcd

注：以上为最基础启动方式，未指定任何配置参数，etcd将使用默认配置（可能仅监听本地回环地址，不建议生产环境使用）。

4.2 带数据持久化的启动

docker run -d \
  --name etcd-persistent \
  -v /host/path/to/etcd-data:/data \
  etcd:latest \
  etcd --data-dir=/data

• -v /host/path/to/etcd-data:/data：将宿主机目录挂载至容器内/data目录，实现数据持久化
• --data-dir=/data：指定etcd数据存储目录

4.3 自定义网络配置的启动

docker run -d \
  --name etcd-networked \
  -p 2379:2379 \
  -p 2380:2380 \
  -v /host/path/to/data:/data \
  etcd:latest \
  etcd \
    --data-dir=/data \
    --listen-client-urls=[***] \
    --advertise-client-urls=http://localhost:2379 \
    --listen-peer-urls=[***] \
    --initial-advertise-peer-urls=http://localhost:2380

• -p 2379:2379：映射客户端通信端口
• -p 2380:2380：映射节点间通信端口
• --listen-client-urls：指定客户端监听地址（0.0.0.0表示监听所有网络接口）
• --advertise-client-urls：向客户端通告的访问地址

5. 配置说明

由于本镜像无预设配置，所有etcd参数需通过启动命令显式指定。常用核心参数说明：

完整参数列表可通过 docker run --rm etcd:latest etcd --help 查看。

6. 注意事项

• 本镜像不包含健康检查或自动重启机制，生产环境使用需额外配置
• 集群部署时需确保节点间网络互通，并正确配置集群相关参数
• 数据目录建议通过卷挂载实现持久化，避免容器删除导致数据丢失