Настройки модуля и сервера очередей

Урок 26 из 435
Автор: Марина Павлова
Сложность урока:
3 уровень - средняя сложность. Необходимо внимание и немного подумать.
3 из 5
Дата изменения: 03.03.2021
Просмотров: 108815
Ограничения по редакциям: Старт, Стандарт

Сложность настройки модуля Push and Pull зависит от выбора типа сервера очередей. Сервер очередей Push and Pull служит для мгновенного взаимодействия между собой многих инструментов продуктов Битрикс24 и 1С-Битрикс: Управление сайтом.

  Общая информация

Сервер очередей Push and Pull служит для мгновенного взаимодействия между собой многих инструментов продуктов Битрикс24 и 1С-Битрикс: Управление сайтом. Он используется в Задачах, Календарях, ленте Новостей, Группах, RPA, мобильном приложении Битрикс24, Чатах, Генераторе документов, Телефонии, Центре продаж и в других сервисах.

Внимание: В начале 2021 года будет выпущено обновление модуля Веб-мессенджер (im) 20.400.0. После установки данного обновления поддержка работы чатов без настроенного сервера очередей модуля Push and Pull будет прекращена.

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

Поэтому мы рекомендуем вам заранее настроить сервер очередей – облачный сервер «1С-Битрикс» или локальный Bitrix Push server 2.0.

В виртуальной машине ( BitrixVM версии 7.1 и выше Виртуальная машина сэкономит время и силы на правильное развертывание и администрирование сайта или внутреннего информационного ресурса на базе продуктов «1С-Битрикс».

Подробнее в курсе Виртуальная машина
) Push-сервер установлен по умолчанию.

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

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

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

Нажмите на рисунок, чтобы увеличить

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

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

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

Так как в скором времени будет отключена поддержка старых версий сервера очередей, то мы будем устанавливать сразу Bitrix Push server 2.0.

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

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

Update server

Обязательно перед обновлением сделайте резервное копирование вашей VMBitrix. Подробнее об обновлении виртуальной машины VMBitrix читайте в специальном курсе.

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

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

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

Nginx-PushStreamModule

Если тип сервера очередей будет NodeJS-PushServer, то можно переходить к шагу 3. Bitrix Push server 2.0 в продуктах «1С-Битрикс».

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

Install/Update NodeJS RTC service

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

NodeJS RTC Push&Pull

Проверить текущие выполняемые задачи можно с помощью меню 10. Background tasks in the pool > 1. View running tasks. Если по каким-либо причинам нужно посмотреть лог-файлы выполнения задач, то они находятся в директории /opt/webdir/temp.

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

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

Важно! Нажимать дополнительно на кнопку Сохранить не нужно!

Далее в опции Использовать "Push server": установленный локально выберите Виртуальная машина 7.3 и новее (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

Update NodeJS RTC Push&Pull

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

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

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

  Устаревшие версии

Внимание! Осенью 2021 года все старые версии модуля Push&Pull будут признаны устаревшими. Они будут убраны из виртуальной машины BitrixVM и не будут поддерживаться в продукте, например чатами.
Настоятельно рекомендуем перейти на актуальные версии BitrixVM.

Для устаревших виртуальных машин используйте информацию из спойлеров.

Работа модуля Push and Pull Битрикса на виртуальной машине до версии 5.0.

Настройка nginx-push-stream-module в версии 0.4.0

Настройка nginx-push-stream-module в версии 0.3.4

Как использовать модуль, подробно рассказано в курсе Разработчик Bitrix Framework в главе Push and Pull Модуль Push & Pull работает в двух режимах:

постоянное подключение к специальному серверу Сервер очередей;
в режиме опроса сервера (60-20-10).

Подробнее в курсе Разработчик Bitrix Framework
.



Курсы разработаны в компании «1С-Битрикс»
Спасибо, мы рады что смогли помочь Вам. Ниже Вы можете оставить свой отзыв или пожелание :)
Нам жаль это слышать… Но мы постараемся быть лучше! Поясните, пожалуйста, свой выбор:

Мы благодарны Вам за помощь в улучшении документации.

Мы стараемся сделать документацию понятнее и доступнее,
и Ваше мнение важно для нас