Перейти к основному содержимому

6. Хранение состояния в Key-Value

Вы создадите бакет Key-Value, запишете значение, прочитаете его, а затем включите наблюдение за бакетом во втором терминале, чтобы видеть изменения сразу после их появления. В результате у вас будет небольшое хранилище актуального состояния, доступное для чтения, записи и наблюдения.

Что понадобится​

  • Установленные nats-server и CLI nats (см. 1. Привет, NATS).
  • Бакет Key-Value работает поверх потока JetStream, поэтому на шаге 1 вы запустите сервер с включённым JetStream.

Шаг 1: запустите сервер с JetStream​

Бакет Key-Value хранится в JetStream, поэтому запустите сервер с флагом -js.

nats-server -js

В журнале запуска должна появиться строка, подтверждающая включение JetStream:

[INF] Starting JetStream
[INF] Server is ready

Оставьте сервер работающим и откройте новый терминал для следующих шагов.

Шаг 2: создайте бакет​

Создайте бакет profiles. В нём будут храниться ваши значения.

#!/bin/bash
# Создайте хранилище ключей и значений profiles. В нём будут храниться
# ваши значения.

nats kv add profiles

# Появится подтверждение с именем хранилища и его настройками:
#
# Information for Key-Value Store Bucket profiles created 2026-06-09 10:13:41
#
# Configuration:
#
# Bucket Name: profiles
# History Kept: 1
# ...
# Backing Store Kind: JetStream

Должно появиться подтверждение с конфигурацией бакета:

Information for Key-Value Store Bucket profiles created 2026-06-09 10:13:41

Configuration:

Bucket Name: profiles
History Kept: 1
...
Backing Store Kind: JetStream

Шаг 3: запишите и прочитайте значение​

Сохраните значение по ключу, затем прочитайте его. Ключ — sue.color, значение — blue.

#!/bin/bash
# Запишите значение: ключ sue.color, значение blue.

nats kv put profiles sue.color blue

# Будут выведены записанное значение и его ревизия:
#
# blue

# Получите значение по ключу.

nats kv get profiles sue.color

# Будет выведена полная запись, включая значение:
#
# profiles > sue.color revision: 1 created @ ...
#
# blue

Операция записи выводит записанное значение, а чтение возвращает полную запись:

blue
profiles > sue.color revision: 1 created @ ...

blue

Теперь у вас есть одно сохранённое и проверенное значение.

Шаг 4: наблюдайте за бакетом из второго терминала​

Наблюдение (watch) передаёт каждое изменение бакета по мере его появления. Откройте второй терминал и начните наблюдать за profiles.

#!/bin/bash
# Наблюдайте за всем хранилищем profiles. При запуске выводится текущее значение
# каждого ключа, затем команда ожидает изменения и выводит их до остановки
# сочетанием Ctrl-C. Запустите её в отдельном терминале.

nats kv watch profiles

# Сначала появится текущее значение, затем команда будет ожидать изменений:
#
# [2026-06-09 10:14:22] PUT profiles > sue.color: blue

Сначала наблюдатель выводит текущее значение, затем ожидает:

[2026-06-09 10:14:22] PUT profiles > sue.color: blue

Оставьте наблюдение работающим. Вы настроили такую схему: приложение записывает значение, а наблюдатель сразу получает его.

Шаг 5: обновите значение и проверьте уведомление​

Вернитесь в первый терминал и запишите новое значение по тому же ключу.

#!/bin/bash
# Запишите новое значение того же ключа. Обычная операция put перезаписывает
# предыдущее значение.

nats kv put profiles sue.color green

# Будет выведено новое значение:
#
# green
#
# В терминале с наблюдателем новая строка появится сразу после
# записи:
#
# [2026-06-09 10:15:03] PUT profiles > sue.color: green

Операция записи возвращает новое значение:

green

Переключитесь в терминал наблюдения. Новая строка появляется сразу после изменения:

[2026-06-09 10:15:03] PUT profiles > sue.color: green

Когда закончите, остановите наблюдение с помощью Ctrl-C.

Что вы создали​

У вас есть бакет Key-Value с актуальным состоянием: вы записали и прочитали значение, а наблюдатель во втором терминале получал каждое изменение сразу после его появления.

Дальше​

  • Итоговая работа: 7. Создание приложения — объедините публикацию и подписку, запрос и ответ и поток в одной программе.
  • Узнайте, как это работает: углублённый курс Key-Value объясняет бакеты, ревизии, наблюдение и лежащий в основе поток.