ETCD - Управление

Базовые команды

• Создать пользователя root (для разных уровней создается root в 2х API):

1. export ETCDCTL_API=2

etcdctl user add root
etcdctl user grant root --roles root

или

ETCDCTL_API=2 etcdctl user add root
ETCDCTL_API=2 user grant root --roles root

2. export ETCDCTL_API=3

etcdctl user add root
etcdctl user grant-role root root

или

ETCDCTL_API=3 etcdctl user add root
ETCDCTL_API=3 user grant-role root root

• Задать пароль пользователю root:

etcdctl user passwd root

• Дать другому пользователю права root:

etcdctl user grant user1 --roles root

• Запросить данные пользователя (с авторизацией):

etcdctl --username root user get root

• Удалить из кластера (пример с авторизацией):

etcdctl --username root member remove c7ca032d5e048ee1

---

• Добавить клиента (хост) в кластер:

etcdctl member add newhost http://newhost.net:2380

или

ETCDCTL_API=3 etcdctl member add myhost --peer-urls=http://myhost.net:2380

• Сделать бакап кластера:

etcdctl backup --data-dir /var/lib/etcd/default --backup-dir /backup/bak-etcd.db

• Проверить состояние кластера:

etcdctl cluster-health
etcdctl --user root endpoint health
..
etcdctl member list
..
curl http://localhost:2379/v2/keys/'namespace'/'claster_name'/members/ | jq

• Рекурсивный просмотр по namespace:

etcdctl ls --recursive

• Удаление namespace (с авторизацией):

etcdctl --username root rm --recursive mynamespace

• Запрос текущего wal_segments (с авторизацией):

etcdctl --username root get /mynamespace/clastername/initialize

• Для того чтобы переназначить Leader, необходимо сначала переключиться в API=3 и потом выполнить команду выбора:

export ETCDCTL_API=3
etcdctl move-leader id-of-the-node-you-want-to-be-the-leader # в конце ID будущего Leader
или
etcdctl --user root move-leader (ID)

• Проверить состояние участников

etcdctl --cluster=true endpoint health

ОШИБКИ & РЕШЕНИЯ

• При просмотре в ETCDCTL_API=2 member list - выдает: unexpected status code 404
  • Причина: в последней версии etcd (3.4.* и выше), по умолчанию API-2 выключен.
  • Решение: в /etc/default/etcd, добавить:

#[Member]
...
ETCD_ENABLE_V2="true"

• • и перезапустить etcd.
  • !~ Аналогично можно указать и для поддержки API3: ETCD_ENABLE_V3="true"

ПОЛЕЗНОЕ

• Руководство для начинающих ETCD
• Краткое введение в etcd
• ETCD DOCS