Развертывание сервиса синхронизации почты через Docker

Подготовка к развертыванию

Перед установкой сервиса синхронизации почты выполните следующее:

1. Для предоставления доступа к архиву с файлами для развертывания обратитесь в Техническую поддержку BPMSoft.
2. Перед установкой убедитесь в том, что среда, на которую вы хотите устанавливать сервис, соответствует системным требованиям.
3. Для работы установите Docker Desktop версии 4.3.0 и выше.
4. Если необходима синхронизация активностей и контактов с MS Exchange, то при развертывании BPMSoft нужно установить пакет gss-ntlmssp. Подробнее: Настройка сервера системы на Linux.

Развертывание сервиса синхронизации почты

Для запуска сервиса необходимо:

1. На компьютере с Linux или в WSL2 (для Windows) создайте папку для файлов Docker Compose, связанных с сервисом синхронизации почты.

sudo mkdir /usr/el

2. Переместите файл docker-compose в домашнюю директорию пользователя (~), используя Linux или WSL2 (для Windows).
3. Скопируйте и разархивируйте файлы docker-compose в созданную директорию. Замените на соответствующую версию релиза.

sudo cp ~/el--docker.zip /usr/el && cd /usr/el && sudo unzip el--docker.zip

4. Откройте папку src, где хранятся файлы docker-compose.

cd src

5. Для запуска инфраструктуры сервиса синхронизации почты выполните следующую команду:

sudo docker compose -f docker-compose.infr.yaml up -d

6. Перед запуском компонент сервиса синхронизации почты проверьте и, при необходимости, настройте переменные окружения в файле .env:
• DOCKER_TAG указывает версию ExchangeListener;
• DOCKER_REPO определяет репозиторий, откуда Docker будет скачивать образы сервисов ExchangeListener. По умолчанию используется bpmsoft на docker.io (т. е. DOCKER_REPO=bpmsoft). Измените это значение, если используете собственный прокси-репозиторий в закрытых сетях без доступа в сеть Интернет, например: DOCKER_REPO=bpmsoft-docker-repo.company.ru/bpmsoft/el.

7. Установите сервис:

docker compose up -d

Проверка состояния сервиса после развертывания

Для первичной проверки работоспособности сервиса после развертывания необходимо выполнить следующие шаги:

1. Проверить доступность развернутых docker-контейнеров (должны находиться в статусе "Up") с помощью команды:

docker ps -a --filter "name=listener"

2. С помощью команды "docker logs" проверить логи экземпляра компонента EL API на предмет отсутствия в них ошибок с помощью команды:

docker logs

3. С сервера приложения BPMSoft выполнить запрос для проверки доступности сервиса синхронизации почты:

curl {адрес_сервиса}:{порт}/api/listeners/status -v

где:

• {адрес_сервиса} — URL-адрес развернутого сервиса;
• {порт} — порт, который использовался при развертывании сервиса.

Настройка на стороне BPMSoft

Для настройки сервиса в приложении BPMSoft необходимо установить корректные значения системных настроек в дизайнере системы:

Таблица 1 — Изменяемые системные настройки

Порты почтового сервера

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

Таблица 2 — Порты почтового сервера

Рекомендуем изучить

Сервис синхронизации почты
Диагностика сервиса синхронизации почты
Общие принципы работы c email-сообщениями
Настройка почтового ящика