View Source

Документ описывает процесс установки Webitel на собственном сервере в on-site варианте развертывания.

Рекомендуем использовать Debian Jessie либо Ubuntu Server. Только 64bit! Ниже приведенная инструкция подходит, в первую очередь, этим двум дистрибутивам.

Установка docker

Самый простой способ установки - это использование скрипта:

# curl -sSL https://get.docker.com/ | sh
# docker --version
Docker version 1.6.2, build 7c8fca2

На Ubuntu Вы можете получить сообщение:

WARNING: Your kernel does not support cgroup swap limit. WARNING: Your
kernel does not support swap limit capabilities. Limitation discarded.

Что бы это исправить, откройте файл /etc/default/grub и присвойте значение переменной GRUB_CMDLINE_LINUX:

GRUB_CMDLINE_LINUX="cgroup_enable=memory swapaccount=1"

Теперь Вы можете сохранить файл и обновить загрущик с помощью команды:

$ sudo update-grub

Установка docker-compose

Поскольку Webitel это комплекс из нескольких приложений, рекомендуем использовать docker-compose. Установка:

$ sudo apt-get update
$ sudo apt-get upgrade
$ sudo apt-get install python-pip
$ sudo pip install -U docker-compose
$ docker-compose --version
docker-compose 1.2.0

Основные команды docker-compose:

Команда	Описание
up	Создать либо пересоздать контейнеры. Для запуска контейнера в фоновом режиме, необходимо добавить ключ -d
stop	Остановить контейнеры
start	Запустить созданные раньше контейнеры
rm	Удалить контейнеры
pull	Скачать последнюю версию образов
ps	Вывести список контейнеров и их состояние
logs	Отобразить вывод логов из контейнеров

Подготовка к запуску webitel

Для запуска Webitel Вам необходимо скачать подготовленные для docker-compose файлы, внести свои правки и запустить. Будим производить в /opt/webitel.

Получение файлов:

$ sudo apt-get install git
$ cd /opt
$ git clone http://stash.webitel.com/scm/wp/compose.git webitel

В склонированном репозитории находится файл docker-compose.yml, который описывает параметры для создания контейнеров, а так же три *.env файла с переменными для контейнеров.

Конфигурационные файлы

Поскольку установка производиться на одном сервере, во всех переменных с IP адресами, необходимо указывать IPv4 адрес Вашего сервера.

common.env

В файле находятся общие переменные для контейнеров:

SSL - включить поддержку SSL. Cтавим false.
TOKEN_KEY - ключ для создания токенов
CONSOLE_PASSWORD - пароль пользователя root. По умолчанию, используется слово ROOT_PASSWORD.
LOGLEVEL - уровень вывода логов. Возможные варианты: trace, debug, warn, error, info. По умолчанию, warn.
LOGSTASH_ENABLE и LOGSTASH_HOST - Для использования logstash сервера сбора логов.
FS_HOST - IP, на котором запущен FreeSWITCH.
CONSOLE_HOST - IP, на котором запущен Webitel Console.
MONGODB_HOST - IP, на котором запущена база MongoDB.
CDR_HTTP - Протокол подключения к серверу статистики. По умолчанию, http.
CDR_SERVER - IP либо имя хоста, а так же порт подключения к серверу статистики.

cdr.env

В файле находятся переменные для контейнера сервера статистики и медиафайлов:

STORAGE_TRANSPORT - Какой транспорт использовать для хранения файлов: s3 либо file. По умолчанию, file.
STORAGE_ROOT - Для файлового хранилища - путь к файлам, для S3 хранилища - название корзины. По умолчанию, recordings.
S3KEYID, S3KEYSECRET и S3_REGION - Параметры подключения к Amazon S3 хранилищу.
ACL_UPLOAD - С каких IP разрешить загрузку записей разговоров на сервер. Можно указать только IP адрес, FreeSWITCH. По умолчанию, разрешено с любых IP - 0.0.0.0/0.

freeswitch.env

В файле находятся переменные для контейнера с FreeSWITCH:

CDR_SERVER - IP либо имя хоста, а так же порт подключения к серверу статистики и записей разговоров.
ACR_SERVER - IP либо имя хоста, а так же порт подключения к серверу маршрутизации.
CONF_SERVER - IP либо имя хоста, а так же порт подключения к серверу Webitel Console для получения XML конфигурации.

Запуск Webitel

Имея готовый файл с описанием контейнеров, мы можем скачать образы Docker на сервер и создать контейнеры.

Скачиваем нужные нам образы:

$ cd /opt/webitel
$ sudo docker-compose pull

Создаем контейнеры:

$ sudo docker-compose up -d

Проверяем, что все запустилось и работает:

$ sudo docker-compose ps

Наше приложение готово к работе.

Теперь можем переходить к разделу Первичная настройка системы.