Распределенные блокировки для 1С:Предприятия в кластере Yandex Managed Service for Valkey™

Кластер Yandex Managed Service for Valkey™ можно использовать как хранилище распределенных блокировок для 1С:Предприятия — например, чтобы несколько пользователей не могли одновременно редактировать один и тот же элемент справочника.

Интеграция выполняется через промежуточный HTTP-сервер, развернутый на виртуальной машине Yandex Compute Cloud. Сервер предоставляет HTTP API для управления блокировками и использует кластер Valkey™ в качестве бэкенда. Модуль в 1С:Предприятии взаимодействует с API через внешнее соединение.

Чтобы настроить блокировки:

1. Подготовьте инфраструктуру.
2. Разверните HTTP-сервер блокировок.
3. Настройте модуль в 1С:Предприятии.
4. Проверьте работу блокировок.
5. Удалите созданные ресурсы

Перед началом работыПеред началом работы

Зарегистрируйтесь в Yandex Cloud и создайте платежный аккаунт:

1. Перейдите в консоль управления, затем войдите в Yandex Cloud или зарегистрируйтесь.
2. На странице Yandex Cloud Billing убедитесь, что у вас подключен платежный аккаунт, и он находится в статусе ACTIVE или TRIAL_ACTIVE. Если платежного аккаунта нет, создайте его и привяжите к нему облако.

Если у вас есть активный платежный аккаунт, вы можете создать или выбрать каталог, в котором будет работать ваша инфраструктура, на странице облака.

Подробнее об облаках и каталогах.

Необходимые платные ресурсыНеобходимые платные ресурсы

• Кластер Yandex Managed Service for Valkey™: вычислительные ресурсы хостов и объем хранилища (тарифы Yandex Managed Service for Valkey™).
• Виртуальная машина: использование вычислительных ресурсов, хранилища, публичного IP-адреса и операционной системы (тарифы Compute Cloud).

Подготовьте инфраструктуруПодготовьте инфраструктуру

Разверните HTTP-сервер блокировокРазверните HTTP-сервер блокировок

HTTP-сервер блокировок — это тонкая прослойка между сервером 1С:Предприятия и кластером Yandex Managed Service for Valkey™. Он предоставляет эндпоинты с префиксом lock:

Логика работы с кластером:

• Захват блокировки (lock/acquire) выполняется командой SET с аргументом NX и установкой времени жизни ключа (PX). Аргумент NX гарантирует, что блокировка захватывается, только если ключа еще нет, а TTL не дает удерживать блокировку бесконечно:

  SET <ключ> <токен> NX PX <ttl_в_миллисекундах>
  

• Освобождение (lock/release) и продление (lock/renew) блокировки выполняются командой EVAL с вызовом Lua-скриптов. В рамках скриптов выполняются несколько последовательных операций в Valkey™:

  1. Получение данных блокировки по ключу.
  2. Сравнение токена блокировки и токена из запроса.
  3. Удаление ключа или продление срока блокировки.

  Вызов скрипта обеспечивает атомарность транзакции, т. е. гарантирует, что все операции выполнятся целиком или не выполнятся вовсе. Пример скрипта для освобождения блокировки:

  -- release: удалить ключ, только если токен совпадает
  local value = server.call('GET', KEYS[1])
  if not value then
    return 0
  end
  local ok, lock = pcall(cjson.decode, value)
  if not ok or lock['token'] ~= ARGV[1] then
    return 0
  end
  return server.call('DEL', KEYS[1])
  

• Сервер возвращает HTTP-коды состояния и сообщения об ошибках (удалось ли захватить, освободить или продлить блокировку).

Чтобы развернуть сервер:

Настройте модуль в 1С:ПредприятииНастройте модуль в 1С:Предприятии

В 1С:Предприятии используется модуль Блокировка каталога, который обращается к HTTP-серверу по внешнему соединению. Готовый код модуля содержится в контейнере с тестовой базой данных 1С:Предприятия в репозитории valkey/webinar-260624-1c-example.

Модуль выполняет следующие функции:

• Отправка HTTP-запросов к эндпоинтам сервера (lock/acquire, lock/release, lock/status, lock/renew, lock/list) в зависимости от действия.
• Формирование ключа блокировки из полного пути каталога (метаданных коллекции) и идентификатора элемента. Это гарантирует уникальность блокировки для конкретного элемента справочника.
• В форме модуля настраиваются обработчики событий для справочников:
  • при открытии — попытка захватить блокировку;
  • при изменении и закрытии — продлить или освободить блокировку.
• Чтобы не истек срок действия блокировки во время работы пользователя с формой, настраивается периодическое продление блокировки.
• Для наглядности на форму выводится информация о блокировке: состояние (захвачена или свободна), оставшийся TTL и токен, по которому проверяется владение блокировкой.

Чтобы настроить модуль:

1. Подключите базу данных из папки 1CExample репозитория и скопируйте общий модуль БлокировкиКаталогов в вашу конфигурацию 1С:Предприятия.

2. Если методы вызываются из серверного кода форм, проверьте, что у модуля включен серверный вызов.

3. В функции HTTPЗапрос() укажите адрес HTTP-сервера блокировок:

   Соединение = Новый HTTPСоединение("<публичный_IP_адрес_созданной_ВМ>", <порт_из_переменной_HTTP_ADDR>);
   

4. Добавьте блокировку в нужную форму. Для этого:

   • Добавьте реквизиты формы для токена и статуса.
   • При открытии формы вызывайте ЗаблокироватьКаталог().
   • При закрытии формы вызывайте РазблокироватьКаталог().
   • Подключите периодическую отправку renew.

5. Подключите обработчики событий формы к нужным справочникам. Пример для минимальной функциональности:

   ПриСозданииНаСервере:
       acquire
   
   ПриОткрытии:
       renew
   
   ПриЗакрытии:
       release
   

6. Настройте ключ блокировки. По умолчанию ключ формируется как:

   "Справочник." + Ссылка.Метаданные().Имя + ":" + Ссылка.УникальныйИдентификатор()
   

   Для документов можно сделать аналогично:

   Документ.ЗаказКлиента:УникальныйИдентификатор()
   

   Если нужно использовать один модуль для разных типов объектов, обобщите функцию КлючБлокировки().

Проверьте работу блокировокПроверьте работу блокировок

1. Откройте 1С:Предприятие и перейдите в справочник, например Клиенты.

2. Откройте на редактирование элемент, например Роман. На форме отобразится состояние блокировки — захвачена, а также TTL блокировки и токен.

3. Понаблюдайте за TTL: он должен уменьшаться со временем (например, 41 → 31 секунда). По истечении интервала продления (по умолчанию 30 секунд) 1С:Предприятие автоматически продлевает блокировку.

4. Убедитесь, что блокировка отражается в кластере:

   Консоль управления

   SQL

   1. Откройте Подключения Yandex WebSQL.
   2. Добавьте подключение к БД для созданного ранее сервера Valkey™. Укажите имя БД 0.
   3. Подключитесь к базе данных 0 и найдите строку с ключом блокировки.

   Примечание

   Из-за особенностей кодировки имя ключа в WebSQL может отображаться некорректно. Для проверки владения блокировкой ориентируйтесь на его наличие и значение (токен), а не на читаемость имени.

   Подключитесь к кластеру Yandex Managed Service for Valkey™ и выполните запрос:

   KEYS <префикс_ключа_блокировки>:*
   

   Valkey™ вернет строку с ключом блокировки.

Удалите созданные ресурсыУдалите созданные ресурсы

Чтобы снизить потребление ресурсов, которые вам не нужны, удалите их: