Установка на локальном сервере

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

Установка 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:

Подготовка к запуску 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

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

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