Настройка облачного сервера очередей

Самый простой вариант, требует только активную лицензию на продукты «1С-Битрикс» (Битрикс24 и 1С-Битрикс: Управление сайтом). Также удобен, если продукт «1С-Битрикс» установлен на shared-хостинге или вместо виртуальной машины VMBitrix используется собственное серверное окружение.

Перейдите в административном разделе: Настройки > Настройки продукта > Настройки модулей > Push and Pull, выберите вариант Облачный сервер «1С-Битрикс» и географическое расположение сервера по желанию (можно оставить автоматический выбор). Остается только нажать на кнопку Зарегистрироваться:

Все готово, облачный сервер очередей «1С-Битрикс» настроен и активен:

  Настройка локального Bitrix Push server

Есть случаи, когда нельзя использовать в качестве сервера очередей облачный сервер «1С-Битрикс», например, когда политикой безопасности предприятия серверу ограничен доступ в интернет. Для такого случая есть возможность установить локальный сервер очередей.

Устанавливать будем сервер очередей Bitrix Push server 2.0. Ранее (до осени 2021 года) были доступны и другие версии Осенью 2021 года прекращена поддержка старых версий локальных серверов очередей Nginx-PushStreamModule 0.3.4/0.4.0 и Bitrix Push server 1.0.

Подробнее... серверов очередей, которые на текущий момент являются устаревшими.

1. Обновление VMBitrix

Обновите виртуальную машину VMBitrix до последней стабильной версии: 2. Configure localhost settings > 6. Update server.

2. Установка Bitrix Push server 2.0

По умолчанию в виртуальной машине VMBitrix версии 7.4.4 и ниже в качестве сервера очередей используется Nginx-PushStreamModule.

В главном меню виртуальной машины VMBitrix: 9. Configure Push/RTC service for the pool смотрим, какой сервер используется в качестве сервера очередей. В данном примере видим, что это действительно Nginx-PushStreamModule:

Выбираем пункт меню 1. Install/Update NodeJS RTC service, вводим название хоста Hostname и подтверждаем установку:

Дожидаемся, пока задача по установке и запуску службы NodeJS-PushServer будет закончена:

3. Bitrix Push server 2.0 в продуктах «1С-Битрикс»

Перед установкой Bitrix Push server 2.0 вам нужно предварительно сбросить настройки сервера очередей. Для этого нажмите на кнопку По умолчанию:

Далее в опции Использовать "Push server": установленный локально выберите Виртуальная машина 7.3 - 7.5 (Bitrix Push server 2.0) и сохраните настройки:

Все готово. Как правило, никаких настроек больше не требуется.

Какие ещё настройки можно выполнить

• При необходимости перенастройте адреса для публикации и чтения команд. Домен в адресе для чтения сообщений можно указать #DOMAIN#: такая нотация будет автоматически заменяться под нужный домен для многодоменных конфигураций. Пример: http://#DOMAIN#:8893/bitrix/sub/.
• Если в системе несколько активных сайтов, то есть возможность выбрать, на каких сайтах не использовать модуль Push and Pull.

  Возможные ошибки Bitrix Push server 2.0

При установке и первом запуске Bitrix Push server 2.0 создается уникальный секретный код в файле настроек сервера очередей /etc/push-server/push-server*.json в секции security в параметре key:

"security": {
	"key": "<ваш секретный ключ>"
},

В виртуальной машине BitrixVM при первом запуске Bitrix Push server 2.0 этот код автоматически прописывается в файл настроек ядра системы /bitrix/.setting.php и в базу данных, а также он виден в административном интерфейсе в поле Код-подпись для взаимодействия с сервером:

Бывают ситуации, когда по каким-либо причинам в файле настроек ядра /bitrix/.setting.php и в базе данных секретный код отличается от того, который прописан в настройках сервера очередей. Из-за этого сервер очередей работает некорректно, сообщения не доставляются.

Чтобы решить эту проблему, необходимо в меню виртуальной машины BitrixVM пересоздать роль NodeJS-PushServer: 9. Configure Push/RTC service for the pool > 1. Install/Update NodeJS RTC service

Если у вас свое серверное окружение, то можно сделать это вручную:

1. Скопировать ключ из файла настроек сервера очередей /etc/push-server/push-server*.json.
2. Перейти в административном интерфейсе продукта «1С-Битрикс»: Настройки > Настройки продукта > Настройки модулей > Push and Pull и сбросить настройки сервера очередей кнопкой По умолчанию.
3. Скопированный ключ вставить в поле Код-подпись для взаимодействия с сервером и сохранить настройки.

После этого работа сервера очередей будет восстановлена.

  Доп. материалы

• Настройки модуля (документация)
• Зачем настраивать модуль Push&Pull (блог)
• Работа с модулем для разработчиков
• API модуля
• Push-уведомления в курсе «BitrixMobile - создание кроссплатформенных мобильных приложений»
• Новые требования к серверному окружению для работы чатов
• Переход c Bitrix Push server 1.0 на Bitrix Push server 2.0
• Переход с Nginx-PushStreamModule на Bitrix Push server 2.0
• Исходные коды пакетов виртуальной машины VMBitrix
• Установка БУС/КП на другие окружения