Встановлення

Вимоги

Перед встановленням etcd ознайомтеся з наступними сторінками:

• Підтримувані платформи
• Рекомендація щодо апаратного забезпечення

Встановлення з попередньо зібраних двійкових файлів

Найпростіший спосіб встановити etcd — з готових двійкових файлів:

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

2. Розпакуйте архівний файл. У результаті буде створено теку, яка міститиме двійкові файли.

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

4. За допомогою оболонки перевірте наявність etcd у вашій змінній path:

   $ 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. Change directory:

   $ cd etcd
   

3. Запустіть скрипт збірки:

   $ ./scripts/build.sh
   

   Двійкові файли знаходяться у теці bin.

4. Наприклад, додайте повний шлях до теки bin до вашої змінної path:

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

5. Перевірте, чи є etcd на вашому шляху:

   $ etcd --version
   

Встановлення за допомогою пакунків ОС

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

Існують різні способи встановлення etcd на різні операційні системи, і це лише деякі приклади того, як це можна зробити.

MacOS (Homebrew)

1. Оновіть homebrew:

$ brew update

1. Встановіть etcd:

$ brew install etcd

1. Перевірте встановлення

$ 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

Перевірка встановлення

Для дещо складнішої перевірки адекватності вашої інсталяції див. Швидкий старт.