Завдання розробника on etcd

Читання з 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!" є значенням у лапках

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

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.
Запущений кластер 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

Використовуйте 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 не буде завершено.

Передумови

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

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

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

etcdctl --endpoints=$ENDPOINTS lock mutex1

Параметри

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