etcd 3.7 Документация on PIG.CENTER

Быстрый старт

Mon, 01 Jan 0001 00:00:00 +0000

Следуйте этим инструкциям, чтобы локально установить, запустить и проверить кластер etcd из одного участника:

Установите etcd из готовых бинарных файлов или исходного кода. Подробности см. в разделе [Установка][].

Предупреждение

Важно: обязательно выполните последний шаг инструкции по установке и убедитесь, что etcd доступен в пути поиска.
Запустите etcd:
```
$ etcd
{"level":"info","ts":"2021-09-17T09:19:32.783-0400","caller":"etcdmain/etcd.go:72","msg":... }
⋮
```
Примечание

Примечание: вывод etcd представляет собой журналы — сообщения уровня info можно игнорировать.

Демонстрация

Mon, 01 Jan 0001 00:00:00 +0000

В этом ряду примеров показаны базовые процедуры работы с кластером etcd.

Аутентификация

auth,user,role для аутентификации:

export ETCDCTL_API=3
ENDPOINTS=localhost:2379

etcdctl --endpoints=${ENDPOINTS} role add root
etcdctl --endpoints=${ENDPOINTS} role get root

etcdctl --endpoints=${ENDPOINTS} user add root
etcdctl --endpoints=${ENDPOINTS} user grant-role root root
etcdctl --endpoints=${ENDPOINTS} user get root

etcdctl --endpoints=${ENDPOINTS} role add role0
etcdctl --endpoints=${ENDPOINTS} role grant-permission role0 readwrite foo
etcdctl --endpoints=${ENDPOINTS} user add user0
etcdctl --endpoints=${ENDPOINTS} user grant-role user0 role0

etcdctl --endpoints=${ENDPOINTS} auth enable
# now all client requests go through auth

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# permission denied, user name is empty because the request does not issue an authentication request
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 can read the key foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Установка

Mon, 01 Jan 0001 00:00:00 +0000

Требования

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

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

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

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

Функциональные шлюзы

Mon, 01 Jan 0001 00:00:00 +0000

На этой странице представлен обзор функциональных шлюзов, которые администратор может задать для etcd.

Описание стадий возможностей приведено в разделе стадий возможностей .

Обзор

Функциональные шлюзы — набор пар key=value, описывающих возможности etcd. Возможности включаются и отключаются флагом командной строки --feature-gates процесса etcd.

etcd позволяет включить или отключить набор функциональных шлюзов. Полный список можно увидеть с помощью флага -h. Чтобы задать шлюзы, присвойте флагу --feature-gates список пар возможностей в командной строке:

Часто задаваемые вопросы

Mon, 01 Jan 0001 00:00:00 +0000

Общие вопросы об etcd

Что такое etcd?

etcd — согласованное распределённое хранилище ключей и значений. В основном оно используется как отдельная служба координации в распределённых системах и предназначено для небольших объёмов данных, целиком помещающихся в памяти.

Как произносится etcd?

etcd произносится как /ˈɛtsiːdiː/ и означает «распределённый каталог etc».

Должны ли клиенты отправлять запросы лидеру etcd?

Raft основан на лидере: лидер обрабатывает все клиентские запросы, требующие консенсуса кластера. Однако клиенту не нужно знать, какой узел является лидером. Любой требующий консенсуса запрос, отправленный последователю, автоматически пересылается лидеру. Запросы, не требующие консенсуса (например, сериализуемое чтение), может обработать любой участник кластера.

Библиотеки и инструменты

Mon, 01 Jan 0001 00:00:00 +0000

Обратите внимание: перечисленные ниже сторонние библиотеки и инструменты (размещённые не на https://github.com/etcd-io ) не тестируются и не сопровождаются командой etcd. Перед использованием рекомендуется прочитать и изучить их документацию и исходный код.

Инструменты

etcdctl — клиент командной строки для etcd
etcd-dump — утилита командной строки для выгрузки и восстановления etcd.
etcd-fs — файловая система FUSE для etcd
etcddir — синхронизация etcd с локальным каталогом в реальном времени. Работает в Windows и Linux.
etcd-browser — веб-редактор ключей и значений etcd на AngularJS
etcd-lock — реализация выборов главного узла и распределённой блокировки чтения/записи на основе etcd; поддерживает v2
etcd-console — веб-редактор ключей и значений etcd на PHP
etcd-viewer — редактор и средство просмотра хранилища ключей и значений etcd, написанное на Java
etcdtool — экспорт, импорт и редактирование каталога etcd в JSON/YAML/TOML, а также проверка каталога по схеме JSON
etcdloadtest — клиент командной строки для нагрузочного тестирования etcd версии 3.0 и выше.
etcd-tui — современный терминальный пользовательский интерфейс (TUI) для работы с базой данных etcd. Позволяет переходить по ключам, просматривать значения, фильтровать данные и управлять кластером etcd непосредственно из терминала.
etcdfinder — сверхбыстрый современный веб-интерфейс etcd с мгновенным поиском. Поддерживает etcd v2 и v3.
lucas — веб-средство просмотра ключей и значений для кластера kubernetes etcd3.0+.
etcd-manager — современный, эффективный, многоплатформенный и бесплатный графический интерфейс и клиентский инструмент etcd 3.x. Доступен для Windows, Linux и Mac.
etcd-backup-restore — утилита для периодического инкрементного резервного копирования и восстановления etcd.
etcd-druid — оператор Kubernetes для развёртывания кластеров etcd и управления эксплуатационными операциями 2-го дня.
etcdadm — инструмент командной строки для эксплуатации кластера etcd.
etcd-defrag — более удобный и интеллектуальный инструмент дефрагментации etcd.
etcdhelper — плагин платформы intellij для etcd.

Библиотеки

В следующих разделах клиентские библиотеки etcd перечислены по языкам.

Сообщение об ошибках

Mon, 01 Jan 0001 00:00:00 +0000

Если в какой-либо части проекта etcd обнаружена ошибка или неточность в документации, сообщите нам, создав issue . Мы очень серьёзно относимся к ошибкам и считаем, что незначительных проблем не бывает. Перед созданием отчёта убедитесь, что issue с описанием той же проблемы ещё не существует.

Чтобы отчёт был точным и понятным, постарайтесь соблюдать следующие требования:

Конкретность. Укажите как можно больше подробностей: версию, окружение, конфигурацию и другие существенные сведения. Если ошибка связана с работой сервера etcd, приложите журнал etcd; особенно важны начальные сообщения с конфигурацией etcd.

Настройка производительности

Mon, 01 Jan 0001 00:00:00 +0000

Настройки etcd по умолчанию хорошо подходят для локальных сетей с небольшой средней задержкой. Однако при использовании etcd в нескольких центрах обработки данных или в сети с высокой задержкой может потребоваться настроить интервал heartbeat и тайм-аут выборов.

Сеть — не единственный источник задержки. На каждый запрос и ответ могут влиять медленные диски лидера и последователя. Каждый из этих тайм-аутов охватывает полное время от отправки запроса до успешного ответа другой машины.

Временные параметры

Базовый протокол распределённого консенсуса использует два независимых временных параметра, чтобы узлы могли передать лидерство при зависании или отключении лидера. Первый параметр — интервал heartbeat. Он определяет, как часто лидер сообщает последователям, что по-прежнему остаётся лидером. Рекомендуется устанавливать его примерно равным времени кругового обхода между участниками. По умолчанию etcd использует интервал heartbeat 100ms.