Конкурентная запись и завершение операций

Единица блокировки

Altera содержит общий для серверного процесса реестр WRITES. Ключ блокировки — полный путь модуля, например /backend3/hostname.

Ниже показаны тела ответов и событий. В Unix-соединении и на веб-маршруте /ws они обёрнуты путём модуля, на фиксированном веб-маршруте передаются без обёртки.

После разрешения операции с именем write Altera пытается захватить блокировку. Если другой экземпляр того же модуля уже пишет:

{"type":"woo-error","code":"busy","message":"Module is busy writing"}

При успешном захвате подписчики модуля получают:

{"altera":"write_state","busy":true}

После завершения:

{"altera":"write_state","busy":false}

При подключении к модулю передаётся и начальный снимок его состояния.

Последовательность выполнения

Клиент: write
    ↓
Проверка разрешения
    ↓ Allow
Подготовка сообщения
    ↓
Захват блокировки WRITES для пути модуля
    ├─ Модуль занят → woo-error/busy
    └─ Блокировка получена
         ↓
       Уведомление write_state: busy=true
         ↓
       Запрос в stdin backend
         ↓
       Данные ответа → клиент
         ↓
       Завершение операции
         ↓
       Освобождение блокировки
         ↓
       Уведомление write_state: busy=false

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

Что блокировка гарантирует и чего не гарантирует

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

Она не блокирует другие модули/пути бекенда или стороннюю утилиту, редактирующие тот же файл, и не охватывает другой экземпляр сервера. read/list из других соединений не получают аналогичную эксклюзивную блокировку.

Поэтому модуль должен сам обеспечивать целостность своих данных, корректно называть изменяющие действия и не объявлять завершение раньше, чем закончены его изменения. Нельзя запускать изменение «в фоне», сразу выводить _message:end и считать файл защищённым до завершения фонового процесса.

Если корректное завершение/очистка не подтверждены, WriteGuard не освобождает блокировку, и модуль может остаться занятым до перезапуска основной службы Altera.

Источники