etcd

Як налаштувати демонстраційний кластер etcd

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

На кожному вузлі etcd вкажіть членів кластера:

TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

Запустіть це на кожній машині:

# Для машини 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

Або використовуйте наш публічний сервіс виявлення:

Як налаштувати демонстраційний кластер etcd

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

На кожному вузлі etcd вкажіть членів кластера:

TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

Запустіть це на кожній машині:

# Для машини 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

Або використовуйте наш публічний сервіс виявлення:

Як налаштувати демонстраційний кластер etcd

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

На кожному вузлі etcd вкажіть членів кластера:

TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

Запустіть це на кожній машині:

# Для машини 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

Або використовуйте наш публічний сервіс виявлення:

Як налаштувати демонстраційний кластер etcd

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

На кожному вузлі etcd вкажіть членів кластера:

TOKEN=token-01
CLUSTER_STATE=new
NAME_1=machine-1
NAME_2=machine-2
NAME_3=machine-3
HOST_1=10.240.0.17
HOST_2=10.240.0.18
HOST_3=10.240.0.19
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

Запустіть це на кожній машині:

# Для машини 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

# Для машини 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 --listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 --listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} --initial-cluster-token ${TOKEN}

Або використовуйте наш публічний сервіс виявлення:

Запис до etcd

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

Передумови

Встановіть etcdctl

Процедура

Використовуйте субкоманду put для запису пари ключ-значення:

etcdctl --endpoints=$ENDPOINTS put foo "Привіт Світ!"

де:

foo є назвою ключа
"Hello World!" є значенням у лапках

Читання з etcd

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

Передумови

Встановіть etcdctl

Процедура

Використовуйте субкоманду get для читання з etcd:

$ etcdctl --endpoints=$ENDPOINTS get foo
foo
Hello World!
$

де:

foo — це потрібний ключ
Hello World! — це отримане значення

Або, для форматованого виводу:

$ etcdctl --endpoints=$ENDPOINTS --write-out="json" get foo
{"header":{"cluster_id":289318470931837780,"member_id":14947050114012957595,"revision":3,"raft_term":4,
"kvs":[{"key":"Zm9v","create_revision":2,"mod_revision":3,"version":2,"value":"SGVsbG8gV29ybGQh"}]}}
$

де write-out="json" призводить до виводу значення у форматі JSON (зверніть увагу, що ключ не повертається).

Читання з etcd

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

Передумови

Встановити etcdctl

Процедура

Використовуйте субкоманду get для читання з etcd:

$ etcdctl --endpoints=$ENDPOINTS get foo
foo
Hello World!
$

де:

foo — це потрібний ключ
Hello World! — це отримане значення

Або, для форматованого виводу:

$ etcdctl --endpoints=$ENDPOINTS --write-out="json" get foo
{"header":{"cluster_id":289318470931837780,"member_id":14947050114012957595,"revision":3,"raft_term":4,
"kvs":[{"key":"Zm9v","create_revision":2,"mod_revision":3,"version":2,"value":"SGVsbG8gV29ybGQh"}]}}
$

де write-out="json" призводить до виводу значення у форматі JSON (зверніть увагу, що ключ не повертається).

Читання з etcd

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

Передумови

Встановити etcdctl

Процедура

Використовуйте субкоманду get для читання з etcd:

$ etcdctl --endpoints=$ENDPOINTS get foo
foo
Hello World!
$

де:

foo — це потрібний ключ
Hello World! — це отримане значення

Або, для форматованого виводу:

$ etcdctl --endpoints=$ENDPOINTS --write-out="json" get foo
{"header":{"cluster_id":289318470931837780,"member_id":14947050114012957595,"revision":3,"raft_term":4,
"kvs":[{"key":"Zm9v","create_revision":2,"mod_revision":3,"version":2,"value":"SGVsbG8gV29ybGQh"}]}}
$

де write-out="json" призводить до виводу значення у форматі JSON (зверніть увагу, що ключ не повертається).

Читання з etcd

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

Передумови

Встановити etcdctl

Процедура

Використовуйте субкоманду get для читання з etcd:

$ etcdctl --endpoints=$ENDPOINTS get foo
foo
Hello World!
$

де:

foo — це потрібний ключ
Hello World! — це отримане значення

Або, для форматованого виводу:

$ etcdctl --endpoints=$ENDPOINTS --write-out="json" get foo
{"header":{"cluster_id":289318470931837780,"member_id":14947050114012957595,"revision":3,"raft_term":4,
"kvs":[{"key":"Zm9v","create_revision":2,"mod_revision":3,"version":2,"value":"SGVsbG8gV29ybGQh"}]}}
$

де write-out="json" призводить до виводу значення у форматі JSON (зверніть увагу, що ключ не повертається).

Запис до etcd

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

Передумови

Встановіть etcdctl

Процедура

Використовуйте субкоманду put для запису пари ключ-значення:

etcdctl --endpoints=$ENDPOINTS put foo "Привіт Світ!"

де:

foo є назвою ключа
"Hello World!" є значенням у лапках

Запис до etcd

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

Передумови

Встановіть etcdctl

Процедура

Використовуйте субкоманду put для запису пари ключ-значення:

etcdctl --endpoints=$ENDPOINTS put foo "Привіт Світ!"

де:

foo є назвою ключа
"Hello World!" є значенням у лапках

Запис до etcd

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

Передумови

Встановіть etcdctl

Процедура

Використовуйте субкоманду put для запису пари ключ-значення:

etcdctl --endpoints=$ENDPOINTS put foo "Привіт Світ!"

де:

foo є назвою ключа
"Hello World!" є значенням у лапках

Як отримати ключі за префіксом

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

Передумови

Отримати ключі за префіксом

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

Глобальні параметри

--endpoints=[127.0.0.1:2379], gRPC endpoints

Параметри

--prefix, отримати діапазон ключів з відповідним префіксом

Приклад

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

Як отримати ключі за префіксом

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

Передумови

Отримати ключі за префіксом

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

Глобальні параметри

--endpoints=[127.0.0.1:2379], gRPC endpoints

Параметри

--prefix, отримати діапазон ключів з відповідним префіксом

Приклад

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

Як отримати ключі за префіксом

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

Передумови

Отримати ключі за префіксом

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

Глобальні параметри

--endpoints=[127.0.0.1:2379], gRPC endpoints

Параметри

--prefix, отримати діапазон ключів з відповідним префіксом

Приклад

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

Як отримати ключі за префіксом

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

Передумови

Отримати ключі за префіксом

$ etcdctl --endpoints=$ENDPOINTS get PREFIX --prefix

Глобальні параметри

--endpoints=[127.0.0.1:2379], gRPC endpoints

Параметри

--prefix, отримати діапазон ключів з відповідним префіксом

Приклад

etcdctl --endpoints=$ENDPOINTS put web1 value1
etcdctl --endpoints=$ENDPOINTS put web2 value2
etcdctl --endpoints=$ENDPOINTS put web3 value3

etcdctl --endpoints=$ENDPOINTS get web --prefix

Як видалити ключі

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

Передумови

Встановіть etcd та etcdctl

Додавання або видалення ключів

del для видалення вказаного ключа або діапазону ключів:

etcdctl del $KEY [$END_KEY]

Опції

--prefix[=false]: видалити ключі з відповідним префіксом
--prev-kv[=false]: вивести видалені пари ключ-значення
--from-key[=false]: видалити ключі, які більші або рівні даному ключу, використовуючи байтове порівняння
--range[=false]: видалити діапазон ключів без затримки

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

etcdctl --endpoints=$ENDPOINTS put key myvalue
etcdctl --endpoints=$ENDPOINTS del key

etcdctl --endpoints=$ENDPOINTS put k1 value1
etcdctl --endpoints=$ENDPOINTS put k2 value2
etcdctl --endpoints=$ENDPOINTS del k --prefix

Як видалити ключі

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

Передумови

Встановіть etcd та etcdctl

Додавання або видалення ключів

del для видалення вказаного ключа або діапазону ключів:

etcdctl del $KEY [$END_KEY]

Опції

--prefix[=false]: видалити ключі з відповідним префіксом
--prev-kv[=false]: вивести видалені пари ключ-значення
--from-key[=false]: видалити ключі, які більші або рівні даному ключу, використовуючи байтове порівняння
--range[=false]: видалити діапазон ключів без затримки

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

etcdctl --endpoints=$ENDPOINTS put key myvalue
etcdctl --endpoints=$ENDPOINTS del key

etcdctl --endpoints=$ENDPOINTS put k1 value1
etcdctl --endpoints=$ENDPOINTS put k2 value2
etcdctl --endpoints=$ENDPOINTS del k --prefix

Як видалити ключі

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

Передумови

Встановіть etcd та etcdctl

Додавання або видалення ключів

del для видалення вказаного ключа або діапазону ключів:

etcdctl del $KEY [$END_KEY]

Опції

--prefix[=false]: видалити ключі з відповідним префіксом
--prev-kv[=false]: вивести видалені пари ключ-значення
--from-key[=false]: видалити ключі, які більші або рівні даному ключу, використовуючи байтове порівняння
--range[=false]: видалити діапазон ключів без затримки

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

etcdctl --endpoints=$ENDPOINTS put key myvalue
etcdctl --endpoints=$ENDPOINTS del key

etcdctl --endpoints=$ENDPOINTS put k1 value1
etcdctl --endpoints=$ENDPOINTS put k2 value2
etcdctl --endpoints=$ENDPOINTS del k --prefix

Як видалити ключі

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

Передумови

Встановіть etcd та etcdctl

Додавання або видалення ключів

del для видалення вказаного ключа або діапазону ключів:

etcdctl del $KEY [$END_KEY]

Опції

--prefix[=false]: видалити ключі з відповідним префіксом
--prev-kv[=false]: вивести видалені пари ключ-значення
--from-key[=false]: видалити ключі, які більші або рівні даному ключу, використовуючи байтове порівняння
--range[=false]: видалити діапазон ключів без затримки

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

etcdctl --endpoints=$ENDPOINTS put key myvalue
etcdctl --endpoints=$ENDPOINTS del key

etcdctl --endpoints=$ENDPOINTS put k1 value1
etcdctl --endpoints=$ENDPOINTS put k2 value2
etcdctl --endpoints=$ENDPOINTS del k --prefix

Як зробити кілька записів у транзакції

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

Передумови

Встановіть etcd та etcdctl.
Запущений кластер etcd.

Термінологія

Ось визначення деяких ключових термінів, що використовуються в Прикладі нижче.

Терміни	Визначення
etcdctl	Інструмент командного рядка для взаємодії з сервером etcd.
команда `txn`	Команда `txn` є скороченням від “transaction” (транзакція). Вона зчитує кілька запитів etcd зі стандартного вводу та застосовує їх як єдину атомарну транзакцію. Транзакція складається з списку умов, списку запитів для застосування, якщо всі умови істинні, та списку запитів для застосування, якщо будь-яка умова хибна. Див. Команди ключ-значення etcdctl для отримання додаткової інформації.
`compare`	Умова `compare` всередині транзакції (`txn`) слугує умовною перевіркою, яка визначає, чи слід продовжувати операції транзакції. Вона гарантує, що зміни застосовуються лише тоді, коли поточний стан сховища ключ-значення відповідає очікуваним умовам, тим самим підтримуючи узгодженість даних та запобігаючи конфліктам у одночасному середовищі. Щоб побачити структуру команди, перегляньте розділ Виконання транзакції нижче.

Транзакції

txn для обробки всіх запитів в одній транзакції:

Як зробити кілька записів у транзакції

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

Передумови

Встановіть etcd та etcdctl.
Запущений кластер etcd.

Термінологія

Ось визначення деяких ключових термінів, що використовуються в Прикладі нижче.

Терміни	Визначення
etcdctl	Інструмент командного рядка для взаємодії з сервером etcd.
команда `txn`	Команда `txn` є скороченням від “transaction” (транзакція). Вона зчитує кілька запитів etcd зі стандартного вводу та застосовує їх як єдину атомарну транзакцію. Транзакція складається з списку умов, списку запитів для застосування, якщо всі умови істинні, та списку запитів для застосування, якщо будь-яка умова хибна. Див. Команди ключ-значення etcdctl для отримання додаткової інформації.
`compare`	Умова `compare` всередині транзакції (`txn`) слугує умовною перевіркою, яка визначає, чи слід продовжувати операції транзакції. Вона гарантує, що зміни застосовуються лише тоді, коли поточний стан сховища ключ-значення відповідає очікуваним умовам, тим самим підтримуючи узгодженість даних та запобігаючи конфліктам у одночасному середовищі. Щоб побачити структуру команди, перегляньте розділ Виконання транзакції нижче.

Транзакції

txn для обробки всіх запитів в одній транзакції:

Як зробити кілька записів у транзакції

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

Передумови

Встановіть etcd та etcdctl.
Запущений кластер etcd.

Термінологія

Ось визначення деяких ключових термінів, що використовуються в Прикладі нижче.

Терміни	Визначення
etcdctl	Інструмент командного рядка для взаємодії з сервером etcd.
команда `txn`	Команда `txn` є скороченням від “transaction” (транзакція). Вона зчитує кілька запитів etcd зі стандартного вводу та застосовує їх як єдину атомарну транзакцію. Транзакція складається з списку умов, списку запитів для застосування, якщо всі умови істинні, та списку запитів для застосування, якщо будь-яка умова хибна. Див. Команди ключ-значення etcdctl для отримання додаткової інформації.
`compare`	Умова `compare` всередині транзакції (`txn`) слугує умовною перевіркою, яка визначає, чи слід продовжувати операції транзакції. Вона гарантує, що зміни застосовуються лише тоді, коли поточний стан сховища ключ-значення відповідає очікуваним умовам, тим самим підтримуючи узгодженість даних та запобігаючи конфліктам у одночасному середовищі. Щоб побачити структуру команди, перегляньте розділ Виконання транзакції нижче.

Транзакції

txn для обробки всіх запитів в одній транзакції:

Як зробити кілька записів у транзакції

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

Передумови

Встановіть etcd та etcdctl.
Запущений кластер etcd.

Термінологія

Ось визначення деяких ключових термінів, що використовуються в Прикладі нижче.

Терміни	Визначення
etcdctl	Інструмент командного рядка для взаємодії з сервером etcd.
команда `txn`	Команда `txn` є скороченням від “transaction” (транзакція). Вона зчитує кілька запитів etcd зі стандартного вводу та застосовує їх як єдину атомарну транзакцію. Транзакція складається з списку умов, списку запитів для застосування, якщо всі умови істинні, та списку запитів для застосування, якщо будь-яка умова хибна. Див. Команди ключ-значення etcdctl для отримання додаткової інформації.
`compare`	Умова `compare` всередині транзакції (`txn`) слугує умовною перевіркою, яка визначає, чи слід продовжувати операції транзакції. Вона гарантує, що зміни застосовуються лише тоді, коли поточний стан сховища ключ-значення відповідає очікуваним умовам, тим самим підтримуючи узгодженість даних та запобігаючи конфліктам у одночасному середовищі. Щоб побачити структуру команди, перегляньте розділ Виконання транзакції нижче.

Транзакції

txn для обробки всіх запитів в одній транзакції:

Як спостерігати за ключами

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

Необхідні умови

Встановіть etcd та etcdctl

Спостереження за ключами

Використовуйте watch, щоб отримувати повідомлення про майбутні зміни:

etcdctl watch $KEY [$END_KEY]

Опції

-i, --interactive[=false]: інтерактивний режим
--prefix[=false]: спостерігати за префіксом, якщо встановлено префікс
--rev=0: Ревізія для початку спостереження
--prev-kv[=false]: отримати попередню пару ключ-значення перед подією
--progress-notify[=false]: отримувати періодичні повідомлення про прогрес спостереження від сервера

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

Як спостерігати за ключами

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

Необхідні умови

Встановіть etcd та etcdctl

Спостереження за ключами

Використовуйте watch, щоб отримувати повідомлення про майбутні зміни:

etcdctl watch $KEY [$END_KEY]

Опції

-i, --interactive[=false]: інтерактивний режим
--prefix[=false]: спостерігати за префіксом, якщо встановлено префікс
--rev=0: Ревізія для початку спостереження
--prev-kv[=false]: отримати попередню пару ключ-значення перед подією
--progress-notify[=false]: отримувати періодичні повідомлення про прогрес спостереження від сервера

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

Як спостерігати за ключами

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

Необхідні умови

Встановіть etcd та etcdctl

Спостереження за ключами

Використовуйте watch, щоб отримувати повідомлення про майбутні зміни:

etcdctl watch $KEY [$END_KEY]

Опції

-i, --interactive[=false]: інтерактивний режим
--prefix[=false]: спостерігати за префіксом, якщо встановлено префікс
--rev=0: Ревізія для початку спостереження
--prev-kv[=false]: отримати попередню пару ключ-значення перед подією
--progress-notify[=false]: отримувати періодичні повідомлення про прогрес спостереження від сервера

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

Як спостерігати за ключами

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

Необхідні умови

Встановіть etcd та etcdctl

Спостереження за ключами

Використовуйте watch, щоб отримувати повідомлення про майбутні зміни:

etcdctl watch $KEY [$END_KEY]

Опції

-i, --interactive[=false]: інтерактивний режим
--prefix[=false]: спостерігати за префіксом, якщо встановлено префікс
--rev=0: Ревізія для початку спостереження
--prev-kv[=false]: отримати попередню пару ключ-значення перед подією
--progress-notify[=false]: отримувати періодичні повідомлення про прогрес спостереження від сервера

Опції, успадковані від батьківських команд

--endpoints="127.0.0.1:2379": gRPC endpoints

Приклади

Як створити оренду

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

Використовуйте lease для запису з часу існування (TTL, time-to-live) в etcd:

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa granted with TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# or after 300 seconds
etcdctl --endpoints=$ENDPOINTS get sample

Як створити оренду

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

Використовуйте lease для запису з часом існування (TTL, time-to-live) в etcd:

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa надано з TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# або після 300 секунд
etcdctl --endpoints=$ENDPOINTS get sample

Як створити оренду

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

Використовуйте lease для запису з часом існування (TTL, time-to-live) в etcd:

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa надано з TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# або після 300 секунд
etcdctl --endpoints=$ENDPOINTS get sample

Як створити оренду

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

Використовуйте lease для запису з часом існування (TTL, time-to-live) в etcd:

etcdctl --endpoints=$ENDPOINTS lease grant 300
# lease 2be7547fbc6a5afa надано з TTL(300s)

etcdctl --endpoints=$ENDPOINTS put sample value --lease=2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS get sample

etcdctl --endpoints=$ENDPOINTS lease keep-alive 2be7547fbc6a5afa
etcdctl --endpoints=$ENDPOINTS lease revoke 2be7547fbc6a5afa
# або після 300 секунд
etcdctl --endpoints=$ENDPOINTS get sample

Як створювати блокування

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

Використовуйте lock для розподіленого блокування:

etcdctl --endpoints=$ENDPOINTS lock mutex1

# another client with the same name blocks
etcdctl --endpoints=$ENDPOINTS lock mutex1

Як створювати блокування

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

LOCK здобуває розподілений мʼютекс із заданою назвою. Після отримання блокування воно утримується, доки etcdctl не буде завершено.

Передумови

Встановіть etcd та etcdctl

Створення блокування

Використовуйте lock для розподіленого блокування:

etcdctl --endpoints=$ENDPOINTS lock mutex1

Параметри

endpoints — визначає розділений комами список адрес машин у кластері.
ttl — час очікування в секундах для сесії блокування.

Як створювати блокування

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

Передумови

Встановіть etcd та etcdctl

Створення блокування

Використовуйте lock для розподіленого блокування:

etcdctl --endpoints=$ENDPOINTS lock mutex1

Параметри

endpoints — визначає розділений комами список адрес машин у кластері.
ttl — час очікування в секундах для сесії блокування.

Як створювати блокування

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

Передумови

Встановіть etcd та etcdctl

Створення блокування

Використовуйте lock для розподіленого блокування:

etcdctl --endpoints=$ENDPOINTS lock mutex1

Параметри

endpoints — визначає розділений комами список адрес машин у кластері.
ttl — час очікування в секундах для сесії блокування.

Як проводити вибори лідера в кластері etcd

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

Передумови

Переконайтеся, що etcd та etcdctl встановлені.
Перевірте наявність активного кластера etcd.

Проведення виборів лідера

Команду etcdctl використовують для проведення виборів лідера в кластері etcd. Вона гарантує, що лише один клієнт може стати лідером за раз.

etcdctl --endpoints=$ENDPOINTS elect <election-name> [proposal]

etcdctl --endpoints=$ENDPOINTS elect election-name p1

Параметри

--endpoints : $ENDPOINTS

Адреса кожного члена кластера etcd.
election-name string

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

Як проводити вибори лідера в кластері etcd

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

Передумови

Переконайтеся, що etcd та etcdctl встановлені.
Перевірте наявність активного кластера etcd.

Проведення виборів лідера

etcdctl --endpoints=$ENDPOINTS elect <election-name> [proposal]

etcdctl --endpoints=$ENDPOINTS elect election-name p1

Параметри

--endpoints : $ENDPOINTS

Адреса кожного члена кластера etcd.
election-name string

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

Як проводити вибори лідера в кластері etcd

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

Передумови

Переконайтеся, що etcd та etcdctl встановлені.
Перевірте наявність активного кластера etcd.

Проведення виборів лідера

etcdctl --endpoints=$ENDPOINTS elect <election-name> [proposal]

etcdctl --endpoints=$ENDPOINTS elect election-name p1

Параметри

--endpoints : $ENDPOINTS

Адреса кожного члена кластера etcd.
election-name string

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

Як проводити вибори лідера в кластері etcd

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

Передумови

Переконайтеся, що etcd та etcdctl встановлені.
Перевірте наявність активного кластера etcd.

Проведення виборів лідера

etcdctl --endpoints=$ENDPOINTS elect <election-name> [proposal]

etcdctl --endpoints=$ENDPOINTS elect election-name p1

Параметри

--endpoints : $ENDPOINTS

Адреса кожного члена кластера etcd.
election-name string

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

Швидкий старт

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

Дотримуйтесь цих інструкцій, щоб локально встановити, запустити і протестувати кластер, що складається з одного члена etcd:

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

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

Швидкий старт

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

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

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

Швидкий старт

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

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

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

Швидкий старт

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

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

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

Як перевірити стан кластера

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

Передумови

Встановіть etcd та etcdctl

Перевірка загального стану

endpoint status для перевірки загального стану кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: use all endpoints from the cluster member list

Перевірка справності

Використовуйте endpoint health для перевірки справності кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint health (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: use all endpoints from the cluster member list

Перевірка хешу KV

endpoint hashkv для перевірки хешу історії KV кожної точки доступу, зазначеної у прапорці --endpoints:

Як перевірити стан кластера

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

Передумови

Встановить etcd та etcdctl

Перевірка загального стану

endpoint status для перевірки загального стану кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка справності

Використовуйте endpoint health для перевірки справності кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint health (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка хешу KV

endpoint hashkv для перевірки хешу історії KV кожної точки доступу, зазначеної у прапорці --endpoints:

Як перевірити стан кластера

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

Передумови

Встановить etcd та etcdctl

Перевірка загального стану

endpoint status для перевірки загального стану кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка справності

Використовуйте endpoint health для перевірки справності кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint health (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка хешу KV

endpoint hashkv для перевірки хешу історії KV кожної точки доступу, зазначеної у прапорці --endpoints:

Як перевірити стан кластера

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

Передумови

Встановить etcd та etcdctl

Перевірка загального стану

endpoint status для перевірки загального стану кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint status (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка справності

Використовуйте endpoint health для перевірки справності кожної точки доступу, зазначеної у прапорці --endpoints:

etcdctl endpoint health (--endpoints=$ENDPOINTS|--cluster)

Параметри

--cluster[=false]: використовувати всі точки доступу зі списку учасників кластера

Перевірка хешу KV

endpoint hashkv для перевірки хешу історії KV кожної точки доступу, зазначеної у прапорці --endpoints:

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

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

Ця серія прикладів показує основні процедури роботи з кластером etcd.

Auth

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
# тепер всі запити клієнтів проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# у дозволі відмовлено, імʼя користувача порожнє, оскільки запит не видає запит на автентифікацію
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може прочитати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

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

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

Ця серія прикладів показує основні процедури роботи з кластером etcd.

Auth

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
# тепер всі запити клієнтів проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# у дозволі відмовлено, імʼя користувача порожнє, оскільки запит не видає запит на автентифікацію
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може прочитати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Як зберегти базу даних

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

Передумови

Знімок бази даних

Використовуйте snapshot для збереження знімка бази даних etcd на певний момент часу:

etcdctl --endpoints=$ENDPOINT snapshot save DB_NAME

Глобальні параметри

etcdctl

--endpoints=[127.0.0.1:2379], gRPC endpoints

Знімок можна запросити лише з одного вузла etcd, тому прапорець --endpoints повинен містити лише одну точку доступу.

etcdutl

-w, --write-out string set the output format (fields, json, protobuf, simple, table) (default "simple")

Приклад

Як зберегти базу даних

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

Передумови

Знімок бази даних

Використовуйте snapshot для збереження знімка бази даних etcd на певний момент часу:

etcdctl --endpoints=$ENDPOINT snapshot save DB_NAME

Глобальні параметри

etcdctl

--endpoints=[127.0.0.1:2379], gRPC endpoints

etcdutl

-w, --write-out string встановити формат виводу (fields, json, protobuf, simple, table) (типово "simple")

Приклад

Як зберегти базу даних

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

Передумови

Знімок бази даних

Використовуйте snapshot для збереження знімка бази даних etcd на певний момент часу:

etcdctl --endpoints=$ENDPOINT snapshot save DB_NAME

Глобальні параметри

etcdctl

--endpoints=[127.0.0.1:2379], gRPC endpoints

etcdutl

-w, --write-out string встановити формат виводу (fields, json, protobuf, simple, table) (типово "simple")

Приклад

Як зберегти базу даних

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

Передумови

Знімок бази даних

Використовуйте snapshot для збереження знімка бази даних etcd на певний момент часу:

etcdctl --endpoints=$ENDPOINT snapshot save DB_NAME

Глобальні параметри

etcdctl

--endpoints=[127.0.0.1:2379], gRPC endpoints

etcdutl

-w, --write-out string встановити формат виводу (fields, json, protobuf, simple, table) (типово "simple")

Приклад

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

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

Вимоги

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

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

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

Завантажте стиснутий файл архіву для вашої платформи з Releases, вибравши реліз v3.5.21 або пізніший.
Розпакуйте архівний файл. У результаті буде створено теку, яка міститиме двійкові файли.
Додайте виконувані двійкові файли до вашого шляху. Наприклад, перейменуйте та/або перемістіть двійкові файли до теки у вашому шляху (наприклад, /usr/local/bin), або додайте до шляху теку, створену на попередньому кроці.

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

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

Вимоги

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

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

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

Завантажте стиснутий файл архіву для вашої платформи з Releases, вибравши реліз v3.6.0 або пізніший.
Розпакуйте архівний файл. У результаті буде створено теку, яка міститиме двійкові файли.
Додайте виконувані двійкові файли до вашого шляху. Наприклад, перейменуйте та/або перемістіть двійкові файли до теки у вашому шляху (наприклад, /usr/local/bin), або додайте до шляху теку, створену на попередньому кроці.

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

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 ознайомтеся з наступними сторінками:

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

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

Завантажте стиснутий файл архіву для вашої платформи з Releases, вибравши реліз main або пізніший.
Розпакуйте архівний файл. У результаті буде створено теку, яка міститиме двійкові файли.
Додайте виконувані двійкові файли до вашого шляху. Наприклад, перейменуйте та/або перемістіть двійкові файли до теки у вашому шляху (наприклад, /usr/local/bin), або додайте до шляху теку, створену на попередньому кроці.

Функціональні можливості

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

Ця сторінка містить огляд різних функціональних можливостей, які адміністратор може вказати для etcd.

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

Огляд

Функціональні можливості — це набір пар ключ=значення, які описують функції etcd. Ви можете увімкнути або вимкнути ці функції за допомогою прапорця --feature-gates у командному рядку etcd.

etcd дозволяє увімкнути або вимкнути набір функціональних можливостей. Використовуйте прапорець -h, щоб переглянути повний набір функціональних можливостей. Щоб установити функціональні можливості, використовуйте прапорець --feature-gates із вказаним списком пар функцій у командному рядку:

Функціональні можливості

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

Ця сторінка містить огляд різних функціональних можливостей, які адміністратор може вказати для etcd.

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

Огляд

Функціональні можливості

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

Ця сторінка містить огляд різних функціональних можливостей, які адміністратор може вказати для etcd.

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

Огляд

ЧаПи

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

etcd, загальні питання

Що таке etcd?

Як вимовляється etcd?

etcd вимовляється /ˈɛtsiːdiː/ і означає “розподілена тека etc.”

Чи повинні клієнти надсилати запити до лідера etcd?

ЧаПи

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

etcd, загальні питання

Що таке etcd?

Як вимовляється etcd?

etcd вимовляється /ˈɛtsiːdiː/ і означає “розподілена тека etc.”

Чи повинні клієнти надсилати запити до лідера etcd?

ЧаПи

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

etcd, загальні питання

Що таке etcd?

Як вимовляється etcd?

etcd вимовляється /ˈɛtsiːdiː/ і означає “розподілена тека etc.”

Чи повинні клієнти надсилати запити до лідера etcd?

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

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

Зверніть увагу, що сторонні бібліотеки та інструменти (не розміщені на основному репозиторії etcd-io), згадані нижче, не тестуються та не підтримуються командою etcd. Перед їх використанням рекомендується ознайомитися з ними та провести власне розслідування.

Інструменти

etcdctl - Клієнт командного рядка для etcd
etcd-dump - Утиліта командного рядка для дампу/відновлення etcd.
etcd-fs - Файлова система FUSE для etcd
etcddir - Синхронізація etcd та локальної теки в реальному часі. Робота з windows та linux..
etcd-browser - Веб-редактор ключів/значень для etcd з використанням AngularJS
etcd-lock - Реалізація вибору майстра та розподіленого r/w блокування з використанням 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 - Сучасний, ефективний, багатоплатформний та безкоштовний GUI та клієнтський інструмент для etcd 3.x. Доступний для Windows, Linux та Mac.
etcd-backup-restore - Утиліта для періодичного та інкрементного резервного копіювання та відновлення etcd.
etcd-druid - Оператор Kubernetes для розгортання кластерів etcd та управління операціями другого дня.
etcdadm - Інструмент командного рядка для управління кластером etcd.
etcd-defrag - Зручний у використанні та розумний інструмент дефрагментації etcd.
etcdhelper - Втулок платформи intellij для etcd.
etcd-workbench - Безкоштовний та потужний UI-клієнт для etcd v3. Надає десктопний застосунок та вебпакети.

Бібліотеки

Нижче наведено клієнтські бібліотеки etcd за мовами програмування.

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

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

Інструменти

etcdctl - Клієнт командного рядка для etcd
etcd-dump - Утиліта командного рядка для дампу/відновлення etcd.
etcd-fs - Файлова система FUSE для etcd
etcddir - Синхронізація etcd та локальної теки в реальному часі. Робота з windows та linux..
etcd-browser - Веб-редактор ключів/значень для etcd з використанням AngularJS
etcd-lock - Реалізація вибору майстра та розподіленого r/w блокування з використанням 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 - Сучасний, ефективний, багатоплатформний та безкоштовний GUI та клієнтський інструмент для etcd 3.x. Доступний для Windows, Linux та Mac.
etcd-backup-restore - Утиліта для періодичного та інкрементного резервного копіювання та відновлення etcd.
etcd-druid - Оператор Kubernetes для розгортання кластерів etcd та управління операціями другого дня.
etcdadm - Інструмент командного рядка для управління кластером etcd.
etcd-defrag - Зручний у використанні та розумний інструмент дефрагментації etcd.
etcdhelper - Втулок платформи intellij для etcd.
etcd-workbench - Безкоштовний та потужний UI-клієнт для etcd v3. Надає десктопний застосунок та вебпакети.

Бібліотеки

Нижче наведено клієнтські бібліотеки etcd за мовами програмування.

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

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 - Реалізація вибору майстра та розподіленого r/w блокування з використанням 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 - Сучасний, ефективний, багатоплатформний та безкоштовний GUI та клієнтський інструмент для etcd 3.x. Доступний для Windows, Linux та Mac.
etcd-backup-restore - Утиліта для періодичного та інкрементного резервного копіювання та відновлення etcd.
etcd-druid - Оператор Kubernetes для розгортання кластерів etcd та управління операціями другого дня.
etcdadm - Інструмент командного рядка для управління кластером etcd.
etcd-defrag - Зручний у використанні та розумний інструмент дефрагментації etcd.
etcdhelper - Втулок платформи intellij для etcd.

Бібліотеки

Нижче наведено клієнтські бібліотеки etcd за мовами програмування.

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

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

Інструменти

etcdctl - Клієнт командного рядка для etcd
etcd-dump - Утиліта командного рядка для дампу/відновлення etcd.
etcd-fs - Файлова система FUSE для etcd
etcddir - Синхронізація etcd та локальної теки в реальному часі. Робота з windows та linux..
etcd-browser - Веб-редактор ключів/значень для etcd з використанням AngularJS
etcd-lock - Реалізація вибору майстра та розподіленого r/w блокування з використанням 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 - Сучасний, ефективний, багатоплатформний та безкоштовний GUI та клієнтський інструмент для etcd 3.x. Доступний для Windows, Linux та Mac.
etcd-backup-restore - Утиліта для періодичного та інкрементного резервного копіювання та відновлення etcd.
etcd-druid - Оператор Kubernetes для розгортання кластерів etcd та управління операціями другого дня.
etcdadm - Інструмент командного рядка для управління кластером etcd.
etcd-defrag - Зручний у використанні та розумний інструмент дефрагментації etcd.
etcdhelper - Втулок платформи intellij для etcd.

Бібліотеки

Нижче наведено клієнтські бібліотеки etcd за мовами програмування.

Як додавати та видаляти учасників

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

Використовуйте member для додавання, видалення, оновлення членства:

# Для кожної машини
TOKEN=my-etcd-token-1
CLUSTER_STATE=new
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_3=etcd-node-3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

# Для вузла 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

Потім замініть учасника за допомогою команд member remove та member add:

Як додавати та видаляти учасників

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

Використовуйте member для додавання, видалення, оновлення членства:

# Для кожної машини
TOKEN=my-etcd-token-1
CLUSTER_STATE=new
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_3=etcd-node-3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

# Для вузла 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

Потім замініть учасника за допомогою команд member remove та member add:

Як додавати та видаляти учасників

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

Використовуйте member для додавання, видалення, оновлення членства:

# Для кожної машини
TOKEN=my-etcd-token-1
CLUSTER_STATE=new
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_3=etcd-node-3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

# Для вузла 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

Потім замініть учасника за допомогою команд member remove та member add:

Як додавати та видаляти учасників

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

Використовуйте member для додавання, видалення, оновлення членства:

# Для кожної машини
TOKEN=my-etcd-token-1
CLUSTER_STATE=new
NAME_1=etcd-node-1
NAME_2=etcd-node-2
NAME_3=etcd-node-3
HOST_1=10.240.0.13
HOST_2=10.240.0.14
HOST_3=10.240.0.15
CLUSTER=${NAME_1}=http://${HOST_1}:2380,${NAME_2}=http://${HOST_2}:2380,${NAME_3}=http://${HOST_3}:2380

# Для вузла 1
THIS_NAME=${NAME_1}
THIS_IP=${HOST_1}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 2
THIS_NAME=${NAME_2}
THIS_IP=${HOST_2}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

# Для вузла 3
THIS_NAME=${NAME_3}
THIS_IP=${HOST_3}
etcd --data-dir=data.etcd --name ${THIS_NAME} \
	--initial-advertise-peer-urls http://${THIS_IP}:2380 \
	--listen-peer-urls http://${THIS_IP}:2380 \
	--advertise-client-urls http://${THIS_IP}:2379 \
	--listen-client-urls http://${THIS_IP}:2379 \
	--initial-cluster ${CLUSTER} \
	--initial-cluster-state ${CLUSTER_STATE} \
	--initial-cluster-token ${TOKEN}

Потім замініть учасника за допомогою команд member remove та member add:

Повідомлення про помилки

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

Якщо будь-яка частина проєкту etcd має помилки або помилки в документації, будь ласка, повідомте нам, відкривши тікет. Ми ставимося до багів і помилок дуже серйозно і вважаємо, що жодна проблема не є занадто малою. Перед створенням звіту про помилку, будь ласка, перевірте, чи не існує вже звіт про ту ж проблему.

Щоб зробити звіт про помилку точним і легким для розуміння, будь ласка, спробуйте створювати звіти про помилки, які є:

Конкретними. Включайте якомога більше деталей: яка версія, яке середовище, яка конфігурація тощо. Якщо помилка повʼязана з роботою сервера etcd, будь ласка, додайте журнал etcd (початковий журнал з конфігурацією etcd особливо важливий).

Повідомлення про помилки

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

Конкретними. Включайте якомога більше деталей: яка версія, яке середовище, яка конфігурація тощо. Якщо помилка повʼязана з роботою сервера etcd, будь ласка, додайте журнал etcd (початковий журнал з конфігурацією etcd особливо важливий).

Повідомлення про помилки

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

Конкретними. Включайте якомога більше деталей: яка версія, яке середовище, яка конфігурація тощо. Якщо помилка повʼязана з роботою сервера etcd, будь ласка, додайте журнал etcd (початковий журнал з конфігурацією etcd особливо важливий).

Повідомлення про помилки

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

Конкретними. Включайте якомога більше деталей: яка версія, яке середовище, яка конфігурація тощо. Якщо помилка повʼязана з роботою сервера etcd, будь ласка, додайте журнал etcd (початковий журнал з конфігурацією etcd особливо важливий).

Налаштування

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

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

Мережа не є єдиним джерелом затримки. На кожен запит і відповідь можуть впливати повільні диски як на лідері, так і на послідовнику. Кожен з цих тайм-аутів представляє загальний час від запиту до успішної відповіді від іншої машини.

Налаштування

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

Налаштування

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

Налаштування

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

Протокол служби виявлення

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

Протокол служби виявлення допомагає новому учаснику etcd виявити всіх інших учасників у фазі завантаження кластера за допомогою спільної URL-адреси виявлення.

Протокол служби виявлення використовується лише на етапі запуску кластера і не може застосовуватися для переналаштування під час роботи або моніторингу кластера.

Протокол використовує новий токен виявлення для завантаження одного унікального кластера etcd. Памʼятайте, що один токен виявлення може представляти лише один кластер etcd. Як тільки протокол виявлення на цьому токені починається, навіть якщо він переривається на півдорозі, його не можна використовувати для завантаження іншого кластера etcd.

Протокол служби виявлення

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

Протокол служби виявлення

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

Протокол служби виявлення

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

Протокол служби виявлення допомагає новому учаснику etcd виявити всіх інших учасників у фазі завантаження кластера за допомогою спільного токена виявлення та списку точок доступу.

Протокол служби виявлення

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

Протокол служби виявлення

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

Протокол служби виявлення

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

Протокол служби виявлення

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

Домовленості ведення журналу

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

etcd використовує бібліотеку zap для ведення журналу виводу застосунків, категоризованого на рівні. Рівень повідомлення журналу визначається відповідно до цих домовленостей:

Журнали DebugLevel зазвичай є обʼємними, і типово вимикаються у робочому середовищі.
- Приклади:
  - Надсилання звичайного повідомлення до віддаленого вузла
  - Запис елемента журналу на диск
InfoLevel є стандартним пріоритетом ведення журналу.
- Приклади:
  - Конфігурація запуску
  - Початок створення знімка
  - Додавання нового вузла до кластера
  - Додавання нового користувача до підсистеми автентифікації
Журнали WarnLevel важливіші за Info, але не потребують окремого перегляду людиною.

Домовленості ведення журналу

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

Журнали DebugLevel зазвичай є обʼємними, і типово вимикаються у робочому середовищі.
- Приклади:
  - Надсилання звичайного повідомлення до віддаленого вузла
  - Запис елемента журналу на диск
InfoLevel є стандартним пріоритетом ведення журналу.
- Приклади:
  - Конфігурація запуску
  - Початок створення знімка
  - Додавання нового вузла до кластера
  - Додавання нового користувача до підсистеми автентифікації
Журнали WarnLevel важливіші за Info, але не потребують окремого перегляду людиною.

Домовленості ведення журналу

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

Журнали DebugLevel зазвичай є обʼємними, і типово вимикаються у робочому середовищі.
- Приклади:
  - Надсилання звичайного повідомлення до віддаленого вузла
  - Запис елемента журналу на диск
InfoLevel є стандартним пріоритетом ведення журналу.
- Приклади:
  - Конфігурація запуску
  - Початок створення знімка
  - Додавання нового вузла до кластера
  - Додавання нового користувача до підсистеми автентифікації
Журнали WarnLevel важливіші за Info, але не потребують окремого перегляду людиною.

Домовленості ведення журналу

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

Журнали DebugLevel зазвичай є обʼємними, і типово вимикаються у робочому середовищі.
- Приклади:
  - Надсилання звичайного повідомлення до віддаленого вузла
  - Запис елемента журналу на диск
InfoLevel є стандартним пріоритетом ведення журналу.
- Приклади:
  - Конфігурація запуску
  - Початок створення знімка
  - Додавання нового вузла до кластера
  - Додавання нового користувача до підсистеми автентифікації
Журнали WarnLevel важливіші за Info, але не потребують окремого перегляду людиною.

Модулі Golang

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

Проєкт etcd (з версії 3.5) організований у кілька golang модулів, розміщених в одному репозиторії.

Існують наступні модулі:

go.etcd.io/etcd/api/v3 — містить визначення API (наприклад, протоколи та бібліотеки, згенеровані протоколами), що визначають протокол звʼязку між клієнтами та сервером etcd.
go.etcd.io/etcd/pkg/v3 — колекція пакунків утиліт, що використовуються etcd без привʼязки до самого etcd. Пакунок є належним тут лише якщо його можна буде в майбутньому перемістити в окремий репозиторій. Будь ласка, уникайте додавання сюди коду, який має багато залежностей, оскільки вони автоматично стають залежностями клієнтської бібліотеки (яку ми хочемо зберегти легкою).

Модулі Golang

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

Проєкт etcd (з версії 3.5) організований у кілька golang модулів, розміщених в одному репозиторії.

Існують наступні модулі:

go.etcd.io/etcd/api/v3 — містить визначення API (наприклад, протоколи та бібліотеки, згенеровані протоколами), що визначають протокол звʼязку між клієнтами та сервером etcd.
go.etcd.io/etcd/pkg/v3 — колекція пакунків утиліт, що використовуються etcd без привʼязки до самого etcd. Пакунок є належним тут лише якщо його можна буде в майбутньому перемістити в окремий репозиторій. Будь ласка, уникайте додавання сюди коду, який має багато залежностей, оскільки вони автоматично стають залежностями клієнтської бібліотеки (яку ми хочемо зберегти легкою).

Модулі Golang

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

Проєкт etcd (з версії 3.5) організований у кілька golang модулів, розміщених в одному репозиторії.

Існують наступні модулі:

go.etcd.io/etcd/api/v3 — містить визначення API (наприклад, протоколи та бібліотеки, згенеровані протоколами), що визначають протокол звʼязку між клієнтами та сервером etcd.
go.etcd.io/etcd/pkg/v3 — колекція пакунків утиліт, що використовуються etcd без привʼязки до самого etcd. Пакунок є належним тут лише якщо його можна буде в майбутньому перемістити в окремий репозиторій. Будь ласка, уникайте додавання сюди коду, який має багато залежностей, оскільки вони автоматично стають залежностями клієнтської бібліотеки (яку ми хочемо зберегти легкою).

Модулі Golang

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

Проєкт etcd (з версії 3.5) організований у кілька golang модулів, розміщених в одному репозиторії.

Існують наступні модулі:

go.etcd.io/etcd/api/v3 — містить визначення API (наприклад, протоколи та бібліотеки, згенеровані протоколами), що визначають протокол звʼязку між клієнтами та сервером etcd.
go.etcd.io/etcd/pkg/v3 — колекція пакунків утиліт, що використовуються etcd без привʼязки до самого etcd. Пакунок є належним тут лише якщо його можна буде в майбутньому перемістити в окремий репозиторій. Будь ласка, уникайте додавання сюди коду, який має багато залежностей, оскільки вони автоматично стають залежностями клієнтської бібліотеки (яку ми хочемо зберегти легкою).

Модель даних

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

etcd розроблений для надійного зберігання даних, які рідко оновлюються, та забезпечення надійних запитів на спостереження. etcd надає попередні версії пар ключ-значення для підтримки недорогих знімків та історії подій спостереження (“запити подорожей у часі”). Постійна, багатоверсійна, модель даних з контролем паралельності добре підходить для цих випадків використання.

etcd зберігає дані у багатоверсійному постійному сховищі ключ-значення. Постійне сховище ключ-значення зберігає попередню версію пари ключ-значення, коли її значення замінюється новими даними. Сховище ключ-значення фактично є незмінним; його операції не оновлюють структуру на місці, а завжди створюють нову оновлену структуру. Усі минулі версії ключів залишаються доступними та спостережуваними після модифікації. Щоб запобігти нескінченному зростанню сховища даних з часом та зберіганню старих версій, сховище може бути стиснуте для видалення найстаріших версій замінених даних.

Модель даних

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

Модель даних

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

Модель даних

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

Дизайн клієнта etcd

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

Дизайн клієнта etcd

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Вступ

Сервер etcd довів свою надійність за роки тестування з інʼєкціями відмов. Більшість складної логіки застосунків вже обробляється сервером etcd та його сховищами даних (наприклад, членство в кластері є прозорим для клієнтів, з пересиланням пропозицій на лідера на рівні Raft). Хоча компоненти сервера є правильними, його поєднання з клієнтом вимагає іншого набору складних протоколів для забезпечення його правильності та високої доступності в умовах збоїв. Ідеально, сервер etcd надає один логічний вигляд кластера з багатьох фізичних машин, а клієнт реалізує автоматичне перемикання між репліками. Цей документ описує архітектурні рішення клієнта та деталі їх реалізації.

Дизайн клієнта etcd

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

Дизайн клієнта etcd

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Вступ

Дизайн клієнта etcd

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

Дизайн клієнта etcd

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Вступ

Дизайн клієнта etcd

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

Дизайн клієнта etcd

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Вступ

Дизайн learner etcd

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

etcd Learner

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Передумови

Переналаштування членства було однією з найбільших операційних проблем. Розгляньмо поширені проблеми.

1. Новий член кластера перевантажує Лідера

Новий член etcd починає без даних, тому вимагає більше оновлень від лідера, поки не наздожене журнали лідера. Тоді мережа лідера більш ймовірно буде перевантажена, блокуючи або скидаючи такти лідера до послідовників. У такому випадку послідовник може вийти з тайм-ауту виборів і почати нові вибори лідера. Тобто кластер з новим членом більш вразливий до виборів лідера. І вибори лідера, і подальше розповсюдження оновлень новому члену схильні викликати періоди недоступності кластера (див. Рисунок 1).

Дизайн learner у etcd

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

etcd Learner

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Передумови

Переналаштування членства було однією з найбільших операційних проблем. Розгляньмо поширені виклики.

1. Новий член кластера перевантажує Лідера

Новий член etcd починає без даних, тому вимагає більше оновлень від лідера, поки не наздожене журнали лідера. Тоді мережа лідера більш ймовірно буде перевантажена, блокуючи або скидаючи повідомлення про такт лідера до послідовників. У такому випадку послідовник може завершити тайм-аут виборів і почати нові вибори лідера. Тобто кластер з новим членом більш вразливий до виборів лідера. І вибори лідера, і подальше розповсюдження оновлень новому члену схильні викликати періоди недоступності кластера (див. Рисунок 1).

Дизайн learner у etcd

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

etcd Learner

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Передумови

Переналаштування членства було однією з найбільших операційних проблем. Розгляньмо поширені виклики.

1. Новий член кластера перевантажує Лідера

Новий член etcd починає без даних, тому вимагає більше оновлень від лідера, поки не наздожене журнали лідера. Тоді мережа лідера більш ймовірно буде перевантажена, блокуючи або скидаючи повідомлення про такт лідера до послідовників. У такому випадку послідовник може завершити тайм-аут виборів і почати нові вибори лідера. Тобто кластер з новим членом більш вразливий до виборів лідера. І вибори лідера, і подальше розповсюдження оновлень новому члену схильні викликати періоди недоступності кластера (див. Рисунок 1).

Дизайн learner у etcd

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

etcd Learner

Gyuho Lee (github.com/gyuho, Amazon Web Services, Inc.), Joe Betz (github.com/jpbetz, Google Inc.)

Передумови

Переналаштування членства було однією з найбільших операційних проблем. Розгляньмо поширені виклики.

1. Новий член кластера перевантажує Лідера

Новий член etcd починає без даних, тому вимагає більше оновлень від лідера, поки не наздожене журнали лідера. Тоді мережа лідера більш ймовірно буде перевантажена, блокуючи або скидаючи повідомлення про такт лідера до послідовників. У такому випадку послідовник може завершити тайм-аут виборів і почати нові вибори лідера. Тобто кластер з новим членом більш вразливий до виборів лідера. І вибори лідера, і подальше розповсюдження оновлень новому члену схильні викликати періоди недоступності кластера (див. Рисунок 1).

Дизайн автентифікації в etcd v3

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

Чому не використовувати систему автентифікації v2?

Протокол v3 використовує gRPC як транспорт замість RESTful інтерфейсу, як у v2. Цей новий протокол надає можливість покращити дизайн v2. Наприклад, автентифікація v3 базується на зʼєднанні, а не на кожному запиті, як у v2. Крім того, семантика автентифікації v2 на практиці є незручною з погляду узгодженості, що буде описано в наступних розділах. Для v3 є чіткий опис та реалізація механізму автентифікації, який виправляє недоліки системи автентифікації v2.

Дизайн автентифікації в etcd v3

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

Чому не використовувати систему автентифікації v2?

Дизайн автентифікації в etcd v3

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

Чому не використовувати систему автентифікації v2?

Дизайн автентифікації в etcd v3

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

Чому не використовувати систему автентифікації v2?

etcd API

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

Цей документ призначений для надання огляду центрального дизайну API v3 etcd. Це не слід плутати з API v2 etcd, який був визнаний застарілим з випуском etcd v3.5. Він не є всеосяжним, але має на меті зосередитися на основних ідеях, необхідних для розуміння etcd без відволікання на менш поширені виклики API. Усі API etcd визначені в gRPC сервісах, які категоризують віддалені виклики процедур (RPC), зрозумілі серверу etcd. Повний перелік усіх RPC etcd задокументований у markdown у списку gRPC API.

etcd API

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

etcd API

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

etcd API

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

Файли постійного сховища etcd

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

Цей документ пояснює формат постійного сховища etcd: іменування, вміст та інструменти, які дозволяють розробникам перевіряти їх. У майбутньому документ буде доповнюватися змінами в моделі зберігання даних. Цей документ призначений для розробників etcd, щоб допомогти їм у відновленні даних.

Передумови

Наступні статті надають корисну інформацію для цього документа:

Огляд моделі даних etcd
Огляд Raft: https://raft.github.io/raft.pdf (особливо розділ “5.3 Реплікація журналу”).

Огляд

Довготривалі файли

Назва файлу Основна мета

./member/snap/db

bbolt b+tree, що зберігає всі застосовані дані, інформацію про авторизацію членства та метадані. Воно знає, який останній застосований індекс журналу WAL ("consistent_index").

./member/snap/0000000000000002-0000000000049425.snap
./member/snap/0000000000000002-0000000000061ace.snap

Періодичні знімки старого сховища v2, що містять:

основну інформацію про членство
версію etcd

Файли постійного сховища etcd

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

Передумови

Наступні статті надають корисну інформацію для цього документа:

Огляд моделі даних etcd
Огляд Raft: https://raft.github.io/raft.pdf (особливо розділ “5.3 Реплікація журналу”).

Огляд

Довготривалі файли

Назва файлу Основна мета

./member/snap/db

./member/snap/0000000000000002-0000000000049425.snap
./member/snap/0000000000000002-0000000000061ace.snap

Періодичні знімки старого сховища v2, що містять:

основну інформацію про членство
версію etcd

Файли постійного сховища etcd

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

Передумови

Наступні статті надають корисну інформацію для цього документа:

Огляд моделі даних etcd
Огляд Raft: https://raft.github.io/raft.pdf (особливо розділ “5.3 Реплікація журналу”).

Огляд

Довготривалі файли

Назва файлу Основна мета

./member/snap/db

./member/snap/0000000000000002-0000000000049425.snap
./member/snap/0000000000000002-0000000000061ace.snap

Періодичні знімки старого сховища v2, що містять:

основну інформацію про членство
версію etcd

Файли постійного сховища etcd

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

Передумови

Наступні статті надають корисну інформацію для цього документа:

Огляд моделі даних etcd
Огляд Raft: https://raft.github.io/raft.pdf (особливо розділ “5.3 Реплікація журналу”).

Огляд

Довготривалі файли

Назва файлу Основна мета

./member/snap/db

./member/snap/0000000000000002-0000000000049425.snap
./member/snap/0000000000000002-0000000000061ace.snap

Періодичні знімки старого сховища v2, що містять:

основну інформацію про членство
версію etcd

Гарантії API etcd

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

etcd — це консистентне та надійне сховище ключ-значення. Сховище ключ-значення доступне через gRPC Services. etcd забезпечує найсильніші гарантії консистентності та надійності для розподіленої системи. Ця специфікація перераховує гарантії API, які надає etcd.

API для розгляду

KV API
- Range
- Put
- Delete
- Transaction
Watch API
- Watch
Lease API
- Grant
- [Revoke]
- Keep alive

KV API дозволяє безпосередньо читати та маніпулювати сховищем ключ-значення. Watch API дозволяє підписуватися на зміни в сховищі ключ-значення. Lease API дозволяє призначати час життя ключа.

Гарантії API etcd

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

API для розгляду

KV API
- Range
- Put
- Delete
- Transaction
Watch API
- Watch
Lease API
- Grant
- [Revoke]
- Keep alive

Гарантії API etcd

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

API для розгляду

KV API
- Range
- RangeStream
- Put
- Delete
- Transaction
Watch API
- Watch
Lease API
- Grant
- [Revoke]
- Keep alive

Гарантії API etcd

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

API для розгляду

KV API
- Range
- RangeStream
- Put
- Delete
- Transaction
Watch API
- Watch
Lease API
- Grant
- [Revoke]
- Keep alive

etcd у порівнянні з іншими сховищами ключі-значення

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

Назва “etcd” походить від двох ідей: теки unix “/etc” та “d"istributed систем. Тека “/etc” є місцем для зберігання конфігураційних даних для однієї системи, тоді як etcd зберігає конфігураційну інформацію для великих розподілених систем. Отже, “d"istributed “/etc” — це “etcd”.

etcd розроблено як загальну основу для великих розподілених систем. Це системи, які ніколи не терплять “розділення мозку”¹ і готові пожертвувати доступністю для досягнення цієї мети. etcd зберігає метадані послідовно та відмовостійко. Кластер etcd призначений для забезпечення сховища ключ-значення з найкращою стабільністю, надійністю, масштабованістю та продуктивністю.

etcd у порівнянні з іншими сховищами ключі-значення

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

etcd у порівнянні з іншими сховищами ключі-значення

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

etcd у порівнянні з іншими сховищами ключі-значення

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

Глосарій

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

Цей документ визначає різні терміни, що використовуються в документації, командному рядку та вихідному коді etcd.

Тривога (Alarm)

Сервер etcd спричиняє тривогу, коли кластер потребує втручання оператора для збереження надійності.

Автентифікація (Authentication)

Автентифікація керує дозволами доступу користувачів до ресурсів etcd.

Клієнт (Client)

Клієнт підключається до кластера etcd для виконання сервісних запитів, таких як отримання пар ключ-значення, запис даних або спостереження за оновленнями.

Кластер (Cluster)

Кластер складається з кількох учасників.

Глосарій

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

Тривога (Alarm)

Сервер etcd спричиняє тривогу, коли кластер потребує втручання оператора для збереження надійності.

Автентифікація (Authentication)

Автентифікація керує дозволами доступу користувачів до ресурсів etcd.

Клієнт (Client)

Кластер (Cluster)

Кластер складається з кількох учасників.

Глосарій

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

Тривога (Alarm)

Сервер etcd спричиняє тривогу, коли кластер потребує втручання оператора для збереження надійності.

Автентифікація (Authentication)

Автентифікація керує дозволами доступу користувачів до ресурсів etcd.

Клієнт (Client)

Кластер (Cluster)

Кластер складається з кількох учасників.

Глосарій

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

Тривога (Alarm)

Сервер etcd спричиняє тривогу, коли кластер потребує втручання оператора для збереження надійності.

Автентифікація (Authentication)

Автентифікація керує дозволами доступу користувачів до ресурсів etcd.

Клієнт (Client)

Кластер (Cluster)

Кластер складається з кількох учасників.

Налаштування локального кластера

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

Для тестування та розробки найшвидший і найпростіший спосіб — налаштувати локальний кластер. Для розгортання в операційному середовищі зверніться до розділу кластеризація.

Локальний автономний кластер

Запуск кластера

Виконайте наступне, щоб розгорнути кластер etcd як автономний кластер:

$ ./etcd
...

Якщо бінарний файл etcd не присутній у поточній робочій теці, він може знаходитися або в $GOPATH/bin/etcd, або в /usr/local/bin/etcd. Виконайте команду відповідно.

Запущений член etcd слухає на localhost:2379 для клієнтських запитів.

Налаштування локального кластера

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

Локальний автономний кластер

Запуск кластера

Виконайте наступне, щоб розгорнути кластер etcd як автономний кластер:

$ ./etcd
...

Запущений член etcd слухає на localhost:2379 для клієнтських запитів.

Налаштування локального кластера

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

Локальний автономний кластер

Запуск кластера

Виконайте наступне, щоб розгорнути кластер etcd як автономний кластер:

$ ./etcd
...

Запущений член etcd слухає на localhost:2379 для клієнтських запитів.

Налаштування локального кластера

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

Локальний автономний кластер

Запуск кластера

Виконайте наступне, щоб розгорнути кластер etcd як автономний кластер:

$ ./etcd
...

Запущений член etcd слухає на localhost:2379 для клієнтських запитів.

Взаємодія з etcd

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

Користувачі здебільшого взаємодіють з etcd, встановлюючи або отримуючи значення ключа. У цьому розділі описано, як це зробити за допомогою etcdctl, інструменту командного рядка для взаємодії з сервером etcd. Описані концепції повинні застосовуватися до gRPC API або API бібліотеки клієнта.

Версія API, яку використовує etcdctl для взаємодії з etcd, може бути встановлена на версію 2 або 3 за допомогою змінної середовища ETCDCTL_API. Стандартно, etcdctl на master (3.4) використовує API v3, а попередні версії (3.3 і раніше) стандартно використовують API v2.

Взаємодія з etcd

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

Взаємодія з etcd

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

Взаємодія з etcd

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

Чому gRPC gateway

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

etcd v3 використовує gRPC для свого протоколу обміну повідомленнями. Проєкт etcd включає клієнт на основі gRPC Go client та утиліту командного рядка etcdctl для спілкування з кластером etcd через gRPC. Для мов, які не підтримують gRPC, etcd надає JSON gRPC gateway. Цей шлюз обслуговує RESTful проксі, який перетворює HTTP/JSON запити в gRPC повідомлення.

Використання gRPC gateway

Шлюз приймає JSON mapping для protocol buffer визначень повідомлень etcd. Зверніть увагу, що поля key та value визначені як масиви байтів і тому повинні бути закодовані в base64 у JSON. Наступні приклади використовують curl, але будь-який HTTP/JSON клієнт повинен працювати так само.

Чому gRPC gateway

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

Використання gRPC gateway

Чому gRPC gateway

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

Використання gRPC gateway

Чому gRPC gateway

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

Використання gRPC gateway

Іменування та виявлення gRPC

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

etcd надає gRPC резолвер для підтримки альтернативної системи імен, яка отримує точки доступу з etcd для виявлення gRPC сервісів. Основний механізм базується на спостереженні за оновленнями ключів з префіксом імені сервісу.

Зверніть увагу, що ця функція є експериментальною, оскільки вона залежить від пакунку google.golang.org/grpc/resolver, який досі є експериментальним у grpc-go.

Використання etcd discovery з go-grpc

Клієнт etcd надає gRPC резолвер для вирішення gRPC точок доступу з бекендом etcd. Резолвер ініціалізується клієнтом etcd:

Іменування та виявлення gRPC

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

Використання etcd discovery з go-grpc

Іменування та виявлення gRPC

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

Використання etcd discovery з go-grpc

Іменування та виявлення gRPC

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

Використання etcd discovery з go-grpc

Вбудовування etcd у застосунок на Go

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

Пакунок embed Go надає простий спосіб вбудувати сервер etcd прямо у ваш застосунок.

Для отримання додаткової інформації див. документацію пакунка embed.

Вбудовування etcd у застосунок на Go

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

Пакунок embed Go надає простий спосіб вбудувати сервер etcd прямо у ваш застосунок.

Для отримання додаткової інформації див. документацію пакунка embed.

Вбудовування etcd у застосунок на Go

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

Пакунок embed Go надає простий спосіб вбудувати сервер etcd прямо у ваш застосунок.

Для отримання додаткової інформації див. документацію пакунка embed.

Вбудовування etcd у застосунок на Go

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

Пакунок embed Go надає простий спосіб вбудувати сервер etcd прямо у ваш застосунок.

Для отримання додаткової інформації див. документацію пакунка embed.

Системні обмеження

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

Обмеження розміру запиту

etcd розроблений для обробки невеликих пар ключ-значення, типових для метаданих. Більші запити також працюватимуть, але можуть збільшити затримку інших запитів. Стандартно максимальний розмір будь-якого запиту становить 1.5 MiB. Це обмеження можна налаштувати за допомогою прапорця --max-request-bytes для сервера etcd.

Обмеження розміру зберігання

Стандартно обмеження розміру зберігання становить 2 GiB, яке можна налаштувати за допомогою прапорця --quota-backend-bytes. 8 GiB є рекомендованим максимальним розміром для нормальних середовищ, і etcd попереджає при запуску, якщо налаштоване значення перевищує його.

Системні обмеження

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

Обмеження розміру запиту

Обмеження розміру зберігання

Системні обмеження

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

Обмеження розміру запиту

Обмеження розміру зберігання

Системні обмеження

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

Обмеження розміру запиту

Обмеження розміру зберігання

Функції etcd

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

Цей документ надає огляд функцій etcd, щоб допомогти користувачам краще зрозуміти функції та повʼязаний процес їх застарівання. Якщо вас цікавить, як функції розробляються в etcd, будь ласка, перегляньте ці керівні принципи розробки.

Функції etcd поділяються на три стадії: експериментальні, стабільні та небезпечні. Ви можете отримати список функцій, запустивши etcd --help.

Експериментальні

Щоб отримати ранній зворотний звʼязок, будь-яка нова функція зазвичай додається як експериментальна. Експериментальну функцію можна визначити за назвою прапорця, яка повинна мати префікс --experimental. Будь ласка, врахуйте наступні моменти під час використання експериментальної функції:

Функції etcd

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

Експериментальні

Функції etcd

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

Експериментальні

Функції etcd

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

Експериментальні

Параметри конфігурації

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

Ви можете налаштувати etcd за допомогою наступного:

Прапорці командного рядка
Змінні середовища: кожен прапорець має відповідну змінну середовища, яка має таку ж назву, але з префіксом ETCD_ і у форматі snake case. Наприклад, --some-flag буде ETCD_SOME_FLAG.
Файл конфігурації

Увага: Якщо ви змішуєте параметри конфігурації, то застосовуються наступні правила.

Прапорці командного рядка мають пріоритет над змінними середовища.
Якщо ви надаєте файл конфігурації, всі прапорці командного рядка та змінні середовища ігноруються.

Прапорці командного рядка

Прапорці представлені нижче у форматі --flag-name DEFAULT_VALUE.

Параметри конфігурації

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

Ви можете налаштувати etcd за допомогою наступного:

Прапорці командного рядка
Змінні середовища: кожен прапорець має відповідну змінну середовища, яка має таку ж назву, але з префіксом ETCD_ і у форматі snake case. Наприклад, --some-flag буде ETCD_SOME_FLAG.
Файл конфігурації

Увага: Якщо ви змішуєте параметри конфігурації, то застосовуються наступні правила.

Прапорці командного рядка мають пріоритет над змінними середовища.
Якщо ви надаєте файл конфігурації, всі прапорці командного рядка та змінні середовища ігноруються.

Прапорці командного рядка

Прапорці представлені нижче у форматі --flag-name DEFAULT_VALUE.

Параметри конфігурації

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

Ви можете налаштувати etcd за допомогою наступного:

Прапорці командного рядка
Змінні середовища: кожен прапорець має відповідну змінну середовища, яка має таку ж назву, але з префіксом ETCD_ і у форматі snake case. Наприклад, --some-flag буде ETCD_SOME_FLAG.
Файл конфігурації

Увага: Якщо ви змішуєте параметри конфігурації, то застосовуються наступні правила.

Прапорці командного рядка мають пріоритет над змінними середовища.
Якщо ви надаєте файл конфігурації, всі прапорці командного рядка та змінні середовища ігноруються.

Прапорці командного рядка

Прапорці представлені нижче у форматі --flag-name DEFAULT_VALUE.

Параметри конфігурації

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

Ви можете налаштувати etcd за допомогою наступного:

Прапорці командного рядка
Змінні середовища: кожен прапорець має відповідну змінну середовища, яка має таку ж назву, але з префіксом ETCD_ і у форматі snake case. Наприклад, --some-flag буде ETCD_SOME_FLAG.
Файл конфігурації

Увага: Якщо ви змішуєте параметри конфігурації, то застосовуються наступні правила.

Прапорці командного рядка мають пріоритет над змінними середовища.
Якщо ви надаєте файл конфігурації, всі прапорці командного рядка та змінні середовища ігноруються.

Прапорці командного рядка

Прапорці представлені нижче у форматі --flag-name DEFAULT_VALUE.

Контроль доступу на основі ролей

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

Огляд

Автентифікація була додана в etcd 2.1. API v3 etcd трохи змінив API функції автентифікації та інтерфейс користувача, щоб краще відповідати новій моделі даних. Цей посібник призначений для допомоги користувачам у налаштуванні базової автентифікації та контролю доступу на основі ролей в etcd v3.

Спеціальні користувачі та ролі

Існує один спеціальний користувач, root, і одна спеціальна роль, root.

Користувач `root`

Користувач root, який має повний доступ до etcd, повинен бути створений перед активацією автентифікації. Ідея користувача root полягає в адміністративних цілях: управління ролями та звичайними користувачами. Користувач root повинен мати роль root і має право змінювати будь-що всередині etcd.

Контроль доступу на основі ролей

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

Огляд

Спеціальні користувачі та ролі

Існує один спеціальний користувач, root, і одна спеціальна роль, root.

Користувач `root`

Контроль доступу на основі ролей

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

Огляд

Спеціальні користувачі та ролі

Існує один спеціальний користувач, root, і одна спеціальна роль, root.

Користувач `root`

Контроль доступу на основі ролей

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

Огляд

Спеціальні користувачі та ролі

Існує один спеціальний користувач, root, і одна спеціальна роль, root.

Користувач `root`

Модель транспортної безпеки

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

etcd підтримує автоматичний TLS, а також автентифікацію через клієнтські сертифікати як для клієнтів до сервера, так і для звʼязку між вузлами (сервер до сервера / кластер). Зверніть увагу, що etcd стандартно не вмикає автентифікацію на основі RBAC або функцію автентифікації на транспортному рівні, щоб зменшити труднощі для користувачів, які починають працювати з базою даних. Крім того, зміна цього стандартного параметра буде порушенням для проєкту, який був заснований у 2013 році. Кластер etcd, який не вмикає функції безпеки, може експонувати свої дані будь-яким клієнтам.

Модель транспортної безпеки

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

etcd підтримує автоматичний TLS, а також автентифікацію через клієнтські сертифікати як для клієнтів до сервера, так і для звʼязку між вузлами (сервер до сервера / кластер).

Попередження

etcd стандартно не вмикає автентифікацію на основі RBAC або функцію автентифікації на транспортному рівні, щоб зменшити труднощі для користувачів, які починають працювати з базою даних. Крім того, зміна цього стандартного параметра буде порушенням для проєкту, який був заснований у 2013 році. Кластер etcd, який не вмикає функції безпеки, може експонувати свої дані будь-яким клієнтам.

Модель транспортної безпеки

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

Модель транспортної безпеки

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

Посібник з кластеризації

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

Огляд

Запуск кластера etcd статично вимагає, щоб кожен учасник знав іншого в кластері. У ряді випадків IP-адреси учасників кластера можуть бути невідомі заздалегідь. У таких випадках кластер etcd можна запустити за допомогою служби виявлення.

Після запуску кластера etcd додавання або видалення учасників здійснюється через переконфігурацію під час виконання. Щоб краще зрозуміти дизайн переконфігурації під час виконання, рекомендуємо прочитати документ про дизайн переконфігурації під час виконання.

Цей посібник охоплює наступні механізми запуску кластера etcd:

Посібник з кластеризації

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

Огляд

Цей посібник охоплює наступні механізми запуску кластера etcd:

Посібник з кластеризації

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

Огляд

Цей посібник охоплює наступні механізми запуску кластера etcd:

Посібник з кластеризації

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

Огляд

Цей посібник охоплює наступні механізми запуску кластера etcd:

Запуск кластерів etcd у контейнерах

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

Наступний посібник показує, як запустити etcd з Docker за допомогою статичного процесу початкового завантаження.

Docker

Щоб відкрити API etcd для клієнтів за межами хосту Docker, використовуйте IP-адресу хосту контейнера. Будь ласка, дивіться docker inspect для отримання додаткової інформації про те, як отримати IP-адресу. Альтернативно, вкажіть прапорець --net=host для команди docker run, щоб пропустити розміщення контейнера всередині окремого мережевого стека.

Запуск одного вузла etcd

Використовуйте IP-адресу хосту при налаштуванні etcd:

Запуск кластерів etcd у контейнерах

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

Наступний посібник показує, як запустити etcd з Docker за допомогою статичного процесу початкового завантаження.

Docker

Запуск одного вузла etcd

Використовуйте IP-адресу хосту при налаштуванні etcd:

Запуск кластерів etcd у контейнерах

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

Наступний посібник показує, як запустити etcd з Docker за допомогою статичного процесу початкового завантаження.

Docker

Запуск одного вузла etcd

Використовуйте IP-адресу хосту при налаштуванні etcd:

Запуск кластерів etcd у контейнерах

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

Наступний посібник показує, як запустити etcd з Docker за допомогою статичного процесу початкового завантаження.

Docker

Запуск одного вузла etcd

Використовуйте IP-адресу хосту при налаштуванні etcd:

Запуск кластерів etcd як Kubernetes StatefulSet

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

Нижче показано, як виконати статичний процес завантаження як Kubernetes StatefulSet.

Приклад маніфесту

Цей маніфест містить сервіс та statefulset для розгортання статичного кластера etcd у Kubernetes.

Якщо ви скопіюєте вміст маніфесту у файл з назвою etcd.yaml, його можна застосувати до кластера за допомогою цієї команди.

$ kubectl apply --filename etcd.yaml

Після застосування, зачекайте, поки podʼи стануть готовими.

$ kubectl get pods
NAME READY STATUS RESTARTS AGE
etcd-0 1/1 Running 0 24m
etcd-1 1/1 Running 0 24m
etcd-2 1/1 Running 0 24m

Контейнер, використаний у прикладі, включає etcdctl і може бути викликаний безпосередньо всередині podʼів.

Запуск кластерів etcd як Kubernetes StatefulSet

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

Нижче показано, як виконати статичний процес завантаження як Kubernetes StatefulSet.

Приклад маніфесту

Цей маніфест містить сервіс та statefulset для розгортання статичного кластера etcd у Kubernetes.

$ kubectl apply --filename etcd.yaml

Після застосування, зачекайте, поки podʼи стануть готовими.

$ kubectl get pods
NAME READY STATUS RESTARTS AGE
etcd-0 1/1 Running 0 24m
etcd-1 1/1 Running 0 24m
etcd-2 1/1 Running 0 24m

Контейнер, використаний у прикладі, включає etcdctl і може бути викликаний безпосередньо всередині podʼів.

Запуск кластерів etcd як Kubernetes StatefulSet

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

Нижче показано, як виконати статичний процес завантаження як Kubernetes StatefulSet.

Приклад маніфесту

Цей маніфест містить сервіс та statefulset для розгортання статичного кластера etcd у Kubernetes.

$ kubectl apply --filename etcd.yaml

Після застосування, зачекайте, поки podʼи стануть готовими.

$ kubectl get pods
NAME READY STATUS RESTARTS AGE
etcd-0 1/1 Running 0 24m
etcd-1 1/1 Running 0 24m
etcd-2 1/1 Running 0 24m

Контейнер, використаний у прикладі, включає etcdctl і може бути викликаний безпосередньо всередині podʼів.

Запуск кластерів etcd як Kubernetes StatefulSet

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

Нижче показано, як виконати статичний процес завантаження як Kubernetes StatefulSet.

Приклад маніфесту

Цей маніфест містить сервіс та statefulset для розгортання статичного кластера etcd у Kubernetes.

$ kubectl apply --filename etcd.yaml

Після застосування, зачекайте, поки podʼи стануть готовими.

$ kubectl get pods
NAME READY STATUS RESTARTS AGE
etcd-0 1/1 Running 0 24m
etcd-1 1/1 Running 0 24m
etcd-2 1/1 Running 0 24m

Контейнер, використаний у прикладі, включає etcdctl і може бути викликаний безпосередньо всередині podʼів.

Режими відмов

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

Відмови є звичайним явищем у великому розгортанні машин. Машина виходить з ладу, коли її апаратне або програмне забезпечення виходить з ладу. Кілька машин виходять з ладу одночасно, коли виникають перебої з електроживленням або проблеми з мережею. Також можуть статися кілька видів відмов одночасно; майже неможливо перерахувати всі можливі випадки відмов.

У цьому розділі ми каталогізуємо види відмов і обговорюємо, як etcd розроблений для стійкості до цих відмов. Більшість користувачів, якщо не всі, можуть зіставити конкретну відмову з одним із видів відмов. Щоб підготуватися до рідкісних або непоправних відмов, завжди робіть резервні копії кластера etcd.

Режими відмов

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

Відмови є звичайним явищем у великому розгортанні машин. Машина виходить з ладу, коли її апаратне або програмне забезпечення виходить з ладу. Кілька машин виходять з ладу одночасно, коли виникають перебої з електроживленням або проблеми з мережею. Також можуть статися кілька видів відмов одночасно; майше неможливо перерахувати всі можливі випадки відмов.

Режими відмов

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

Відмови є звичайним явищем у великому розгортанні машин. Машина виходить з ладу, коли її апаратне або програмне забезпечення виходить з ладу. Кілька машин виходять з ладу одночасно, коли виникають перебої з електроживленням або проблеми з мережею. Також можуть статися кілька видів відмов одночасно; майше неможливо перерахувати всі можливі випадки відмов.

Режими відмов

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

Відмови є звичайним явищем у великому розгортанні машин. Машина виходить з ладу, коли її апаратне або програмне забезпечення виходить з ладу. Кілька машин виходять з ладу одночасно, коли виникають перебої з електроживленням або проблеми з мережею. Також можуть статися кілька видів відмов одночасно; майше неможливо перерахувати всі можливі випадки відмов.

Відновлення після катастрофи

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

etcd розроблений для витримування збоїв машин. Кластер etcd автоматично відновлюється після тимчасових збоїв (наприклад, перезавантаження машини) і витримує до (N-1)/2 постійних збоїв для кластера з N учасників. Коли учасник постійно виходить з ладу, хай то через апаратний збій або пошкодження диска, він втрачає доступ до кластера. Якщо кластер постійно втрачає більше ніж (N-1)/2 учасників, то він катастрофічно виходить з ладу, безповоротно втрачаючи кворум. Після втрати кворуму кластер не може досягти консенсусу і, отже, не може продовжувати приймати оновлення.

Відновлення після катастрофи

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

Відновлення після катастрофи

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

Відновлення після катастрофи

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

etcd gateway

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

Що таке etcd gateway

etcd gateway — це простий TCP-проксі, який пересилає мережеві дані до кластера etcd. Шлюз є stateless та прозорим; він не перевіряє запити клієнтів і не втручається у відповіді кластера. Він не термінує TLS-зʼєднання, не виконує TLS-рукостискання від імені своїх клієнтів і не перевіряє, чи є зʼєднання захищеним.

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

etcd gateway

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

Що таке etcd gateway

etcd gateway

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

Що таке etcd gateway

etcd gateway

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

Що таке etcd gateway

gRPC proxy

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

gRPC proxy — це stateless зворотний проксі-сервер etcd, що працює на рівні gRPC (L7). Проксі-сервер призначений для зменшення загального навантаження на основний кластер etcd. Для горизонтальної масштабованості він обʼєднує запити API спостереження та оренди. Щоб захистити кластер від зловмисних клієнтів, він кешує запити діапазону ключів.

gRPC proxy підтримує кілька точок доступу сервера etcd. Коли проксі-сервер запускається, він випадковим чином вибирає одну точку доступу сервера etcd для використання. Ця точка доступу обслуговує всі запити, доки проксі-сервер не виявить збій точки доступу. Якщо gRPC proxy виявляє збій точки доступу, він перемикається на іншу точку доступу, якщо вона доступна, щоб приховати збої від своїх клієнтів. Інші політики повторних спроб, такі як зважений круговий алгоритм, можуть бути підтримані в майбутньому.

gRPC proxy

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

gRPC proxy

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

gRPC proxy

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

Обслуговування

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

Огляд

Кластер etcd потребує періодичного обслуговування, щоб залишатися надійним. Залежно від потреб застосунку etcd, це обслуговування зазвичай можна автоматизувати та виконувати без простоїв або значного зниження продуктивності.

Все обслуговування etcd керує ресурсами зберігання, які споживає ключовий простір etcd. Недостатній контроль розміру ключового простору захищений квотами на дисковий простір; якщо учаснику etcd не вистачає місця, квота викликає кластерні тривоги, які переводять систему в режим обмеженого обслуговування. Щоб уникнути нестачі місця для записів у ключовий простір, історія ключового простору etcd повинна бути стиснута. Сам дисковий простір можна відновити шляхом дефрагментації учасників etcd. Нарешті, періодичні резервні копії знімків стану учасників etcd дозволяють відновити будь-які ненавмисні логічні втрати даних або пошкодження, спричинені операційною помилкою.

Обслуговування

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

Огляд

Обслуговування

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

Огляд

Обслуговування

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

Огляд

Моніторинг etcd

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

Кожен сервер etcd надає локальну інформацію про моніторинг на своєму клієнтському порту через точки доступу http. Дані моніторингу корисні як для перевірки справності системи, так і для налагодження кластера.

Debug endpoint

Якщо встановлено --log-level=debug, сервер etcd експортує інформацію для налагодження на своєму клієнтському порту за шляхом /debug. Будьте обережні при встановленні --log-level=debug, оскільки це призведе до зниження продуктивності та великої кількості логів.

Точка доступу /debug/pprof є стандартною точкою доступу для профілювання виконання Go. Це можна використовувати для профілювання використання CPU, heap, mutex та goroutine. Наприклад, тут go tool pprof отримує топ 10 функцій, де etcd витрачає свій час:

Моніторинг etcd

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

Debug endpoint

Моніторинг etcd

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

Debug endpoint

Моніторинг etcd

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

Debug endpoint

Продуктивність

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

Розуміння продуктивності

etcd забезпечує стабільну, стійку високу продуктивність. Два фактори визначають продуктивність: затримка та пропускна здатність. Затримка — це час, необхідний для завершення операції. Пропускна здатність — це загальна кількість операцій, виконаних за певний період часу. Зазвичай середня затримка збільшується зі збільшенням загальної пропускної здатності, коли etcd приймає одночасні запити клієнтів. У звичайних хмарних середовищах, таких як стандартний n-4 у Google Compute Engine (GCE) або аналогічний тип машини на AWS, кластер etcd з трьох учасників завершує запит менш ніж за одну мілісекунду при невеликому навантаженні та може виконувати понад 30 000 запитів на секунду при великому навантаженні.

Продуктивність

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

Розуміння продуктивності

Продуктивність

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

Розуміння продуктивності

Продуктивність

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

Розуміння продуктивності

Дизайн реконфігурації під час виконання

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

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

Читайте далі, щоб дізнатися про дизайн команд конфігурації під час виконання в etcd і як ми розвʼязали ці проблеми.

Двофазні зміни конфігурації забезпечують безпеку кластера

У etcd кожна конфігурація під час виконання повинна проходити через дві фази з міркувань безпеки. Наприклад, щоб додати учасника, спочатку повідомте кластер про нову конфігурацію, а потім запустіть нового учасника.

Дизайн реконфігурації під час виконання

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

Двофазні зміни конфігурації забезпечують безпеку кластера

Дизайн реконфігурації під час виконання

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

Двофазні зміни конфігурації забезпечують безпеку кластера

Дизайн реконфігурації під час виконання

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

Двофазні зміни конфігурації забезпечують безпеку кластера

Переконфігурація під час виконання

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

etcd підтримує інкрементальну переконфігурацію під час виконання, що дозволяє користувачам оновлювати склад кластера під час роботи.

Запити на переконфігурацію можуть оброблятися лише тоді, коли більшість членів кластера функціонують. Наполегливо рекомендується завжди мати кластер розміром понад два учасники у промисловому середовищі. Небезпечно видаляти члена з двочленного кластера. Більшість у двочленному кластері також становить два. Якщо під час процесу видалення станеться збій, кластер не зможе продовжувати роботу і потребуватиме перезапуску після втрати більшості.

Переконфігурація під час виконання

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

Переконфігурація під час виконання

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

Переконфігурація під час виконання

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

Підтримувані платформи

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

Рівні підтримки

etcd працює на різних платформах, але гарантії, які він надає, залежать від рівня підтримки платформи:

Рівень 1: повністю підтримується супроводжувачами etcd; etcd гарантовано пройде всі тести, включаючи функціональні тести та тести на надійність.
Рівень 2: etcd гарантовано пройде інтеграційні та наскрізні тести, але не обовʼязково функціональні або тести на надійність.
Рівень 3: etcd гарантовано збирається, може бути злегка протестовано (або ні), тому збірку слід вважати нестабільною.

Поточна підтримка

У наступній таблиці наведено перелік платформ, що підтримуються на даний момент, та відповідний рівень підтримки etcd:

Підтримувані платформи

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

Рівні підтримки

etcd працює на різних платформах, але гарантії, які він надає, залежать від рівня підтримки платформи:

Рівень 1: повністю підтримується супроводжувачами etcd; etcd гарантовано пройде всі тести, включаючи функціональні тести та тести на надійність.
Рівень 2: etcd гарантовано пройде інтеграційні та наскрізні тести, але не обовʼязково функціональні або тести на надійність.
Рівень 3: etcd гарантовано збирається, може бути злегка протестовано (або ні), тому збірку слід вважати нестабільною.

Поточна підтримка

Підтримувані платформи

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

Рівні підтримки

etcd працює на різних платформах, але гарантії, які він надає, залежать від рівня підтримки платформи:

Рівень 1: повністю підтримується супроводжувачами etcd; etcd гарантовано пройде всі тести, включаючи функціональні тести та тести на надійність.
Рівень 2: etcd гарантовано пройде інтеграційні та наскрізні тести, але не обовʼязково функціональні або тести на надійність.
Рівень 3: etcd гарантовано збирається, може бути злегка протестовано (або ні), тому збірку слід вважати нестабільною.

Поточна підтримка

Підтримувані платформи

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

Рівні підтримки

etcd працює на різних платформах, але гарантії, які він надає, залежать від рівня підтримки платформи:

Рівень 1: повністю підтримується супроводжувачами etcd; etcd гарантовано пройде всі тести, включаючи функціональні тести та тести на надійність.
Рівень 2: etcd гарантовано пройде інтеграційні та наскрізні тести, але не обовʼязково функціональні або тести на надійність.
Рівень 3: etcd гарантовано збирається, може бути злегка протестовано (або ні), тому збірку слід вважати нестабільною.

Поточна підтримка

Версіонування

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

Цей документ описує версії, які підтримуються проєктом etcd.

Версіонування сервісу та підтримувані версії

Версії etcd виражаються як x.y.z, де x — це основна версія, y — це мінорна версія, а z — це версія патчу, відповідно до термінології Семантичного Версіонування. Нові мінорні версії можуть додавати додаткові функції до API.

Проєкт etcd підтримує гілки релізів для поточної версії та попереднього випуску. Наприклад, коли v3.5 є поточною версією, v3.4 підтримується. Коли випускається v3.6, підтримка v3.4 припиняється.

Версіонування

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

Цей документ описує версії, які підтримуються проєктом etcd.

Версіонування сервісу та підтримувані версії

Версіонування

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

Цей документ описує версії, які підтримуються проєктом etcd.

Версіонування сервісу та підтримувані версії

Версіонування

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

Цей документ описує версії, які підтримуються проєктом etcd.

Версіонування сервісу та підтримувані версії

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

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

Ця серія прикладів показує основні процедури роботи з кластером etcd.

Auth

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
# тепер всі запити клієнтів проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# у дозволі відмовлено, імʼя користувача порожнє, оскільки запит не видає запит на автентифікацію
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може прочитати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

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

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

Ця серія прикладів показує основні процедури роботи з кластером etcd.

Auth

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
# тепер всі запити клієнтів проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# у дозволі відмовлено, імʼя користувача порожнє, оскільки запит не видає запит на автентифікацію
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може прочитати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Пошкодження даних

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

etcd має вбудоване автоматичне виявлення пошкодження даних, щоб запобігти розбіжності стану членів.

Включення виявлення пошкодження даних

Виявлення пошкодження даних можна зробити за допомогою:

Початкової перевірки, яка включається за допомогою прапорця --experimental-initial-corrupt-check.
Періодичної перевірки:
- Хешу ущільненої ревізії, яка включається за допомогою прапорця --experimental-compact-hash-check-enabled.
- Хешу останньої ревізії, яка включається за допомогою прапорця --experimental-corrupt-check-time.

Початкова перевірка буде виконана під час завантаження члена etcd. Член порівняє свій постійний стан з іншими членами та завершить роботу, якщо є невідповідність.

Пошкодження даних

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

etcd має вбудоване автоматичне виявлення пошкодження даних, щоб запобігти розбіжності стану членів.

Включення виявлення пошкодження даних

Виявлення пошкодження даних можна зробити за допомогою:

Початкової перевірки, яка включається за допомогою прапорця --experimental-initial-corrupt-check.
Періодичної перевірки:
- Хешу ущільненої ревізії, яка включається за допомогою прапорця --experimental-compact-hash-check-enabled.
- Хешу останньої ревізії, яка включається за допомогою прапорця --experimental-corrupt-check-time.

Пошкодження даних

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

etcd має вбудоване автоматичне виявлення пошкодження даних, щоб запобігти розбіжності стану членів.

Включення виявлення пошкодження даних

Виявлення пошкодження даних можна зробити за допомогою:

Початкової перевірки, яка включається за допомогою прапорця --experimental-initial-corrupt-check.
Періодичної перевірки:
- Хешу ущільненої ревізії, яка включається за допомогою прапорця --experimental-compact-hash-check-enabled.
- Хешу останньої ревізії, яка включається за допомогою прапорця --experimental-corrupt-check-time.

Пошкодження даних

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

etcd має вбудоване автоматичне виявлення пошкодження даних, щоб запобігти розбіжності стану членів.

Включення виявлення пошкодження даних

Виявлення пошкодження даних можна зробити за допомогою:

Початкової перевірки, яка включається за допомогою прапорця --experimental-initial-corrupt-check.
Періодичної перевірки:
- Хешу ущільненої ревізії, яка включається за допомогою прапорця --experimental-compact-hash-check-enabled.
- Хешу останньої ревізії, яка включається за допомогою прапорця --experimental-corrupt-check-time.

Тест продуктивності використання памʼяті сховища

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

Два компоненти сховища etcd споживають фізичну памʼять. Процес etcd виділяє індекс в памʼяті для прискорення пошуку ключів. Кеш сторінок процесу, керований операційною системою, зберігає нещодавно доступні дані з диска для швидкого повторного використання.

Індекс в памʼяті містить усі ключі в структурі даних B-дерево, разом з вказівниками на дані на диску (значення). Кожен ключ у B-дереві може містити кілька вказівників, що вказують на різні версії його значень. Теоретичне споживання памʼяті індексом в памʼяті можна приблизно оцінити за формулою:

Тестування продуктивності використання памʼяті сховища

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

Тестування продуктивності використання памʼяті сховища

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

Тестування продуктивності використання памʼяті сховища

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

Індекс в памʼяті містить усі ключі в структурі даних B-tree, разом з вказівниками на дані на диску (значення). Кожен ключ у B-tree може містити кілька вказівників, що вказують на різні версії його значень. Теоретичне споживання памʼяті індексом в памʼяті можна приблизно оцінити за формулою:

Тест продуктивності використання памʼяті Watch

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

Примітка

Функції спостереження знаходяться в активній розробці, і їх використання памʼяті може змінюватися в процесі розвитку. Ми не очікуємо значного збільшення понад зазначені нижче цифри.

Основною метою etcd є підтримка дуже великої кількості спостерігачів, які виконують величезну кількість спостережень. etcd прагне підтримувати O(10k) клієнтів, O(100K) потоків спостереження (O(10) потоків на клієнта) і O(10M) загальних спостережень (O(100) спостережень на потік). Памʼять, яку споживає кожне окреме спостереження, становить найбільшу частину загального використання памʼяті etcd, і тому є обʼєктом поточних та майбутніх оптимізацій.

Тестування продуктивності використання памʼяті Watch

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

Примітка

Тестування продуктивності використання памʼяті Watch

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

Примітка

Тестування продуктивності використання памʼяті Watch

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

Примітка

Тестування продуктивності etcd v3

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU
версія etcd 2.2.0

Кластер etcd

1 учасник etcd, що працює в демо-режимі v3

Тестування

Використовуйте інструмент тестування продуктивності etcd v3.

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	QPS читання	90-й процентиль затримки (мс)
256	1	2716	0.4
256	64	16623	6.1
256	256	16622	21.7

Продуктивність майже така ж, як і з порожнім обробником сервера.

Тестування продуктивності etcd v3

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU
версія etcd 2.2.0

Кластер etcd

1 учасник etcd, що працює в демо-режимі v3

Тестування

Використовуйте інструмент тестування продуктивності etcd v3.

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	QPS читання	90-й процентиль затримки (мс)
256	1	2716	0.4
256	64	16623	6.1
256	256	16622	21.7

Продуктивність майже така ж, як і з порожнім обробником сервера.

Тестування продуктивності etcd v3

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU
версія etcd 2.2.0

Кластер etcd

1 учасник etcd, що працює в демо-режимі v3

Тестування

Використовуйте інструмент тестування продуктивності etcd v3.

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	QPS читання	90-й процентиль затримки (мс)
256	1	2716	0.4
256	64	16623	6.1
256	256	16622	21.7

Продуктивність майже така ж, як і з порожнім обробником сервера.

Тестування продуктивності etcd v3

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU
версія etcd 2.2.0

Кластер etcd

1 учасник etcd, що працює в демо-режимі v3

Тестування

Використовуйте інструмент тестування продуктивності etcd v3.

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	QPS читання	90-й процентиль затримки (мс)
256	1	2716	0.4
256	64	16623	6.1
256	256	16622	21.7

Продуктивність майже така ж, як і з порожнім обробником сервера.

Тестування продуктивності etcd v2.2.0-rc-memory

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

Фізична машина

Тип машини GCE n1-standard-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
7.5 ГБ памʼяті
2x ЦП

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Запуск кластера etcd з 3 учасниками, кожен з яких використовує 2 ядра.

Довжина імені ключа завжди 64 байти, що є розумною довжиною середнього ключа.

Максимальне використання памʼяті

etcd може використовувати максимальну памʼять, якщо один з підписувачів мертвий і лідер продовжує надсилати знімки.
max RSS - це максимальне використання памʼяті, зафіксоване в 3 запусках.

байти значення	кількість ключів	розмір даних (МБ)	max RSS (МБ)	max RSS/співвідношення даних на лідері
128	50000	6	433	72x
128	100000	12	659	54x
128	200000	24	1466	61x
1024	50000	48	1253	26x
1024	100000	96	2344	24x
1024	200000	192	4361	22x

Поріг розміру даних

Коли etcd досягає порогу розміру даних, це може легко викликати вибори лідера і відкинути частину пропозицій.
У більшості випадків кластер etcd повинен працювати безперебійно, якщо він не досягає порогу. Якщо він не працює добре через недостатні ресурси, зменшіть розмір його даних.

байти значення	обмеження кількості ключів	рекомендований поріг розміру даних (МБ)	споживаний RSS (МБ)
128	400K	48	2400
1024	300K	292	6500

Тестування продуктивності використання памʼяті etcd v2.2.0-rc-memory

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

Фізична машина

Тип машини GCE n1-standard-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
7.5 ГБ памʼяті
2x ЦП

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Запуск кластера etcd з 3 учасниками, кожен з яких використовує 2 ядра.

Довжина імені ключа завжди 64 байти, що є розумною довжиною середнього ключа.

Максимальне використання памʼяті

etcd може використовувати максимальну памʼять, якщо один з підписувачів мертвий і лідер продовжує надсилати знімки.
max RSS - це максимальне використання памʼяті, зафіксоване в 3 запусках.

байти значення	кількість ключів	розмір даних (МБ)	max RSS (МБ)	max RSS/співвідношення даних на лідері
128	50000	6	433	72x
128	100000	12	659	54x
128	200000	24	1466	61x
1024	50000	48	1253	26x
1024	100000	96	2344	24x
1024	200000	192	4361	22x

Поріг розміру даних

Коли etcd досягає порогу розміру даних, це може легко викликати вибори лідера і відкинути частину пропозицій.
У більшості випадків кластер etcd повинен працювати безперебійно, якщо він не досягає порогу. Якщо він не працює добре через недостатні ресурси, зменшіть розмір його даних.

байти значення	обмеження кількості ключів	рекомендований поріг розміру даних (МБ)	споживаний RSS (МБ)
128	400K	48	2400
1024	300K	292	6500

Тестування продуктивності використання памʼяті etcd v2.2.0-rc-memory

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

Фізична машина

Тип машини GCE n1-standard-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
7.5 ГБ памʼяті
2x ЦП

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Запуск кластера etcd з 3 учасниками, кожен з яких використовує 2 ядра.

Довжина імені ключа завжди 64 байти, що є розумною довжиною середнього ключа.

Максимальне використання памʼяті

etcd може використовувати максимальну памʼять, якщо один з підписувачів мертвий і лідер продовжує надсилати знімки.
max RSS - це максимальне використання памʼяті, зафіксоване в 3 запусках.

байти значення	кількість ключів	розмір даних (МБ)	max RSS (МБ)	max RSS/співвідношення даних на лідері
128	50000	6	433	72x
128	100000	12	659	54x
128	200000	24	1466	61x
1024	50000	48	1253	26x
1024	100000	96	2344	24x
1024	200000	192	4361	22x

Поріг розміру даних

Коли etcd досягає порогу розміру даних, це може легко викликати вибори лідера і відкинути частину пропозицій.
У більшості випадків кластер etcd повинен працювати безперебійно, якщо він не досягає порогу. Якщо він не працює добре через недостатні ресурси, зменшіть розмір його даних.

байти значення	обмеження кількості ключів	рекомендований поріг розміру даних (МБ)	споживаний RSS (МБ)
128	400K	48	2400
1024	300K	292	6500

Тестування продуктивності використання памʼяті etcd v2.2.0-rc-memory

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

Фізична машина

Тип машини GCE n1-standard-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
7.5 ГБ памʼяті
2x ЦП

etcd

etcd Version: 2.2.0-rc.0+git
Git SHA: 103cb5c
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Запуск кластера etcd з 3 учасниками, кожен з яких використовує 2 ядра.

Довжина імені ключа завжди 64 байти, що є розумною довжиною середнього ключа.

Максимальне використання памʼяті

etcd може використовувати максимальну памʼять, якщо один з підписувачів мертвий і лідер продовжує надсилати знімки.
max RSS - це максимальне використання памʼяті, зафіксоване в 3 запусках.

байти значення	кількість ключів	розмір даних (МБ)	max RSS (МБ)	max RSS/співвідношення даних на лідері
128	50000	6	433	72x
128	100000	12	659	54x
128	200000	24	1466	61x
1024	50000	48	1253	26x
1024	100000	96	2344	24x
1024	200000	192	4361	22x

Поріг розміру даних

Коли etcd досягає порогу розміру даних, це може легко викликати вибори лідера і відкинути частину пропозицій.
У більшості випадків кластер etcd повинен працювати безперебійно, якщо він не досягає порогу. Якщо він не працює добре через недостатні ресурси, зменшіть розмір його даних.

байти значення	обмеження кількості ключів	рекомендований поріг розміру даних (МБ)	споживаний RSS (МБ)
128	400K	48	2400
1024	300K	292	6500

Тестування продуктивності etcd v2.2.0-rc

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

Фізична машина

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU

Кластер etcd

3 учасники etcd 2.2.0-rc, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

Також ми використовуємо 3 учасників etcd 2.1.0 alpha-stage для формування кластера для отримання базової продуктивності. Коміт head etcd знаходиться на c7146bd5, що є тим самим, який ми використовували в тестуванні продуктивності etcd 2.1.

Тестування продуктивності etcd v2.2.0-rc

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

Фізична машина

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU

Кластер etcd

3 учасники etcd 2.2.0-rc, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

Тестування продуктивності etcd v2.2.0-rc

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

Фізична машина

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU

Кластер etcd

3 учасники etcd 2.2.0-rc, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

Тестування продуктивності etcd v2.2.0-rc

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

Фізична машина

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x CPU

Кластер etcd

3 учасники etcd 2.2.0-rc, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0-alpha.1+git
Git SHA: 59a5a7e
Go Version: go1.4.2
Go OS/Arch: linux/amd64

Тестування продуктивності etcd v2.2.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований як каталог даних etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦП

Кластер etcd

3 учасники etcd 2.2.0, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Запустіть іншу машину, поза кластером etcd, і запустіть інструмент тестування hey HTTP benchmark tool з патчем для повторного використання зʼєднань, щоб надсилати запити до кожного учасника кластера etcd. Дивіться інструкції з тестування для патча та кроків для відтворення наших процедур.

Тестування продуктивності etcd v2.2.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований як каталог даних etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦП

Кластер etcd

3 учасники etcd 2.2.0, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Тестування продуктивності etcd v2.2.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований як каталог даних etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦП

Кластер etcd

3 учасники etcd 2.2.0, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Тестування продуктивності etcd v2.2.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований як каталог даних etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦП

Кластер etcd

3 учасники etcd 2.2.0, кожен працює на окремій машині.

Детальні версії:

etcd Version: 2.2.0
Git SHA: e4561dd
Go Version: go1.5
Go OS/Arch: linux/amd64

Тестування

Тестування продуктивності etcd v2.1.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦПУ
версія etcd 2.1.0 alpha

Кластер etcd

3 учасники etcd, кожен працює на окремій машині

Тестування

Запустіть іншу машину та використовуйте hey HTTP benchmark tool, щоб надсилати запити до кожного учасника etcd. Перевірте benchmark hacking guide для детальних інструкцій.

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS читання	90-й процентиль затримки (мс)
64	1	тільки лідер	1534	0.7
64	64	тільки лідер	10125	9.1
64	256	тільки лідер	13892	27.1
256	1	тільки лідер	1530	0.8
256	64	тільки лідер	10106	10.1
256	256	тільки лідер	14667	27.0
64	64	всі сервери	24200	3.9
64	256	всі сервери	33300	11.8
256	64	всі сервери	24800	3.9
256	256	всі сервери	33000	11.5

запис одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS запису	90-й процентиль затримки (мс)
64	1	тільки лідер	60	21.4
64	64	тільки лідер	1742	46.8
64	256	тільки лідер	3982	90.5
256	1	тільки лідер	58	20.3
256	64	тільки лідер	1770	47.8
256	256	тільки лідер	4157	105.3
64	64	всі сервери	1028	123.4
64	256	всі сервери	3260	123.8
256	64	всі сервери	1033	121.5
256	256	всі сервери	3061	119.3

Тестування продуктивності etcd v2.1.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦПУ
версія etcd 2.1.0 alpha

Кластер etcd

3 учасники etcd, кожен працює на окремій машині

Тестування

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS читання	90-й процентиль затримки (мс)
64	1	тільки лідер	1534	0.7
64	64	тільки лідер	10125	9.1
64	256	тільки лідер	13892	27.1
256	1	тільки лідер	1530	0.8
256	64	тільки лідер	10106	10.1
256	256	тільки лідер	14667	27.0
64	64	всі сервери	24200	3.9
64	256	всі сервери	33300	11.8
256	64	всі сервери	24800	3.9
256	256	всі сервери	33000	11.5

запис одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS запису	90-й процентиль затримки (мс)
64	1	тільки лідер	60	21.4
64	64	тільки лідер	1742	46.8
64	256	тільки лідер	3982	90.5
256	1	тільки лідер	58	20.3
256	64	тільки лідер	1770	47.8
256	256	тільки лідер	4157	105.3
64	64	всі сервери	1028	123.4
64	256	всі сервери	3260	123.8
256	64	всі сервери	1033	121.5
256	256	всі сервери	3061	119.3

Тестування продуктивності etcd v2.1.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦПУ
версія etcd 2.1.0 alpha

Кластер etcd

3 учасники etcd, кожен працює на окремій машині

Тестування

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS читання	90-й процентиль затримки (мс)
64	1	тільки лідер	1534	0.7
64	64	тільки лідер	10125	9.1
64	256	тільки лідер	13892	27.1
256	1	тільки лідер	1530	0.8
256	64	тільки лідер	10106	10.1
256	256	тільки лідер	14667	27.0
64	64	всі сервери	24200	3.9
64	256	всі сервери	33300	11.8
256	64	всі сервери	24800	3.9
256	256	всі сервери	33000	11.5

запис одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS запису	90-й процентиль затримки (мс)
64	1	тільки лідер	60	21.4
64	64	тільки лідер	1742	46.8
64	256	тільки лідер	3982	90.5
256	1	тільки лідер	58	20.3
256	64	тільки лідер	1770	47.8
256	256	тільки лідер	4157	105.3
64	64	всі сервери	1028	123.4
64	256	всі сервери	3260	123.8
256	64	всі сервери	1033	121.5
256	256	всі сервери	3061	119.3

Тестування продуктивності etcd v2.1.0

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

Фізичні машини

Тип машини GCE n1-highcpu-2

1x виділений локальний SSD, змонтований у /var/lib/etcd
1x виділений повільний диск для ОС
1.8 ГБ памʼяті
2x ЦПУ
версія etcd 2.1.0 alpha

Кластер etcd

3 учасники etcd, кожен працює на окремій машині

Тестування

Продуктивність

читання одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS читання	90-й процентиль затримки (мс)
64	1	тільки лідер	1534	0.7
64	64	тільки лідер	10125	9.1
64	256	тільки лідер	13892	27.1
256	1	тільки лідер	1530	0.8
256	64	тільки лідер	10106	10.1
256	256	тільки лідер	14667	27.0
64	64	всі сервери	24200	3.9
64	256	всі сервери	33300	11.8
256	64	всі сервери	24800	3.9
256	256	всі сервери	33000	11.5

запис одного ключа

розмір ключа в байтах	кількість клієнтів	цільовий сервер etcd	QPS запису	90-й процентиль затримки (мс)
64	1	тільки лідер	60	21.4
64	64	тільки лідер	1742	46.8
64	256	тільки лідер	3982	90.5
256	1	тільки лідер	58	20.3
256	64	тільки лідер	1770	47.8
256	256	тільки лідер	4157	105.3
64	64	всі сервери	1028	123.4
64	256	всі сервери	3260	123.8
256	64	всі сервери	1033	121.5
256	256	всі сервери	3061	119.3

Оновлення кластерів та застосунків etcd

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

Цей розділ містить документи, присвячені оновленню кластерів та застосунків etcd.

Політика оновлення

Перед оновленням зверніть увагу, що etcd підтримує лише два випадки оновлення:

Оновлення патчем: Оновлення між патч-релізами в межах однієї мінорної версії (наприклад, 3.5.23 - 3.5.26).
Мінорне оновлення: Оновлення по одній мінорній версії за раз (наприклад, 3.4 - 3.5). Оновлення, що пропускають мінорну версію, не підтримуються і, ймовірно, не вдасться. Оновіться до найновішої версії патча перед оновленням до наступної мінорної версії.

Оновлення кластера etcd v3.x

Оновлення з etcd v2.3

Оновлення кластера з v2.3 до v3.0

Оновлення кластерів та застосунків etcd

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

Цей розділ містить документи, присвячені оновленню кластерів та застосунків etcd.

Політика оновлення

Перед оновленням зверніть увагу, що etcd підтримує лише два випадки оновлення:

Оновлення патча: Оновлення між патч-релізами в межах однієї мінорної версії (наприклад, 3.6.0 - 3.6.2).
Мінорне оновлення: Оновлення по одній мінорній версії за раз (наприклад, 3.5 - 3.6). Оновлення, що пропускають мінорну версію, не підтримуються і, ймовірно, не вдасться. Оновіться до найновішої версії патча перед оновленням до наступної мінорної версії.

Оновлення кластера etcd v3.x

Оновлення з etcd v2.3

Оновлення кластера з v2.3 до v3.0

Оновлення кластерів та застосунків etcd

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

Цей розділ містить документи, присвячені оновленню кластерів та застосунків etcd.

Політика оновлення

Перед оновленням зверніть увагу, що etcd підтримує лише два випадки оновлення:

Оновлення патча: Оновлення між патч-релізами в межах однієї мінорної версії (наприклад, 3.7.0 - 3.7.1).
Мінорне оновлення: Оновлення по одній мінорній версії за раз (наприклад, 3.6 - 3.7). Оновлення, що пропускають мінорну версію, не підтримуються і, ймовірно, не вдасться. Оновіться до найновішої версії патча перед оновленням до наступної мінорної версії.

Оновлення кластера etcd v3.x

Оновлення з etcd v2.3

Оновлення кластера з v2.3 до v3.0

Оновлення кластерів та застосунків etcd

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

Цей розділ містить документи, присвячені оновленню кластерів та застосунків etcd.

Політика оновлення

Перед оновленням зверніть увагу, що etcd підтримує лише два випадки оновлення:

Оновлення патча: Оновлення між патч-релізами в межах однієї мінорної версії (наприклад, 3.7.0 - 3.7.1).
Мінорне оновлення: Оновлення по одній мінорній версії за раз (наприклад, 3.6 - 3.7). Оновлення, що пропускають мінорну версію, не підтримуються і, ймовірно, не вдасться. Оновіться до найновішої версії патча перед оновленням до наступної мінорної версії.

Оновлення кластера etcd v3.x

Оновлення з etcd v2.3

Оновлення кластера з v2.3 до v3.0

Пониження версії кластерів та застосунків etcd

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

Цей розділ містить документи, що стосуються пониження рівня кластерів та застосунків etcd.

Пониження версії кластера etcd v3.x

Пониження версії etcd з 3.5 до 3.4

Пониження версії кластерів та застосунків etcd

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

Цей розділ містить документи, що стосуються пониження версії кластерів та застосунків etcd.

Пониження версії кластера etcd v3.x

Пониження версії кластерів та застосунків etcd

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

Цей розділ містить документи, що стосуються пониження версії кластерів та застосунків etcd.

Пониження версії кластера etcd v3.x

Пониження версії кластерів та застосунків etcd

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

Цей розділ містить документи, що стосуються пониження версії кластерів та застосунків etcd.

Пониження версії кластера etcd v3.x

Зниження версії etcd з 3.7 до 3.6

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

У загальному випадку, зниження версії з etcd v3.7 до v3.6 може бути безперервним, поступовим зниженням версії без простою:

по черзі зупиняйте процеси etcd v3.7 і замінюйте їх процесами etcd v3.6
після увімкнення зниження версії нові функції у v3.7 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Основні зміни між v3.7 та v3.6:

Відмінності у прапорцях

v3.7 не вводить жодних нових прапорців, тому процес v3.6 приймає кожен прапорець конфігурації v3.7, і жодних змін конфігурації не потрібно при зниженні версії.

Зниження версії etcd з 3.7 до 3.6

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

по черзі зупиняйте процеси etcd v3.7 і замінюйте їх процесами etcd v3.6
після увімкнення зниження версії нові функції у v3.7 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Основні зміни між v3.7 та v3.6:

Відмінності у прапорцях

Оновлення etcd з 3.5 до 3.6

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

У загальному випадку, оновлення з etcd v3.5 до v3.6 може бути безперервним, поступовим оновленням без простою:

по черзі зупиняйте процеси etcd v3.5 і замінюйте їх процесами etcd v3.6
після запуску всіх процесів v3.6 нові функції у v3.6 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Оновлення 3.5

Important

Перед оновленням до 3.6 переконайтеся, що всі ваші учасники 3.5 оновлені до 3.5.32 або пізнішої версії. Патч-випуски 3.5.24–3.5.32 виправляють декілька потенційних блокерів оновлення, включаючи --v2-deprecation=write-only-skip-check та etcdutl check v2store для перевірки записів WAL, а також знімка v2.

Оновлення etcd з 3.5 до 3.6

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

У загальному випадку, оновлення з etcd v3.5 до v3.6 може бути безперервним, поступовим оновленням без простою:

по черзі зупиняйте процеси etcd v3.5 і замінюйте їх процесами etcd v3.6
після запуску всіх процесів v3.6 нові функції у v3.6 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Оновлення 3.5

Important

Перед оновленням до 3.6 переконайтеся, що всі ваші учасники 3.5 оновлено до 3.5.32 або пізнішої версії. Патч-випуски 3.5.24–3.5.26 виправляють декілька потенційних блокерів оновлення; 3.5.32 додає --v2-deprecation=write-only-skip-check та розширює etcdutl check v2store для перевірки записів WAL, а також знімка v2.

Оновлення etcd з 3.5 до 3.6

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

У загальному випадку, оновлення з etcd v3.5 до v3.6 може бути безперервним, поступовим оновленням без простою:

по черзі зупиняйте процеси etcd v3.5 і замінюйте їх процесами etcd v3.6
після запуску всіх процесів v3.6 нові функції у v3.6 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Оновлення 3.5

Important

Зниження версії etcd з 3.5 до 3.4

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

У загальному випадку, зниження версії з etcd 3.5 до 3.4 може бути безперервним, поступовим зниженням версії:

по черзі зупиняйте процеси etcd 3.5 і замінюйте їх процесами etcd 3.4
після запуску будь-яких процесів 3.4 нові функції в 3.5 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Примітка

Якщо у вашому кластері увімкнено автентифікацію, поступове зниження версії з 3.5 не підтримується, оскільки 3.5 змінює формат записів WAL, повʼязаних з автентифікацією. Ви можете дотримуватися інструкцій з автентифікації, щоб вимкнути автентифікацію та видалити всіх користувачів спочатку.

Зниження версії etcd з 3.5 до 3.4

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

У загальному випадку, зниження версії з etcd 3.5 до 3.4 може бути безперервним, поступовим зниженням версії:

по черзі зупиняйте процеси etcd 3.5 і замінюйте їх процесами etcd 3.4
після запуску будь-яких процесів 3.4 нові функції в 3.5 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Примітка

Зниження версії etcd з 3.5 до 3.4

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

У загальному випадку, зниження версії з etcd 3.5 до 3.4 може бути безперервним, поступовим зниженням версії:

по черзі зупиняйте процеси etcd 3.5 і замінюйте їх процесами etcd 3.4
після запуску будь-яких процесів 3.4 нові функції в 3.5 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Примітка

Зниження версії etcd з 3.5 до 3.4

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

У загальному випадку, зниження версії з etcd 3.5 до 3.4 може бути безперервним, поступовим зниженням версії:

по черзі зупиняйте процеси etcd 3.5 і замінюйте їх процесами etcd 3.4
після запуску будь-яких процесів 3.4 нові функції в 3.5 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Примітка

Зниження версії etcd з 3.6 до 3.5

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

У загальному випадку, зниження версії з etcd v3.6 до v3.5 може бути безперервним, поступовим зниженням версії без простою:

по черзі зупиняйте процеси etcd v3.6 і замінюйте їх процесами etcd v3.5
після увімкнення зниження версії нові функції у v3.6 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Основні зміни між v3.6 та v3.5:

Відмінності у прапорцях

Якщо ви використовуєте будь-які з наступних прапорців у ваших конфігураціях v3.6, переконайтеся, що ви видалили, перейменували або змінили стандартне значення при зниженні до v3.5.

Зниження версії etcd з 3.6 до 3.5

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

по черзі зупиняйте процеси etcd v3.6 і замінюйте їх процесами etcd v3.5
після увімкнення зниження версії нові функції у v3.6 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Основні зміни між v3.6 та v3.5:

Відмінності у прапорцях

Зниження версії etcd з 3.6 до 3.5

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

по черзі зупиняйте процеси etcd v3.6 і замінюйте їх процесами etcd v3.5
після увімкнення зниження версії нові функції у v3.6 більше не доступні для кластера

Перед тим як почати зниження версії, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для зниження версії

Основні зміни між v3.6 та v3.5:

Відмінності у прапорцях

Оновлення etcd з 3.4 до 3.5

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

У загальному випадку, оновлення з etcd 3.4 до 3.5 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.4 і замінюйте їх процесами etcd v3.5
після запуску всіх процесів v3.5 нові функції в v3.5 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 можна було продовжувати лише з даними v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.4 до 3.5

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

У загальному випадку, оновлення з etcd 3.4 до 3.5 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.4 і замінюйте їх процесами etcd v3.5
після запуску всіх процесів v3.5 нові функції в v3.5 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.4 до 3.5

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

У загальному випадку, оновлення з etcd 3.4 до 3.5 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.4 і замінюйте їх процесами etcd v3.5
після запуску всіх процесів v3.5 нові функції в v3.5 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.4 до 3.5

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

У загальному випадку, оновлення з etcd 3.4 до 3.5 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.4 і замінюйте їх процесами etcd v3.5
після запуску всіх процесів v3.5 нові функції в v3.5 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.3 до 3.4

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

У загальному випадку, оновлення з etcd 3.3 до 3.4 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.3 і замінюйте їх процесами etcd v3.4
після запуску всіх процесів v3.4 нові функції v3.4 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 могли відбуватися лише з даними v3. Не оновлюйтеся до новіших версій v3, доки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.3 до 3.4

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

У загальному випадку, оновлення з etcd 3.3 до 3.4 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.3 і замінюйте їх процесами etcd v3.4
після запуску всіх процесів v3.4 нові функції v3.4 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 могли відбуватися лише з даними v3. Не оновлюйтеся до новіших версій v3, доки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.3 до 3.4

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

У загальному випадку, оновлення з etcd 3.3 до 3.4 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.3 і замінюйте їх процесами etcd v3.4
після запуску всіх процесів v3.4 нові функції v3.4 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 могли відбуватися лише з даними v3. Не оновлюйтеся до новіших версій v3, доки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.3 до 3.4

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

У загальному випадку, оновлення з etcd 3.3 до 3.4 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.3 і замінюйте їх процесами etcd v3.4
після запуску всіх процесів v3.4 нові функції v3.4 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 могли відбуватися лише з даними v3. Не оновлюйтеся до новіших версій v3, доки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.6 до 3.7

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

У загальному випадку, оновлення з etcd v3.6 до v3.7 може бути безперервним, поступовим оновленням без простою:

по черзі зупиняйте процеси etcd v3.6 і замінюйте їх процесами etcd v3.7
після запуску всіх процесів v3.7 нові функції у v3.7 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Оновлення 3.6

Important

Перед оновленням до 3.7 переконайтеся, що всі ваші учасники 3.6 оновлено до 3.6.11 або пізнішої версії. Раніші патч-випуски 3.6 можуть бути несумісними з поступовим оновленням до 3.7.

Оновлення etcd з 3.6 до 3.7

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

У загальному випадку, оновлення з etcd v3.6 до v3.7 може бути безперервним, поступовим оновленням без простою:

по черзі зупиняйте процеси etcd v3.6 і замінюйте їх процесами etcd v3.7
після запуску всіх процесів v3.7 нові функції у v3.7 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Оновлення 3.6

Important

Оновлення etcd з 3.2 до 3.3

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

У загальному випадку, оновлення з etcd 3.2 до 3.3 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.2 і замінюйте їх процесами etcd v3.3
після запуску всіх процесів v3.3 нові функції v3.3 будуть доступні кластеру

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 були тільки дані v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.2 до 3.3

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

У загальному випадку, оновлення з etcd 3.2 до 3.3 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.2 і замінюйте їх процесами etcd v3.3
після запуску всіх процесів v3.3 нові функції v3.3 будуть доступні кластеру

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 були тільки дані v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.2 до 3.3

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

У загальному випадку, оновлення з etcd 3.2 до 3.3 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.2 і замінюйте їх процесами etcd v3.3
після запуску всіх процесів v3.3 нові функції v3.3 будуть доступні кластеру

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 були тільки дані v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.2 до 3.3

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

У загальному випадку, оновлення з etcd 3.2 до 3.3 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.2 і замінюйте їх процесами etcd v3.3
після запуску всіх процесів v3.3 нові функції v3.3 будуть доступні кластеру

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли etcd відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 були тільки дані v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.1 до 3.2

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

У загальному випадку, оновлення з etcd 3.1 до 3.2 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.1 та замінюйте їх процесами etcd v3.2
після запуску всіх процесів v3.2 нові функції в v3.2 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

При міграції з v2 без даних v3, сервер etcd v3.2+ панікує, коли відновлюється з наявних знімків, але немає файлу v3 ETCD_DATA_DIR/member/snap/db. Це відбувається, коли сервер мігрував з v2 без попередніх даних v3. Це також запобігає випадковій втраті даних v3 (наприклад, файл db міг бути переміщений). etcd вимагає, щоб після міграції v3 можна було продовжувати лише з даними v3. Не оновлюйте до новіших версій v3, поки сервер v3.0 не містить даних v3.

Оновлення etcd з 3.1 до 3.2

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

У загальному випадку, оновлення з etcd 3.1 до 3.2 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.1 та замінюйте їх процесами etcd v3.2
після запуску всіх процесів v3.2 нові функції в v3.2 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

Оновлення etcd з 3.1 до 3.2

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

У загальному випадку, оновлення з etcd 3.1 до 3.2 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.1 та замінюйте їх процесами etcd v3.2
після запуску всіх процесів v3.2 нові функції в v3.2 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

Оновлення etcd з 3.1 до 3.2

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

У загальному випадку, оновлення з etcd 3.1 до 3.2 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.1 та замінюйте їх процесами etcd v3.2
після запуску всіх процесів v3.2 нові функції в v3.2 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки для оновлення

Примітка

Оновлення etcd з 3.0 до 3.1

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

У загальному випадку, оновлення з etcd 3.0 до 3.1 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.0 і замінюйте їх процесами etcd v3.1
після запуску всіх процесів v3.1 нові функції v3.1 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.0 до 3.1

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

У загальному випадку, оновлення з etcd 3.0 до 3.1 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.0 і замінюйте їх процесами etcd v3.1
після запуску всіх процесів v3.1 нові функції v3.1 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.0 до 3.1

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

У загальному випадку, оновлення з etcd 3.0 до 3.1 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.0 і замінюйте їх процесами etcd v3.1
після запуску всіх процесів v3.1 нові функції v3.1 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 3.0 до 3.1

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

У загальному випадку, оновлення з etcd 3.0 до 3.1 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v3.0 і замінюйте їх процесами etcd v3.1
після запуску всіх процесів v3.1 нові функції v3.1 стають доступними для кластера

Перед тим як почати оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 2.3 до 3.0

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

У загальному випадку, оновлення з etcd 2.3 до 3.0 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v2.3 і замінюйте їх процесами etcd v3.0
після запуску всіх процесів v3.0 нові функції v3.0 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 2.3 до 3.0

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

У загальному випадку, оновлення з etcd 2.3 до 3.0 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v2.3 і замінюйте їх процесами etcd v3.0
після запуску всіх процесів v3.0 нові функції v3.0 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 2.3 до 3.0

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

У загальному випадку, оновлення з etcd 2.3 до 3.0 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v2.3 і замінюйте їх процесами etcd v3.0
після запуску всіх процесів v3.0 нові функції v3.0 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Оновлення etcd з 2.3 до 3.0

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

У загальному випадку, оновлення з etcd 2.3 до 3.0 може бути безперервним, поступовим оновленням:

по черзі зупиняйте процеси etcd v2.3 і замінюйте їх процесами etcd v3.0
після запуску всіх процесів v3.0 нові функції v3.0 будуть доступні кластеру

Перед початком оновлення, прочитайте решту цього посібника, щоб підготуватися.

Контрольні списки оновлення

Примітка

Патч-випуски Etcd: v3.7.2, v3.6.15 та v3.5.34

Tue, 22 Sep 2026 00:00:00 +0000

SIG-etcd випустив патч-оновлення для всіх трьох підтримуваних гілок випуску. Ці випуски оновлюють залежності, усувають витік дескриптора файлу під час очищення файлів, виправляють вивід etcdctl endpoint status і покращують визначення версії у v3.7. Користувачам v3.5, v3.6 та v3.7 слід оновитися під час наступного запланованого вікна технічного обслуговування після того, як випуски стануть доступними.

Отримайте оновлення тут:

Офіційні контейнерні образи доступні з gcr.io.

Оновлення безпеки залежностей

v3.6.15 і v3.5.34 оновлюють github.com/gorilla/websocket до v1.5.3, щоб усунути проблему з ненадійною криптографією (номер CVE ще не присвоєно).

Патч-випуски Etcd: v3.7.1, v3.6.14 та v3.5.33

Thu, 23 Jul 2026 00:00:00 +0000

SIG-etcd випустив патч-оновлення для всіх трьох підтримуваних гілок випуску. Ці випуски виправляють дві вразливості безпеки, кілька незначних проблем безпеки та усувають кілька проблем надійності на сервері, у клієнтській бібліотеці та в TLS-стеку. Користувачам v3.5, v3.6 та v3.7 слід оновитися під час наступного запланованого вікна технічного обслуговування.

Отримайте оновлення тут:

Офіційні контейнерні образи доступні з gcr.io.

Виправлення безпеки: витік відповідей watch через межі RBAC-ключів

Усі три випуски виправляють вразливість, за якої користувач із наданим правом читання на один ключ міг отримувати сповіщення watch-подій для кожного ключа, починаючи з цього ключа, розкриваючи дані поза межами його авторизованої області.

Повідомлення про випуск etcd v3.7.0

Wed, 08 Jul 2026 00:00:00 +0000

Вступ

Сьогодні SIG etcd випускає etcd v3.7.0 — останній мінорний випуск популярного розподіленого сховища ключ-значення та ключового компонента Kubernetes. v3.7 містить довгоочікувану функцію RangeStream, надає кілька інших покращень продуктивності, видаляє останні залишки застарілого v2store та завершує масштабну модернізацію protobuf.

Липневі патч-випуски Etcd: v3.5.32 та v3.6.13

Wed, 01 Jul 2026 00:00:00 +0000

SIG-etcd випустила чергові оновлення у вигляді патчів для гілок версій v3.5 та v3.6. Ці випуски усувають уразливості CVE, пов’язані із залежностями, виправляють помилку автентифікації WebSocket та додають нову опцію, яка допоможе операторам завершити процес виведення з експлуатації сховища v2. Користувачам версій v3.5 та v3.6 слід виконати оновлення під час наступного запланованого періоду технічного обслуговування.

Отримайте оновлення тут:

Офіційні контейнерні образи доступні з gcr.io.

Як зазначено в червневому випуску, v3.4 досягла кінця підтримки і більше не отримуватиме жодних патчів. Якщо ви досі працюєте на v3.4, будь ласка, якомога швидше оновіться до підтримуваної версії.

etcd v3.7.0-rc.0 тепер доступний для тестування

Mon, 01 Jun 2026 00:00:00 +0000

SIG-Etcd оголошує про доступність etcd v3.7.0-rc.0 — першого кандидата на випуск майбутнього релізу etcd v3.7.0.

Цей кандидат на випуск містить довгоочікувану функцію RangeStream, видалення решти застарілих компонентів v2store, рефакторинг protobuf, оновлення залежностей та покращення продуктивності для великих робочих навантажень читання. Це ще не фінальний випуск v3.7.0. Проєкт просить користувачів та похідні проєкти протестувати цього кандидата на випуск і повідомити про будь-які проблеми до фінального випуску.

Ви можете знайти etcd v3.7.0-rc.0 тут:

Фінальне оновлення для v3.4, а також випуски 3.5.31, 3.6.12

Mon, 01 Jun 2026 00:00:00 +0000

SIG-etcd випустив фінальне патч-оновлення для v3.4 разом із оновленнями безпеки для v3.5 та v3.6. Користувачам v3.4 слід якомога швидше розпочати процес оновлення. Користувачам v3.5 та v3.6 слід оновитися під час наступного запланованого вікна технічного обслуговування.

Отримайте всі три оновлення тут:

Офіційні контейнерні образи доступні з gcr.io.

Фінальний випуск v3.4

Це оновлення позначає кінець підтримки (EOL) для v3.4, спочатку випущеної в серпні 2019 року. Проєкт Kubernetes більше не випускатиме жодних патчів. Якщо ви досі використовуєте v3.4, будь ласка, якомога швидше оновіться до підтримуваної версії.

Оголошення про випуск etcd v3.7.0-beta.0

Tue, 19 May 2026 00:00:00 +0000

SIG-Etcd оголошує про доступність першої бета-версії etcd v3.7.0. Ця нова версія популярної розподіленої бази даних та ключового компонента Kubernetes містить довгоочікувану функцію RangeStream, а також рефакторинг і очищення кількох застарілих компонентів та інтерфейсів. v3.7 забезпечить покращену безпеку, кращу операційну надійність та покращений досвід роботи з великими наборами результатів.

Однак спочатку проєкту потрібно, щоб користувачі протестували бета-версію. Ви можете знайти v3.7.0-beta.0 тут:

Будь ласка, спробуйте її та повідомляйте про проблеми у репозиторії etcd.

Випуск безпеки від 1 травня виправляє оминання RBAC у транзакціях

Mon, 04 May 2026 00:00:00 +0000

SIG-etcd сьогодні випустив оновлення v3.6.11, v3.5.30 та v3.4.44. Ці патч-випуски виправляють вразливість, яка дозволяє автентифікованому користувачу оминати перевірки авторизації RBAC під час читання даних через PrevKv або приєднання оренд усередині запитів Put, вкладених у транзакції etcd.

Крім того, v3.6.11 та v3.5.30 містять виправлення помилки, яка перешкоджала додаванню нового члена, коли один член був недоступний, навіть якщо кворум усе ще був задоволений.

Ця вразливість не впливає на etcd як частину панелі управління Kubernetes. Kubernetes не покладається на вбудовану автентифікацію та авторизацію etcd; сервер API сам обробляє автентифікацію та авторизацію. Проблема впливає лише на кластери etcd в інших контекстах, зокрема на ті, де Auth увімкнено і вона потрібна для контролю доступу в ненадійних або частково надійних мережах або з ненадійними користувачами.

Випуск безпеки від 20 березня виправляє вразливості автентифікації

Fri, 20 Mar 2026 00:00:00 +0000

SIG-etcd сьогодні випустив оновлення 3.6.9, 3.5.28 та 3.4.42. Ці патч-випуски виправляють кілька вразливостей, які дозволяють неавторизованим користувачам обходити контроль автентифікації або авторизації, що є частиною etcd Auth, за допомогою gRPC API.

Ці вразливості не впливають на etcd як частину панелі управління Kubernetes. Вони впливають лише на кластери etcd в інших контекстах, зокрема на ті, де Auth увімкнено і вона потрібна для контролю доступу в ненадійних або частково надійних мережах або з ненадійними користувачами.

Оголошення про випуск etcd-operator v0.2.0

Fri, 20 Mar 2026 00:00:00 +0000

Вступ

Сьогодні ми раді оголосити про випуск etcd-operator v0.2.0! Цей випуск приносить важливі нові функції та покращення, що підвищують безпеку, надійність і зручність експлуатації під час керування кластерами etcd.

Нові функції

Керування сертифікатами

Версія 0.2.0 впроваджує вбудоване керування сертифікатами для захисту всього TLS-звʼязку:

Між членами etcd (звʼязок між членами)
Між клієнтами та членами etcd

TLS налаштовується лише тоді, коли його явно ввімкнено користувачем. Після ввімкнення etcd-operator автоматично надає та керує сертифікатами на основі вибраного провайдера.

Уникнення зомбі-членів кластера під час оновлення до etcd v3.6

Wed, 17 Dec 2025 00:00:00 +0000

Підсумок: SIG-etcd виправила ще одну потенційну проблему, що блокує оновлення з v3.5 до v3.6. Якщо ви оновлюєтеся, обовʼязково спочатку оновіться до v3.5.26 або новішої версії.

Підсумок проблеми

Нещодавно спільнота etcd вирішила проблему, яка може виникнути, коли користувачі оновлюються з v3.5 до v3.6. Ця помилка може спричинити появу в кластері «зомбі-членів» — вузлів etcd, які були видалені з кластера бази даних деякий час тому, але знову зʼявляються та приєднуються до консенсусу бази даних. Кластер etcd стає тоді непрацездатним, доки ці зомбі-члени не будуть видалені.

Продовження — Запобігання збоям оновлення з etcd v3.5 до v3.6

Tue, 21 Oct 2025 00:00:00 +0000

Ми виявили та виправили додатковий сценарій, який може спричинити збої оновлення під час переходу з etcd v3.5 до v3.6. Цей допис містить деталі, виправлення та додаткові обхідні шляхи. Будь ласка, зверніться до тікета #20793, щоб отримати детальну технічну інформацію.

Проблема

У попередньому дописі — Як запобігти поширеному збою під час оновлення etcd v3.5 до v3.6 — ми описали проблему оновлення, що впливає на версії etcd у діапазоні v3.5.1-v3.5.19. Цю проблему було вирішено у v3.5.20. Однак подальше розслідування виявило, що початкове виправлення не охоплювало всі сценарії.

Автономне тестування надійності etcd

Fri, 03 Oct 2025 00:00:00 +0000

Це допис із блогу CNCF, яким ми також ділимося з нашою спільнотою.

Як критичний компонент багатьох робочих систем, включно з Kubernetes, головним пріоритетом проєкту etcd є надійність. Забезпечення узгодженості та безпеки даних вимагає від учасників нашого проєкту постійного вдосконалення методологій тестування. У цій статті йдеться про те, як ми використовували передове симуляційне тестування для виявлення непомітних помилок, перевірки надійності наших випусків та підвищення нашої впевненості у стабільності etcd. Ми поділимося нашими ключовими висновками та тим, як вони покращили etcd.

Повідомлення про випуск etcd v3.6.0

Thu, 15 May 2025 00:00:00 +0000

Зміст

Вступ
Безпека
Можливості
Продуктивність
- Памʼять
- Пропускна здатність
Зміни, що порушують сумісність
Тестування
Виправлення критичних помилок
Проблема оновлення
Платформи
Залежності
Спільнота
Розширена підтримка v3.4
Подальший розвиток

Вступ

Сьогодні ми повідомляємо про випуск etcd v3.6.0, перший мінорний випуск після etcd v3.5.0, що вийшов 15 червня 2021 року. Цей випуск представляє кілька нових функцій, демонструє значний прогрес у реалвізації довгострокових завдань, таких як підтримка пониження версії та міграція на v3store, а також закриває численні критичні та значні проблеми. Він також включає суттєві оптимізації використання пам’яті, що підвищують ефективність і продуктивність.

Як запобігти поширеному збою під час оновлення etcd v3.5 до v3.6

Thu, 27 Mar 2025 00:00:00 +0000

Оновлення (21 жовтня 2025)

Ми виявили та виправили дві додаткові проблеми оновлення. Будь ласка, перегляньте наші нові дописи в блозі Продовження — Запобігання збоям оновлення з etcd v3.5 до v3.6 та Уникнення зомбі-членів кластера під час оновлення для деталей.

Існує поширена проблема #19557 в оновленні etcd з v3.5 до v3.6, яка може спричинити збій процесу оновлення. Ви можете знайти детальну інформацію та повʼязані обговорення в цій проблемі.

TL; DR

Користувачі повинні спочатку оновитися до etcd v3.5.20 (або вищої patch-версії) перед оновленням до etcd v3.6.0. Недотримання цього може призвести до невдалого оновлення.

Представляємо sig-etcd

Wed, 01 Nov 2023 00:00:00 +0000

Спеціальні інтерес-групи (SIG) є фундаментальною частиною проєкту Kubernetes, з великою часткою активності спільноти, що відбувається в них. Коли виникає потреба, можуть бути створені нові SIG, і саме це сталося нещодавно.

SIG etcd є найновішим доповненням до списку SIG Kubernetes. У цій статті ми познайомимося з ним ближче, зрозуміємо його походження, обсяг і плани.

Критична роль etcd

Якщо ми заглянемо всередину панелі управління кластера Kubernetes, ми знайдемо etcd, послідовне і високо доступне сховище ключ-значення, яке використовується як основне сховище для всіх даних кластера Kubernetes — це опис саме по собі підкреслює критичну роль, яку відіграє etcd, і його важливість в екосистемі Kubernetes.

Керівництво з сортування тікетів

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

Мета

Прискорити управління тікетів.

Тікети etcd знаходяться у https://github.com/etcd-io/etcd/issues і позначені мітками. Наприклад, тікет, що сповіщає про помилку, зрештою буде позначено міткою area/bug. Нові тікети створюються без міток, але зазвичай підтримувачі etcd та активні учасники додають мітки на основі своїх висновків. Детальний список міток можна знайти на https://github.com/kubernetes/kubernetes/labels

Нижче наведено кілька попередньо визначених пошуків проблем для зручності:

Обсяг дії

Ці керівні принципи служать основним документом для розбору вхідних тікетів у etcd. Усі можуть допомагати в управлінні тікетами та PR, але робота та обовʼязки, описані в цьому документі, створені з урахуванням підтримувачів etcd та активних учасників.

Керівництво з сортування тікетів

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

Мета

Покращити управління тікетами.

Нижче наведено кілька попередньо визначених пошуків тікетів для зручності:

Обсяг дії

Керівництво з сортування тікетів

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

Мета

Покращити управління тікетами.

Нижче наведено кілька попередньо визначених пошуків тікетів для зручності:

Обсяг дії

Керівництво з сортування тікетів

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

Мета

Покращити управління тікетами.

Нижче наведено кілька попередньо визначених пошуків тікетів для зручності:

Обсяг дії

latest

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

latest

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

latest

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

latest

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

Автентифікація

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

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
# тепер всі клієнтські запити проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# доступ заборонено, імʼя користувача порожнє, оскільки запит не містить автентифікаційного запиту
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може читати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Примітка:

Це лише шаблон, який потрібно заповнити та оновити додатковою інформацією про аутентифікацію. Текст вище — це лише приклад коду.

Автентифікація

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

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
# тепер всі клієнтські запити проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# доступ заборонено, імʼя користувача порожнє, оскільки запит не містить автентифікаційного запиту
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може читати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Примітка:

Автентифікація

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

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
# тепер всі клієнтські запити проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# доступ заборонено, імʼя користувача порожнє, оскільки запит не містить автентифікаційного запиту
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може читати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Примітка:

Автентифікація

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

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
# тепер всі клієнтські запити проходять через автентифікацію

etcdctl --endpoints=${ENDPOINTS} --user=user0:123 put foo bar
etcdctl --endpoints=${ENDPOINTS} get foo
# доступ заборонено, імʼя користувача порожнє, оскільки запит не містить автентифікаційного запиту
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo
# user0 може читати ключ foo
etcdctl --endpoints=${ENDPOINTS} --user=user0:123 get foo1

Примітка:

Довідник API

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

Ця довідник API автоматично згенерована з вказаних файлів .proto.

service `Auth` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable вмикає автентифікацію.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable вимикає автентифікацію.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus показує статус автентифікації.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate обробляє запит автентифікації.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd додає нового користувача. Імʼя користувача не може бути порожнім.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet отримує детальну інформацію про користувача.
UserList	AuthUserListRequest	AuthUserListResponse	UserList отримує список всіх користувачів.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete видаляє вказаного користувача.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword змінює пароль вказаного користувача.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant надає роль вказаному користувачу.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole відкликає роль вказаного користувача.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd додає нову роль. Імʼя ролі не може бути порожнім.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet отримує детальну інформацію про роль.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList отримує список всіх ролей.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete видаляє вказану роль.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission надає дозвіл на вказаний ключ або діапазон вказаній ролі.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission відкликає дозвіл на ключ або діапазон вказаної ролі.

service `Cluster` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd додає учасника до кластера.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove видаляє існуючого учасника з кластера.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate оновлює конфігурацію учасника.
MemberList	MemberListRequest	MemberListResponse	MemberList показує всіх учасників кластера.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote підвищує учасника з raft learner (без права голосу) до raft учасника з правом голосу.

service `KV` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Range	RangeRequest	RangeResponse	Range отримує ключі в діапазоні з сховища ключ-значення.
Put	PutRequest	PutResponse	Put вставляє вказаний ключ у сховище ключ-значення. Запит на вставку збільшує ревізію сховища ключ-значення і генерує одну подію в історії подій.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange видаляє вказаний діапазон зі сховища ключ-значення. Запит на видалення збільшує ревізію сховища ключ-значення і генерує подію видалення в історії подій для кожного видаленого ключа.
Txn	TxnRequest	TxnResponse	Txn обробляє кілька запитів в одній транзакції. Запит на транзакцію збільшує ревізію сховища ключ-значення і генерує події з тією ж ревізією для кожного завершеного запиту. Не дозволяється змінювати один і той самий ключ кілька разів в одній транзакції.
Compact	CompactionRequest	CompactionResponse	Compact стискає історію подій у сховищі ключ-значення etcd. Сховище ключ-значення повинно періодично стискатися, інакше історія подій буде рости нескінченно.

service `Lease` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant створює лізинг, який закінчується, якщо сервер не отримує keepAlive протягом заданого періоду часу. Всі ключі, прикріплені до лізингу, будуть видалені після закінчення терміну дії лізингу. Кожен видалений ключ генерує подію видалення в історії подій.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke відкликає лізинг. Всі ключі, прикріплені до лізингу, будуть видалені.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive підтримує лізинг активним, передаючи запити keep alive від клієнта до сервера і відповіді keep alive від сервера до клієнта.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive отримує інформацію про лізинг.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases показує всі існуючі лізинги.

service `Maintenance` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Alarm	AlarmRequest	AlarmResponse	Alarm активує, деактивує та запитує тривоги щодо справності кластера.
Status	StatusRequest	StatusResponse	Status отримує статус учасника.
Defragment	DefragmentRequest	DefragmentResponse	Defragment дефрагментує бекенд бази даних учасника для відновлення місця для зберігання.
Hash	HashRequest	HashResponse	Hash обчислює хеш всього бекенду ключового простору, включаючи ключі, лізинги та інші сегменти в сховищі. Це призначено ТІЛЬКИ для тестування! Не покладайтеся на це у промисловій експлуатації з поточними транзакціями, оскільки операція Hash не утримує блокування MVCC. Використовуйте API “HashKV” замість цього для перевірки узгодженості сегмента “ключ”.
HashKV	HashKVRequest	HashKVResponse	HashKV обчислює хеш всіх ключів MVCC до вказаної ревізії. Він ітерує тільки сегмент “ключ” в бекенді сховища.
Snapshot	SnapshotRequest	SnapshotResponse	Snapshot надсилає знімок всього бекенду від учасника через потік до клієнта.
MoveLeader	MoveLeaderRequest	MoveLeaderResponse	MoveLeader запитує поточного лідера вузла передати своє лідерство іншому вузлу.
Downgrade	DowngradeRequest	DowngradeResponse	Downgrade запитує зниження, перевіряє можливість або скасовує зниження версії кластера. Підтримується з версії etcd 3.5.

service `Watch` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Watch	WatchRequest	WatchResponse	Watch спостерігає за подіями, що відбуваються або вже відбулися. Вхідний і вихідний потоки; вхідний потік створює і скасовує спостерігачів, а вихідний потік надсилає події. Один запит на спостереження може спостерігати за кількома діапазонами ключів, передаючи події для кількох спостережень одночасно. Вся історія подій може бути переглянута, починаючи з останньої ревізії стиснення.

message `AlarmMember` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
memberID	memberID - це ID учасника, повʼязаного з піднятою тривогою.	uint64
alarm	alarm - це тип тривоги, яка була піднята.	AlarmType

message `AlarmRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
action	action - це тип запиту на тривогу. Дія може бути GET для отримання статусів тривог, ACTIVATE для активації тривоги або DEACTIVATE для деактивації піднятої тривоги.	AlarmAction
memberID	memberID - це ID учасника, повʼязаного з тривогою. Якщо memberID дорівнює 0, запит на тривогу охоплює всіх учасників.	uint64
alarm	alarm - це тип тривоги, яку слід розглянути для цього запиту.	AlarmType

message `AlarmResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
header		ResponseHeader
alarms	alarms - це список тривог, повʼязаних із запитом на тривогу.	(slice of) AlarmMember

message `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Порожнє поле.

Довідник API

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

Ця довідник API автоматично згенерована з вказаних файлів .proto.

service `Auth` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable вмикає автентифікацію.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable вимикає автентифікацію.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus показує статус автентифікації.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate обробляє запит автентифікації.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd додає нового користувача. Імʼя користувача не може бути порожнім.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet отримує детальну інформацію про користувача.
UserList	AuthUserListRequest	AuthUserListResponse	UserList отримує список всіх користувачів.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete видаляє вказаного користувача.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword змінює пароль вказаного користувача.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant надає роль вказаному користувачу.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole відкликає роль вказаного користувача.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd додає нову роль. Імʼя ролі не може бути порожнім.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet отримує детальну інформацію про роль.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList отримує список всіх ролей.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete видаляє вказану роль.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission надає дозвіл на вказаний ключ або діапазон вказаній ролі.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission відкликає дозвіл на ключ або діапазон вказаної ролі.

service `Cluster` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd додає учасника до кластера.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove видаляє існуючого учасника з кластера.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate оновлює конфігурацію учасника.
MemberList	MemberListRequest	MemberListResponse	MemberList показує всіх учасників кластера.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote підвищує учасника з raft learner (без права голосу) до raft учасника з правом голосу.

service `KV` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Range	RangeRequest	RangeResponse	Range отримує ключі в діапазоні з сховища ключ-значення.
Put	PutRequest	PutResponse	Put вставляє вказаний ключ у сховище ключ-значення. Запит на вставку збільшує ревізію сховища ключ-значення і генерує одну подію в історії подій.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange видаляє вказаний діапазон зі сховища ключ-значення. Запит на видалення збільшує ревізію сховища ключ-значення і генерує подію видалення в історії подій для кожного видаленого ключа.
Txn	TxnRequest	TxnResponse	Txn обробляє кілька запитів в одній транзакції. Запит на транзакцію збільшує ревізію сховища ключ-значення і генерує події з тією ж ревізією для кожного завершеного запиту. Не дозволяється змінювати один і той самий ключ кілька разів в одній транзакції.
Compact	CompactionRequest	CompactionResponse	Compact стискає історію подій у сховищі ключ-значення etcd. Сховище ключ-значення повинно періодично стискатися, інакше історія подій буде рости нескінченно.

service `Lease` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant створює лізинг, який закінчується, якщо сервер не отримує keepAlive протягом заданого періоду часу. Всі ключі, прикріплені до лізингу, будуть видалені після закінчення терміну дії лізингу. Кожен видалений ключ генерує подію видалення в історії подій.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke відкликає лізинг. Всі ключі, прикріплені до лізингу, будуть видалені.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive підтримує лізинг активним, передаючи запити keep alive від клієнта до сервера і відповіді keep alive від сервера до клієнта.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive отримує інформацію про лізинг.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases показує всі існуючі лізинги.

service `Maintenance` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Alarm	AlarmRequest	AlarmResponse	Alarm активує, деактивує та запитує тривоги щодо справності кластера.
Status	StatusRequest	StatusResponse	Status отримує статус учасника.
Defragment	DefragmentRequest	DefragmentResponse	Defragment дефрагментує бекенд бази даних учасника для відновлення місця для зберігання.
Hash	HashRequest	HashResponse	Hash обчислює хеш всього бекенду ключового простору, включаючи ключі, лізинги та інші сегменти в сховищі. Це призначено ТІЛЬКИ для тестування! Не покладайтеся на це у промисловій експлуатації з поточними транзакціями, оскільки операція Hash не утримує блокування MVCC. Використовуйте API “HashKV” замість цього для перевірки узгодженості сегмента “ключ”.
HashKV	HashKVRequest	HashKVResponse	HashKV обчислює хеш всіх ключів MVCC до вказаної ревізії. Він ітерує тільки сегмент “ключ” в бекенді сховища.
Snapshot	SnapshotRequest	SnapshotResponse	Snapshot надсилає знімок всього бекенду від учасника через потік до клієнта.
MoveLeader	MoveLeaderRequest	MoveLeaderResponse	MoveLeader запитує поточного лідера вузла передати своє лідерство іншому вузлу.
Downgrade	DowngradeRequest	DowngradeResponse	Downgrade запитує зниження, перевіряє можливість або скасовує зниження версії кластера. Підтримується з версії etcd 3.5.

service `Watch` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Watch	WatchRequest	WatchResponse	Watch спостерігає за подіями, що відбуваються або вже відбулися. Вхідний і вихідний потоки; вхідний потік створює і скасовує спостерігачів, а вихідний потік надсилає події. Один запит на спостереження може спостерігати за кількома діапазонами ключів, передаючи події для кількох спостережень одночасно. Вся історія подій може бути переглянута, починаючи з останньої ревізії стиснення.

message `AlarmMember` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
memberID	memberID - це ID учасника, повʼязаного з піднятою тривогою.	uint64
alarm	alarm - це тип тривоги, яка була піднята.	AlarmType

message `AlarmRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
action	action - це тип запиту на тривогу. Дія може бути GET для отримання статусів тривог, ACTIVATE для активації тривоги або DEACTIVATE для деактивації піднятої тривоги.	AlarmAction
memberID	memberID - це ID учасника, повʼязаного з тривогою. Якщо memberID дорівнює 0, запит на тривогу охоплює всіх учасників.	uint64
alarm	alarm - це тип тривоги, яку слід розглянути для цього запиту.	AlarmType

message `AlarmResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
alarms	alarms - це список тривог, повʼязаних із запитом на тривогу.	(slice of) AlarmMember

message `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, яку потрібно додати до системи автентифікації.	string

message `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
header		ResponseHeader
perm		(slice of) authpb.Permission

message `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, якій буде надано дозвіл.	string
perm	perm - це дозвіл, який буде надано ролі.	authpb.Permission

message `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string
key		bytes
range_end		bytes

message `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
enabled		bool
authRevision	authRevision - це поточна ревізія сховища автентифікації	uint64

message `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string
options		authpb.UserAddOptions
hashedPassword		string

message `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, пароль якого змінюється.	string
password	password - це новий пароль для користувача. Зверніть увагу, що це поле буде видалено на рівні API.	string
hashedPassword	hashedPassword - це новий пароль для користувача. Зверніть увагу, що це поле буде ініціалізовано на рівні API.	string

message `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, якого потрібно видалити.	string

message `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string

message `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
user	user - це імʼя користувача, якому слід надати вказану роль.	string
role	role - це імʼя ролі, яку слід надати користувачу.	string

message `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthUserListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
users		(slice of) string

message `AuthUserRevokeRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
role		string

message `AuthUserRevokeRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthenticateRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string

message `AuthenticateResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
token	token - це авторизований токен, який можна використовувати в наступних RPC	string

message `CompactionRequest` (api/etcdserverpb/rpc.proto)

CompactionRequest стискає сховище ключ-значення до вказаної ревізії. Всі замінені ключі з ревізією менше ревізії стиснення будуть видалені.

Довідник API

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

Ця довідник API автоматично згенерована з вказаних файлів .proto.

service `Auth` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable вмикає автентифікацію.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable вимикає автентифікацію.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus показує статус автентифікації.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate обробляє запит автентифікації.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd додає нового користувача. Імʼя користувача не може бути порожнім.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet отримує детальну інформацію про користувача.
UserList	AuthUserListRequest	AuthUserListResponse	UserList отримує список всіх користувачів.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete видаляє вказаного користувача.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword змінює пароль вказаного користувача.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant надає роль вказаному користувачу.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole відкликає роль вказаного користувача.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd додає нову роль. Імʼя ролі не може бути порожнім.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet отримує детальну інформацію про роль.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList отримує список всіх ролей.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete видаляє вказану роль.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission надає дозвіл на вказаний ключ або діапазон вказаній ролі.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission відкликає дозвіл на ключ або діапазон вказаної ролі.

service `Cluster` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd додає учасника до кластера.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove видаляє існуючого учасника з кластера.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate оновлює конфігурацію учасника.
MemberList	MemberListRequest	MemberListResponse	MemberList показує всіх учасників кластера.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote підвищує учасника з raft learner (без права голосу) до raft учасника з правом голосу.

service `KV` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Range	RangeRequest	RangeResponse	Range отримує ключі в діапазоні з сховища ключ-значення.
Put	PutRequest	PutResponse	Put вставляє вказаний ключ у сховище ключ-значення. Запит на вставку збільшує ревізію сховища ключ-значення і генерує одну подію в історії подій.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange видаляє вказаний діапазон зі сховища ключ-значення. Запит на видалення збільшує ревізію сховища ключ-значення і генерує подію видалення в історії подій для кожного видаленого ключа.
Txn	TxnRequest	TxnResponse	Txn обробляє кілька запитів в одній транзакції. Запит на транзакцію збільшує ревізію сховища ключ-значення і генерує події з тією ж ревізією для кожного завершеного запиту. Не дозволяється змінювати один і той самий ключ кілька разів в одній транзакції.
Compact	CompactionRequest	CompactionResponse	Compact стискає історію подій у сховищі ключ-значення etcd. Сховище ключ-значення повинно періодично стискатися, інакше історія подій буде рости нескінченно.

service `Lease` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant створює лізинг, який закінчується, якщо сервер не отримує keepAlive протягом заданого періоду часу. Всі ключі, прикріплені до лізингу, будуть видалені після закінчення терміну дії лізингу. Кожен видалений ключ генерує подію видалення в історії подій.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke відкликає лізинг. Всі ключі, прикріплені до лізингу, будуть видалені.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive підтримує лізинг активним, передаючи запити keep alive від клієнта до сервера і відповіді keep alive від сервера до клієнта.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive отримує інформацію про лізинг.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases показує всі існуючі лізинги.

service `Maintenance` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Alarm	AlarmRequest	AlarmResponse	Alarm активує, деактивує та запитує тривоги щодо справності кластера.
Status	StatusRequest	StatusResponse	Status отримує статус учасника.
Defragment	DefragmentRequest	DefragmentResponse	Defragment дефрагментує бекенд бази даних учасника для відновлення місця для зберігання.
Hash	HashRequest	HashResponse	Hash обчислює хеш всього бекенду ключового простору, включаючи ключі, лізинги та інші сегменти в сховищі. Це призначено ТІЛЬКИ для тестування! Не покладайтеся на це у промисловій експлуатації з поточними транзакціями, оскільки операція Hash не утримує блокування MVCC. Використовуйте API “HashKV” замість цього для перевірки узгодженості сегмента “ключ”.
HashKV	HashKVRequest	HashKVResponse	HashKV обчислює хеш всіх ключів MVCC до вказаної ревізії. Він ітерує тільки сегмент “ключ” в бекенді сховища.
Snapshot	SnapshotRequest	SnapshotResponse	Snapshot надсилає знімок всього бекенду від учасника через потік до клієнта.
MoveLeader	MoveLeaderRequest	MoveLeaderResponse	MoveLeader запитує поточного лідера вузла передати своє лідерство іншому вузлу.
Downgrade	DowngradeRequest	DowngradeResponse	Downgrade запитує зниження, перевіряє можливість або скасовує зниження версії кластера. Підтримується з версії etcd 3.5.

service `Watch` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Watch	WatchRequest	WatchResponse	Watch спостерігає за подіями, що відбуваються або вже відбулися. Вхідний і вихідний потоки; вхідний потік створює і скасовує спостерігачів, а вихідний потік надсилає події. Один запит на спостереження може спостерігати за кількома діапазонами ключів, передаючи події для кількох спостережень одночасно. Вся історія подій може бути переглянута, починаючи з останньої ревізії стиснення.

message `AlarmMember` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
memberID	memberID - це ID учасника, повʼязаного з піднятою тривогою.	uint64
alarm	alarm - це тип тривоги, яка була піднята.	AlarmType

message `AlarmRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
action	action - це тип запиту на тривогу. Дія може бути GET для отримання статусів тривог, ACTIVATE для активації тривоги або DEACTIVATE для деактивації піднятої тривоги.	AlarmAction
memberID	memberID - це ID учасника, повʼязаного з тривогою. Якщо memberID дорівнює 0, запит на тривогу охоплює всіх учасників.	uint64
alarm	alarm - це тип тривоги, яку слід розглянути для цього запиту.	AlarmType

message `AlarmResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
alarms	alarms - це список тривог, повʼязаних із запитом на тривогу.	(slice of) AlarmMember

message `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, яку потрібно додати до системи автентифікації.	string

message `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
header		ResponseHeader
perm		(slice of) authpb.Permission

message `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, якій буде надано дозвіл.	string
perm	perm - це дозвіл, який буде надано ролі.	authpb.Permission

message `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string
key		bytes
range_end		bytes

message `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
enabled		bool
authRevision	authRevision - це поточна ревізія сховища автентифікації	uint64

message `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string
options		authpb.UserAddOptions
hashedPassword		string

message `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, пароль якого змінюється.	string
password	password - це новий пароль для користувача. Зверніть увагу, що це поле буде видалено на рівні API.	string
hashedPassword	hashedPassword - це новий пароль для користувача. Зверніть увагу, що це поле буде ініціалізовано на рівні API.	string

message `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, якого потрібно видалити.	string

message `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string

message `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
user	user - це імʼя користувача, якому слід надати вказану роль.	string
role	role - це імʼя ролі, яку слід надати користувачу.	string

message `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthUserListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
users		(slice of) string

message `AuthUserRevokeRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
role		string

message `AuthUserRevokeRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthenticateRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string

message `AuthenticateResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
token	token - це авторизований токен, який можна використовувати в наступних RPC	string

message `CompactionRequest` (api/etcdserverpb/rpc.proto)

Довідник API

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

Ця довідник API автоматично згенерована з вказаних файлів .proto.

service `Auth` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
AuthEnable	AuthEnableRequest	AuthEnableResponse	AuthEnable вмикає автентифікацію.
AuthDisable	AuthDisableRequest	AuthDisableResponse	AuthDisable вимикає автентифікацію.
AuthStatus	AuthStatusRequest	AuthStatusResponse	AuthStatus показує статус автентифікації.
Authenticate	AuthenticateRequest	AuthenticateResponse	Authenticate обробляє запит автентифікації.
UserAdd	AuthUserAddRequest	AuthUserAddResponse	UserAdd додає нового користувача. Імʼя користувача не може бути порожнім.
UserGet	AuthUserGetRequest	AuthUserGetResponse	UserGet отримує детальну інформацію про користувача.
UserList	AuthUserListRequest	AuthUserListResponse	UserList отримує список всіх користувачів.
UserDelete	AuthUserDeleteRequest	AuthUserDeleteResponse	UserDelete видаляє вказаного користувача.
UserChangePassword	AuthUserChangePasswordRequest	AuthUserChangePasswordResponse	UserChangePassword змінює пароль вказаного користувача.
UserGrantRole	AuthUserGrantRoleRequest	AuthUserGrantRoleResponse	UserGrant надає роль вказаному користувачу.
UserRevokeRole	AuthUserRevokeRoleRequest	AuthUserRevokeRoleResponse	UserRevokeRole відкликає роль вказаного користувача.
RoleAdd	AuthRoleAddRequest	AuthRoleAddResponse	RoleAdd додає нову роль. Імʼя ролі не може бути порожнім.
RoleGet	AuthRoleGetRequest	AuthRoleGetResponse	RoleGet отримує детальну інформацію про роль.
RoleList	AuthRoleListRequest	AuthRoleListResponse	RoleList отримує список всіх ролей.
RoleDelete	AuthRoleDeleteRequest	AuthRoleDeleteResponse	RoleDelete видаляє вказану роль.
RoleGrantPermission	AuthRoleGrantPermissionRequest	AuthRoleGrantPermissionResponse	RoleGrantPermission надає дозвіл на вказаний ключ або діапазон вказаній ролі.
RoleRevokePermission	AuthRoleRevokePermissionRequest	AuthRoleRevokePermissionResponse	RoleRevokePermission відкликає дозвіл на ключ або діапазон вказаної ролі.

service `Cluster` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
MemberAdd	MemberAddRequest	MemberAddResponse	MemberAdd додає учасника до кластера.
MemberRemove	MemberRemoveRequest	MemberRemoveResponse	MemberRemove видаляє існуючого учасника з кластера.
MemberUpdate	MemberUpdateRequest	MemberUpdateResponse	MemberUpdate оновлює конфігурацію учасника.
MemberList	MemberListRequest	MemberListResponse	MemberList показує всіх учасників кластера.
MemberPromote	MemberPromoteRequest	MemberPromoteResponse	MemberPromote підвищує учасника з raft learner (без права голосу) до raft учасника з правом голосу.

service `KV` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Range	RangeRequest	RangeResponse	Range отримує ключі в діапазоні з сховища ключ-значення.
Put	PutRequest	PutResponse	Put вставляє вказаний ключ у сховище ключ-значення. Запит на вставку збільшує ревізію сховища ключ-значення і генерує одну подію в історії подій.
DeleteRange	DeleteRangeRequest	DeleteRangeResponse	DeleteRange видаляє вказаний діапазон зі сховища ключ-значення. Запит на видалення збільшує ревізію сховища ключ-значення і генерує подію видалення в історії подій для кожного видаленого ключа.
Txn	TxnRequest	TxnResponse	Txn обробляє кілька запитів в одній транзакції. Запит на транзакцію збільшує ревізію сховища ключ-значення і генерує події з тією ж ревізією для кожного завершеного запиту. Не дозволяється змінювати один і той самий ключ кілька разів в одній транзакції.
Compact	CompactionRequest	CompactionResponse	Compact стискає історію подій у сховищі ключ-значення etcd. Сховище ключ-значення повинно періодично стискатися, інакше історія подій буде рости нескінченно.

service `Lease` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
LeaseGrant	LeaseGrantRequest	LeaseGrantResponse	LeaseGrant створює лізинг, який закінчується, якщо сервер не отримує keepAlive протягом заданого періоду часу. Всі ключі, прикріплені до лізингу, будуть видалені після закінчення терміну дії лізингу. Кожен видалений ключ генерує подію видалення в історії подій.
LeaseRevoke	LeaseRevokeRequest	LeaseRevokeResponse	LeaseRevoke відкликає лізинг. Всі ключі, прикріплені до лізингу, будуть видалені.
LeaseKeepAlive	LeaseKeepAliveRequest	LeaseKeepAliveResponse	LeaseKeepAlive підтримує лізинг активним, передаючи запити keep alive від клієнта до сервера і відповіді keep alive від сервера до клієнта.
LeaseTimeToLive	LeaseTimeToLiveRequest	LeaseTimeToLiveResponse	LeaseTimeToLive отримує інформацію про лізинг.
LeaseLeases	LeaseLeasesRequest	LeaseLeasesResponse	LeaseLeases показує всі існуючі лізинги.

service `Maintenance` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Alarm	AlarmRequest	AlarmResponse	Alarm активує, деактивує та запитує тривоги щодо справності кластера.
Status	StatusRequest	StatusResponse	Status отримує статус учасника.
Defragment	DefragmentRequest	DefragmentResponse	Defragment дефрагментує бекенд бази даних учасника для відновлення місця для зберігання.
Hash	HashRequest	HashResponse	Hash обчислює хеш всього бекенду ключового простору, включаючи ключі, лізинги та інші сегменти в сховищі. Це призначено ТІЛЬКИ для тестування! Не покладайтеся на це у промисловій експлуатації з поточними транзакціями, оскільки операція Hash не утримує блокування MVCC. Використовуйте API “HashKV” замість цього для перевірки узгодженості сегмента “ключ”.
HashKV	HashKVRequest	HashKVResponse	HashKV обчислює хеш всіх ключів MVCC до вказаної ревізії. Він ітерує тільки сегмент “ключ” в бекенді сховища.
Snapshot	SnapshotRequest	SnapshotResponse	Snapshot надсилає знімок всього бекенду від учасника через потік до клієнта.
MoveLeader	MoveLeaderRequest	MoveLeaderResponse	MoveLeader запитує поточного лідера вузла передати своє лідерство іншому вузлу.
Downgrade	DowngradeRequest	DowngradeResponse	Downgrade запитує зниження, перевіряє можливість або скасовує зниження версії кластера. Підтримується з версії etcd 3.5.

service `Watch` (api/etcdserverpb/rpc.proto)

Метод	Тип запиту	Тип відповіді	Опис
Watch	WatchRequest	WatchResponse	Watch спостерігає за подіями, що відбуваються або вже відбулися. Вхідний і вихідний потоки; вхідний потік створює і скасовує спостерігачів, а вихідний потік надсилає події. Один запит на спостереження може спостерігати за кількома діапазонами ключів, передаючи події для кількох спостережень одночасно. Вся історія подій може бути переглянута, починаючи з останньої ревізії стиснення.

message `AlarmMember` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
memberID	memberID - це ID учасника, повʼязаного з піднятою тривогою.	uint64
alarm	alarm - це тип тривоги, яка була піднята.	AlarmType

message `AlarmRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
action	action - це тип запиту на тривогу. Дія може бути GET для отримання статусів тривог, ACTIVATE для активації тривоги або DEACTIVATE для деактивації піднятої тривоги.	AlarmAction
memberID	memberID - це ID учасника, повʼязаного з тривогою. Якщо memberID дорівнює 0, запит на тривогу охоплює всіх учасників.	uint64
alarm	alarm - це тип тривоги, яку слід розглянути для цього запиту.	AlarmType

message `AlarmResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
alarms	alarms - це список тривог, повʼязаних із запитом на тривогу.	(slice of) AlarmMember

message `AuthDisableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthDisableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthEnableRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthEnableResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, яку потрібно додати до системи автентифікації.	string

message `AuthRoleAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string

message `AuthRoleGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
header		ResponseHeader
perm		(slice of) authpb.Permission

message `AuthRoleGrantPermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя ролі, якій буде надано дозвіл.	string
perm	perm - це дозвіл, який буде надано ролі.	authpb.Permission

message `AuthRoleGrantPermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthRoleListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthRoleListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthRoleRevokePermissionRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
role		string
key		bytes
range_end		bytes

message `AuthRoleRevokePermissionResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthStatusRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthStatusResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
enabled		bool
authRevision	authRevision - це поточна ревізія сховища автентифікації	uint64

message `AuthUserAddRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string
options		authpb.UserAddOptions
hashedPassword		string

message `AuthUserAddResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserChangePasswordRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, пароль якого змінюється.	string
password	password - це новий пароль для користувача. Зверніть увагу, що це поле буде видалено на рівні API.	string
hashedPassword	hashedPassword - це новий пароль для користувача. Зверніть увагу, що це поле буде ініціалізовано на рівні API.	string

message `AuthUserChangePasswordResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserDeleteRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name	name - це імʼя користувача, якого потрібно видалити.	string

message `AuthUserDeleteResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserGetRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string

message `AuthUserGetResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
roles		(slice of) string

message `AuthUserGrantRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
user	user - це імʼя користувача, якому слід надати вказану роль.	string
role	role - це імʼя ролі, яку слід надати користувачу.	string

message `AuthUserGrantRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthUserListRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option

message `AuthUserListResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
users		(slice of) string

message `AuthUserRevokeRoleRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
role		string

message `AuthUserRevokeRoleResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader

message `AuthenticateRequest` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
name		string
password		string

message `AuthenticateResponse` (api/etcdserverpb/rpc.proto)

Поле	Опис	Тип
(versionpb.etcd_version_msg)		option
header		ResponseHeader
token	token - це авторизований токен, який можна використовувати в наступних RPC	string

message `CompactionRequest` (api/etcdserverpb/rpc.proto)

Довідник API: паралельність

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

Ця довідка API автоматично згенерована з вказаних файлів .proto.

service `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Сервіс блокування надає клієнтські засоби блокування як інтерфейс gRPC.

Метод	Тип запиту	Тип відповіді	Опис
Lock	LockRequest	LockResponse	Lock отримує розподілений спільний блок на вказаному іменованому блоці. У разі успіху, він поверне унікальний ключ, який існує, поки блок утримується викликачем. Цей ключ можна використовувати разом з транзакціями, щоб безпечно забезпечити оновлення до etcd лише під час утримання блоку. Блок утримується до виклику Unlock на ключі або до закінчення терміну дії оренди, повʼязаної з власником.
Unlock	UnlockRequest	UnlockResponse	Unlock приймає ключ, повернутий Lock, і звільняє утримання блоку. Наступний викликач Lock, який чекає на блок, буде розбуджений і отримає право власності на блок.

message `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
name	name є ідентифікатором для розподіленого спільного блоку, який потрібно отримати.	bytes
lease	lease є ID оренди, яка буде прикріплена до права власності на блок. Якщо оренда закінчується або відкликається і наразі утримує блок, блок автоматично звільняється. Виклики до Lock з тією ж орендою будуть розглядатися як одне отримання; блокування двічі з тією ж орендою є бездіяльністю.	int64

message `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader
key	key є ключем, який існуватиме в etcd протягом часу, коли викликач Lock утримує блок. Користувачі не повинні змінювати цей ключ, інакше блок може проявляти невизначену поведінку.	bytes

message `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
key	key є ключем права власності на блок, наданим Lock.	bytes

message `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader

service `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Сервіс виборів надає клієнтські засоби виборів як інтерфейс gRPC.

Довідник API: паралельність

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

Ця довідка API автоматично згенерована з вказаних файлів .proto.

service `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Сервіс блокування надає клієнтські засоби блокування як інтерфейс gRPC.

Метод	Тип запиту	Тип відповіді	Опис
Lock	LockRequest	LockResponse	Lock отримує розподілений спільний блок на вказаному іменованому блоці. У разі успіху, він поверне унікальний ключ, який існує, поки блок утримується викликачем. Цей ключ можна використовувати разом з транзакціями, щоб безпечно забезпечити оновлення до etcd лише під час утримання блоку. Блок утримується до виклику Unlock на ключі або до закінчення терміну дії оренди, повʼязаної з власником.
Unlock	UnlockRequest	UnlockResponse	Unlock приймає ключ, повернутий Lock, і звільняє утримання блоку. Наступний викликач Lock, який чекає на блок, буде розбуджений і отримає право власності на блок.

message `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
name	name є ідентифікатором для розподіленого спільного блоку, який потрібно отримати.	bytes
lease	lease є ID оренди, яка буде прикріплена до права власності на блок. Якщо оренда закінчується або відкликається і наразі утримує блок, блок автоматично звільняється. Виклики до Lock з тією ж орендою будуть розглядатися як одне отримання; блокування двічі з тією ж орендою є бездіяльністю.	int64

message `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader
key	key є ключем, який існуватиме в etcd протягом часу, коли викликач Lock утримує блок. Користувачі не повинні змінювати цей ключ, інакше блок може проявляти невизначену поведінку.	bytes

message `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
key	key є ключем права власності на блок, наданим Lock.	bytes

message `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader

service `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Сервіс виборів надає клієнтські засоби виборів як інтерфейс gRPC.

Довідник API: паралельність

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

Ця довідка API автоматично згенерована з вказаних файлів .proto.

service `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Сервіс блокування надає клієнтські засоби блокування як інтерфейс gRPC.

Метод	Тип запиту	Тип відповіді	Опис
Lock	LockRequest	LockResponse	Lock отримує розподілений спільний блок на вказаному іменованому блоці. У разі успіху, він поверне унікальний ключ, який існує, поки блок утримується викликачем. Цей ключ можна використовувати разом з транзакціями, щоб безпечно забезпечити оновлення до etcd лише під час утримання блоку. Блок утримується до виклику Unlock на ключі або до закінчення терміну дії оренди, повʼязаної з власником.
Unlock	UnlockRequest	UnlockResponse	Unlock приймає ключ, повернутий Lock, і звільняє утримання блоку. Наступний викликач Lock, який чекає на блок, буде розбуджений і отримає право власності на блок.

message `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
name	name є ідентифікатором для розподіленого спільного блоку, який потрібно отримати.	bytes
lease	lease є ID оренди, яка буде прикріплена до права власності на блок. Якщо оренда закінчується або відкликається і наразі утримує блок, блок автоматично звільняється. Виклики до Lock з тією ж орендою будуть розглядатися як одне отримання; блокування двічі з тією ж орендою є бездіяльністю.	int64

message `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader
key	key є ключем, який існуватиме в etcd протягом часу, коли викликач Lock утримує блок. Користувачі не повинні змінювати цей ключ, інакше блок може проявляти невизначену поведінку.	bytes

message `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
key	key є ключем права власності на блок, наданим Lock.	bytes

message `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader

service `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Сервіс виборів надає клієнтські засоби виборів як інтерфейс gRPC.

Довідник API: паралельність

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

Ця довідка API автоматично згенерована з вказаних файлів .proto.

service `Lock` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Сервіс блокування надає клієнтські засоби блокування як інтерфейс gRPC.

Метод	Тип запиту	Тип відповіді	Опис
Lock	LockRequest	LockResponse	Lock отримує розподілений спільний блок на вказаному іменованому блоці. У разі успіху, він поверне унікальний ключ, який існує, поки блок утримується викликачем. Цей ключ можна використовувати разом з транзакціями, щоб безпечно забезпечити оновлення до etcd лише під час утримання блоку. Блок утримується до виклику Unlock на ключі або до закінчення терміну дії оренди, повʼязаної з власником.
Unlock	UnlockRequest	UnlockResponse	Unlock приймає ключ, повернутий Lock, і звільняє утримання блоку. Наступний викликач Lock, який чекає на блок, буде розбуджений і отримає право власності на блок.

message `LockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
name	name є ідентифікатором для розподіленого спільного блоку, який потрібно отримати.	bytes
lease	lease є ID оренди, яка буде прикріплена до права власності на блок. Якщо оренда закінчується або відкликається і наразі утримує блок, блок автоматично звільняється. Виклики до Lock з тією ж орендою будуть розглядатися як одне отримання; блокування двічі з тією ж орендою є бездіяльністю.	int64

message `LockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader
key	key є ключем, який існуватиме в etcd протягом часу, коли викликач Lock утримує блок. Користувачі не повинні змінювати цей ключ, інакше блок може проявляти невизначену поведінку.	bytes

message `UnlockRequest` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
key	key є ключем права власності на блок, наданим Lock.	bytes

message `UnlockResponse` (server/etcdserver/api/v3lock/v3lockpb/v3lock.proto)

Поле	Опис	Тип
header		etcdserverpb.ResponseHeader

service `Election` (server/etcdserver/api/v3election/v3electionpb/v3election.proto)

Сервіс виборів надає клієнтські засоби виборів як інтерфейс gRPC.

Управління PR

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

Мета

Прискорити управління PR.

PR для etcd містяться у https://github.com/etcd-io/etcd/pulls. PR може мати різні мітки, етапи, рецензентів тощо. Детальний список міток можна знайти на https://github.com/kubernetes/kubernetes/labels

Нижче наведено кілька прикладів пошуку PR для зручності:

Обсяг дії

Ці рекомендації служать основним документом для управління PR в etcd. Кожен може допомогти в управлінні PR, але робота та обовʼязки, описані в цьому документі, створені з урахуванням підтримувачів та активних учасників etcd.

Управління PR

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

Мета

Покращити управління PR.

Нижче наведено кілька прикладів пошуку PR для зручності:

Обсяг дії

Управління PR

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

Мета

Покращити управління PR.

Нижче наведено кілька прикладів пошуку PR для зручності:

Обсяг дії

Управління PR

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

Мета

Покращити управління PR.

Нижче наведено кілька прикладів пошуку PR для зручності: