Алгоритм развертывания Media Proxy

Установите на свой компьютер Docker Desktop, Docker Compose и Docker EngineУстановите на свой компьютер Docker Desktop, Docker Compose и Docker Engine

Docker разработан в виде модульной архитектуры, поэтому если вы установили Docker Desktop для Windows или Mac, то у вас уже есть Docker Compose и Docker Engine.

Если вы используете компьютер Linux, необходимо отдельно установить Docker Engine и Docker Compose. Далее рассмотрим установку под Linux Ubuntu 21.10.

$ sudo apt-get remove docker docker-engine docker.io containerd runc
        

$ sudo apt-get update
        

$ sudo apt-get install
        ca-certificates
        curl
        gnupg
        lsb-release
        

$ curl -fsSL https://download.docker.com/linux/ubuntu/gpg
         | sudo gpg
        --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
        

$ echo
        "deb [arch=$(dpkg --print-architecture)
        signed-by=/usr/share/keyrings/docker-archive-keyring.gpg]
        https://download.docker.com/linux/ubuntu
        
        $(lsb_release -cs) stable" | sudo tee
        /etc/apt/sources.list.d/docker.list > /dev/null
        

$ sudo apt-get update
        

$ sudo apt-get install docker-ce docker-ce-cli containerd.io
        

$ sudo docker run hello-world
        

$ DOCKER_CONFIG=${DOCKER_CONFIG:-$HOME/.docker}
        $ mkdir -p $DOCKER_CONFIG/cli-plugins
        $ curl -SL https://github.com/docker/compose/releases/download/v2.2.3/docker-compose-linux-x86_64
         -o $DOCKER_CONFIG/cli-plugins/docker-compose
        

$ chmod +x $DOCKER_CONFIG/cli-plugins/docker-compose
        

$ docker compose version
        

$ sudo apt-get update
        $ sudo apt install ./docker-desktop-amd64.deb
        

Авторизуйтесь в Docker Registry MANGO OFFICEАвторизуйтесь в Docker Registry MANGO OFFICE

Для этого используйте команды авторизации:

Для терминала Linux

sudo docker login -u '<уникальный ключ авторизации>' -p 'media-proxy' registry-vbpx.mango-office.ru
        

Для Windows Powershell

'media-proxy' | docker login -u '<уникальный ключ авторизации>' --password-stdin registry-vbpx.mango-office.ru
        

Где «уникальный ключ авторизации» - комбинация символов, скопировать которую можно на вкладке Внешний Media Proxy Личном кабинете ВАТС.

Перед авторизацией необходимо проверить сетевую доступность командой:

PS: tnc registry-vbpx.mango-office.ru -p 443
        

Скачайте и заполните docker-environment.txt:Скачайте и заполните docker-environment.txt:

Чтобы скачать docker-enviroment.txt, в Личном кабинете пользователя ВАТС последовательно перейдите на Общие настройки → Настройка SIP → Внешний Media Proxy. На открывшейся вкладке нажмите на кнопку Скачать шаблон для переменных окружения.

Заполните docker-environment.txt по инструкции и сохраните заполненный файл в каталог, как показано на скриншоте.

Если вы скопировали файл на внешний носитель (например флешку), то для сохранения его в каталог на сервер в командной строке приложения Терминал введите:

$ sudo cd /путь/к/каталогу/на/флешке
        $ sudo cp docker_environment.txt /opt/mediaproxy/
        

где /opt/mediaproxy/ - каталог на сервере, куда сохраняется файл.

Создайте на сервере каталоги для записей дампов голосового трафикаСоздайте на сервере каталоги для записей дампов голосового трафика

(в приведенном ниже скриншоте это record и alt_record)

Чтобы создать каталог, откройте приложение Терминал. Для приведенного выше скриншота в командной строке вводится:

$ sudo mkdir -p /opt/mediaproxy/mp1/tmp/record/
        $ sudo mkdir -p /opt/mediaproxy/mp1/tmp/alt_record/
        

Предоставьте для этих каталогов полные праваПредоставьте для этих каталогов полные права

Для корректной работы сервисов, директории для записей разговоров должны иметь полные права доступа (чтение/запись/выполнение) (rwx-rwx-rwx).

Далее в командной строке введите:

$ sudo chmod -R 777 название_папки_для_которой_предоставляются_права
        

Например, для приведенного выше скриншота в командной строке вводится:

$ sudo cd /opt/mediaproxy/mp1/tmp
        $ sudo chmod -R 777 record
        $ sudo chmod -R 777 alt_record
        

Скачайте и сохраните в каталог файл docker-compose.ymlСкачайте и сохраните в каталог файл docker-compose.yml

Файл предоставляется пользователю вместе с пользовательской документацией. Предназначен для предварительной настройки и запуска клиентского Media Proxy. Docker-compose позволяет управлять группами контейнеров, создавать их, настраивать, а также удалять одной командой.

Чтобы скачать docker-compose.yml в Личном кабинете пользователя ВАТС последовательно перейдите на Общие настройки → Настройка SIP → Внешний Media Proxy. На открывшейся вкладке нажмите на кнопку Скачать скрипт запуска Media Proxy.

Сохраните файл в каталог, как показано на скриншоте.

Если вы скопировали файл на внешний носитель (например флешку), то для сохранения его в каталог на сервер в командной строке введите:

$ sudo cd /путь/к/каталогу/на/флешке
        $ sudo cp docker-compose.yml /opt/mediaproxy/
        

где /opt/mediaproxy/ - каталог на сервере, куда сохраняется файл.

Запустите Docker_composeЗапустите Docker_compose

Чтобы запустить docker_compose (для приведенного выше скриншота) в командной строке вводится:

$ cd /opt/mediaproxy
        $ sudo docker-compose --env-file=docker_environment.txt up -d
        

После запуска Docker-compose в свою очередь самостоятельно скачивает images из репозитория Mango и запускает четыре контейнера:

• Mediaproxy - отвечает за отправку медиа трафика, получение медиа трафика, проигрывание медиа контента, детектирование dtmf, запись разговоров и т.д.
• Openresty - отвечает за доступ к записям разговора (используется сервисом распознавания речи и категоризации).
• Autoheal - отслеживает и перезапускает неработоспособные контейнеры (контейнеры, находящиеся в состоянии unhealthy).
• Watchtower - обновляет работающую версию контейнерного приложения.

Совершайте звонкиСовершайте звонки

Чтобы проверить корректность работы функционала в Личном кабинете пользователя ВАТС последовательно перейдите на Общие настройки → Настройка SIP → Учетные записи и домены SIP. На открывшейся вкладке выберите учетную запись пользователя, для который активна настройка SIP2SIP в сети клиента. Залогиньтесь под этой учетной записью в вашей внутренней рабочей сети в Контакт-центре MANGO OFFICE или MANGO Talker и совершите тестовый звонок на внешний номер телефона (например, на любой городской номер).

Если произошло соединение и есть слышимость – функционал настроен корректно, а голосовой трафик звонков проходит через MediaProxy внутри сети вашей организации.