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

3. Распределение работы между обработчиками

В этом руководстве вы запустите два обработчика с общей темой и увидите, как сервер распределяет между ними работу. Вы опубликуете шесть сообщений в tasks, и каждое попадёт ровно одному обработчику, а не обоим. Это группа очереди — пул подписчиков с общим именем, которые делят нагрузку.

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

  • Установленные nats-server и CLI nats. Если их ещё нет, сначала пройдите руководство Привет, NATS.
  • Четыре окна терминала: одно для сервера, два для обработчиков и одно для публикации.

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

В первом терминале запустите nats-server:

nats-server

Журнал запуска должен заканчиваться строкой о готовности:

[INF] Server is ready

Оставьте сервер работающим.

Шаг 2: запустите первый обработчик​

Во втором терминале подпишитесь на тему tasks как участник группы очереди workers. Именно флаг --queue делает подписчика участником группы очереди, а не обычным подписчиком:

#!/bin/bash
# Подпишитесь на тему "tasks" как участник группы очереди "workers".
# Параметр --queue задаёт имя группы. Подписчики одной и той же
# группы в одной теме разделяют нагрузку: каждое сообщение доставляется
# ровно одному участнику. Запустите команду в двух терминалах, чтобы увидеть
# распределение заданий. Для остановки нажмите Ctrl-C.
nats sub tasks --queue workers

Обработчик должен перейти в ожидание сообщений:

17:42:10 Subscribing on tasks

Оставьте его работающим.

Шаг 3: запустите второй обработчик​

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

#!/bin/bash
# Подпишитесь на тему "tasks" как участник группы очереди "workers".
# Параметр --queue задаёт имя группы. Подписчики одной и той же
# группы в одной теме разделяют нагрузку: каждое сообщение доставляется
# ровно одному участнику. Запустите команду в двух терминалах, чтобы увидеть
# распределение заданий. Для остановки нажмите Ctrl-C.
nats sub tasks --queue workers

Вы должны увидеть такую же строку ожидания:

17:42:18 Subscribing on tasks

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

Шаг 4: опубликуйте задания​

В четвёртом терминале опубликуйте шесть сообщений в tasks. Флаг --count повторяет публикацию шесть раз, а CLI заменяет {{ Count }} номером сообщения:

#!/bin/bash
# Опубликуйте шесть сообщений в теме "tasks". Параметр --count повторяет
# публикацию указанное число раз, а {{ Count }} заменяется номером сообщения
# (1, 2, 3, ...). Если в группе очереди "workers" два обработчика,
# сервер передаёт каждое сообщение ровно одному из них.
nats pub tasks "task {{ Count }}" --count 6

Издатель должен вывести по одной строке подтверждения на сообщение:

17:42:30 Published 6 bytes to "tasks"
17:42:30 Published 6 bytes to "tasks"
17:42:30 Published 6 bytes to "tasks"
17:42:30 Published 6 bytes to "tasks"
17:42:30 Published 6 bytes to "tasks"
17:42:30 Published 6 bytes to "tasks"

Шаг 5: посмотрите на распределение​

Посмотрите на терминалы двух обработчиков. Шесть сообщений распределены между ними: каждый получает часть, и ни одно сообщение не появляется в обоих терминалах. Один терминал может показать:

[#1] Received on "tasks"
task 1

[#2] Received on "tasks"
task 3

[#3] Received on "tasks"
task 5

а другой:

[#1] Received on "tasks"
task 2

[#2] Received on "tasks"
task 4

[#3] Received on "tasks"
task 6

Для каждого сообщения сервер выбирает одного участника, поэтому точное распределение меняется. Неизменно одно: каждое сообщение получает ровно один обработчик.

Повторите публикацию, чтобы ещё раз увидеть распределение:

#!/bin/bash
# Опубликуйте шесть сообщений в теме "tasks". Параметр --count повторяет
# публикацию указанное число раз, а {{ Count }} заменяется номером сообщения
# (1, 2, 3, ...). Если в группе очереди "workers" два обработчика,
# сервер передаёт каждое сообщение ровно одному из них.
nats pub tasks "task {{ Count }}" --count 6

Новая партия так же распределяется между двумя обработчиками. Нажмите Ctrl-C в каждом терминале для остановки.

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

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

Дальше​

  • Создайте поток, который сохраняет сообщения для последующего чтения обработчиком: Первый поток.
  • Узнайте, как сервер выбирает участника, как меняется состав групп во время работы и когда нужна долговременная очередь заданий: Углублённое изучение групп очередей.