Рекомендуется устанавливать сервис Address Book на Ubuntu 20.04.

Для развертывания сервиса необходимо подключение к сети Internet. Для получения документации по развертыванию сервиса в закрытом контуре, запросите документацию в коммерческом отделе компании Eltex: eltex@eltex-co.ru.


При установке на виртуальную машину возможны проблемы с контейнером MongoDB из-за отсутствия инструкций процессора AVX.

Разворачивание docker-образа

Скачайте скрипт установки командой:

wget https://s3.eltex-co.ru/shared/address-book/ecss-address-book.sh

Выдайте права на исполнение:

chmod +x ecss-address-book.sh

Скачайте скрипт запуска окружения и файл с переменными:

./ecss-address-book.sh download


Если установка происходит удалённо по SSH, необходимо заново авторизоваться в терминале, так как пользователь был добавлен в группу docker, о чем будет получено уведомление:

Please, relogin in bash for access to docker group: 
$ su - user 
And repeat you command:

И повторить команду:

./ecss-address-book.sh download


При необходимости отредактируйте переменные, указав актуальную конфигурацию LDAP сервера:

Данный этап необязателен, если необходима лишь работа с персональными адресными книгами или планируется импортировать адресную книгу CSV-формата
<nano/vim/mcedit> address-book/stable/.env



Обязательный к изменению параметр: BEARER_TOKEN_PRIVATE_KEY — секретный ключ для генерации токена авторизации. По умолчанию стоит демонстрационное значение, которое важно поменять для обеспечения безопасности сервера. Значением может выступать любая комбинация символов >256 бит (примерно 32 символа). Значение данного параметра должно быть одинаковое в конфигурационном файле Chat Server и на сервисах User Status Service, Call History Service и Address Book Service.

Запустите установку приложения командой:

./ecss-address-book.sh prod install

В процессе установки будет необходимо авторизоваться во внешнем docker-регистре (данные авторизации вы можете уточнить в коммерческом отделе компании Eltex: eltex@eltex-co.ru):

Enter docker registry user: 
Enter docker registry password:


Также нужно проверить доступность сервера, выполнив GET-запрос на развёрнутый сервис.

curl http://<ecss-address-book>:4000/api/graphql/v1

Корректным ответом на данный запрос будет: 

{"errors":[{"message":"No query document supplied"}]}