安装

需求

在安装 etcd 之前，请参阅以下页面：

• 支持的平台
• 硬件建议

安装预编译的二进制文件

安装 etcd 最简单的方法是使用预编译的二进制文件：

1. 从 发布版本 下载适用于您平台的压缩归档文件，选择 main 或更高版本。

2. 解压归档文件。这将生成一个包含二进制文件的目录。

3. 将可执行二进制文件添加到您的 PATH 路径中。例如，将二进制文件重命名和/或移动到 PATH 中的某个目录（如 /usr/local/bin），或者将上一步创建的目录添加到您的 PATH 中。

4. 在命令行终端中测试 etcd 是否已在您的 PATH 中：

   $ etcd --version
   etcd Version: ain
   ...
   

从源码构建

如果您已安装 Go 1.21+ 版本，可以通过以下步骤从源码构建 etcd：

1. 下载 etcd 仓库的 zip 文件 并解压，或使用以下命令克隆仓库。

   $ git clone -b main https://github.com/etcd-io/etcd.git
   

   若要从 main@HEAD 构建，请省略 -b main 参数。

2. 切换目录：

   $ cd etcd
   

3. 运行构建脚本：

   $ ./scripts/build.sh
   

   生成的二进制文件位于 bin 目录下。

4. 将 bin 目录的完整路径添加到您的 PATH 中，例如：

   $ export PATH="$PATH:`pwd`/bin"
   

5. 测试 etcd 是否已在您的 PATH 中：

   $ etcd --version
   

通过操作系统包安装

免责声明：通过操作系统包管理器安装的 etcd 版本可能过时，因为这些包并未由 etcd 项目自动维护或官方支持。因此，请谨慎使用操作系统包安装方式。

在不同操作系统上有多种安装 etcd 的方法，以下仅为部分示例。

MacOS（Homebrew）

1. 更新 Homebrew：

$ brew update

2. 安装 etcd：

$ brew install etcd

3. 验证安装

$ etcd --version

Linux

尽管可以通过许多主流 Linux 发行版的官方仓库和包管理器安装 etcd，但发布的版本可能严重过时。因此，强烈不建议通过这种方式安装。

在 Linux 上安装 etcd 的推荐方式是使用预编译二进制文件，或使用 Homebrew。

Linux 上的 Homebrew

Homebrew 可以在 Linux 上运行，并且可以提供较新的软件版本。

• 前提条件

  • 更新 Homebrew：

    $ brew update
    

• 步骤

  • 使用 brew 安装：

    $ brew install etcd
    

• 结果

  • 通过获取版本号来验证安装：

    $ etcd --version
    etcd Version: ain
    ...
    

作为 Kubernetes 安装的一部分进行安装

• 以 Kubernetes StatefulSet 方式运行 etcd

安装检查

如需对您的安装进行更复杂的完整性检查，请参阅 快速开始。