Установка

Требования

Перед установкой etcd ознакомьтесь со следующими страницами:

• Поддерживаемые платформы
• Рекомендации по оборудованию

Установка готовых бинарных файлов

Проще всего установить etcd из готовых бинарных файлов:

1. Загрузите с Releases сжатый архив для своей платформы, выбрав выпуск v3.7.0 или новее.

2. Распакуйте архив. В результате появится каталог с бинарными файлами.

3. Добавьте исполняемые файлы в путь поиска. Например, переименуйте и/или переместите их в каталог из пути поиска, такой как /usr/local/bin, либо добавьте в путь каталог, созданный на предыдущем шаге.

4. В оболочке проверьте, что etcd доступен в пути поиска:

   $ etcd --version
   etcd Version: 3.7.0
   ...

Сборка из исходного кода

Если установлен Go версии 1.21+ , etcd можно собрать из исходного кода:

1. Загрузите репозиторий etcd в виде zip-файла и распакуйте его либо клонируйте репозиторий следующей командой.

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

   Чтобы собрать main@HEAD, не указывайте флаг -b v3.7.0.

2. Перейдите в каталог:

   $ cd etcd

3. Запустите скрипт сборки:

   $ ./scripts/build.sh

   Бинарные файлы находятся в каталоге bin.

4. Добавьте полный путь к каталогу bin в путь поиска, например:

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

5. Проверьте, что etcd доступен в пути поиска:

   $ etcd --version

Установка из пакетов ОС

Отказ от ответственности: пакеты etcd из менеджеров пакетов ОС могут содержать устаревшие версии, поскольку они не обслуживаются автоматически и официально не поддерживаются проектом etcd. Используйте их с осторожностью.

Способы установки etcd зависят от операционной системы. Ниже приведено несколько примеров.

MacOS (Homebrew)

1. Обновите Homebrew:

$ brew update

2. Установите etcd:

$ brew install etcd

3. Проверьте установку:

$ etcd --version

Linux

etcd можно установить из официальных репозиториев и менеджеров пакетов многих крупных дистрибутивов Linux, однако опубликованные там версии могут значительно устареть. Поэтому этот способ настоятельно не рекомендуется.

Рекомендуется устанавливать etcd в Linux из готовых бинарных файлов или с помощью Homebrew.

Homebrew в Linux

Homebrew работает в Linux и предоставляет свежие версии программ.

• Предварительные условия

  • Обновите Homebrew:

    $ brew update

• Процедура

  • Установите пакет с помощью brew:

    $ brew install etcd

• Результат

  • Проверьте установленную версию:

    $ etcd --version
    etcd Version: 3.7.0
    ...

Docker

Основным реестром контейнеров etcd служит gcr.io/etcd-development/etcd , а вторичным — quay.io/coreos/etcd .

Чтобы запустить etcd в Docker:

ETCD_VER=v3.7.0

rm -rf /tmp/etcd-data.tmp && mkdir -p /tmp/etcd-data.tmp && \
  docker rmi gcr.io/etcd-development/etcd:${ETCD_VER} || true && \
  docker run \
  -p 2379:2379 \
  -p 2380:2380 \
  --mount type=bind,source=/tmp/etcd-data.tmp,destination=/etcd-data \
  --name etcd-gcr-${ETCD_VER} \
  gcr.io/etcd-development/etcd:${ETCD_VER} \
  /usr/local/bin/etcd \
  --name s1 \
  --data-dir /etcd-data \
  --listen-client-urls http://0.0.0.0:2379 \
  --advertise-client-urls http://0.0.0.0:2379 \
  --listen-peer-urls http://0.0.0.0:2380 \
  --initial-advertise-peer-urls http://0.0.0.0:2380 \
  --initial-cluster s1=http://0.0.0.0:2380 \
  --initial-cluster-token tkn \
  --initial-cluster-state new \
  --log-level info \
  --logger zap \
  --log-outputs stderr

docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcd --version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdutl version
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl endpoint health
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl put foo bar
docker exec etcd-gcr-${ETCD_VER} /usr/local/bin/etcdctl get foo

Установка в составе Kubernetes

• Запуск etcd как Kubernetes StatefulSet

Проверка установки

Более полная базовая проверка установки приведена в разделе Быстрый старт .