Рекомендуется устанавливать сервис 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"}]}