ETCD - Управление
Материал из support.qbpro.ru
Базовые команды
- Создать пользователя 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 etcdctl 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 etcdctl 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"
