Документ описывает процесс установки Webitel на собственном сервере в on-site варианте развертывания.
Linux
Рекомендуем использовать Debian Jessie либо Ubuntu Server. Только 64bit! Ниже приведенная инструкция подходит, в первую очередь, этим двум дистрибутивам.
Установка docker
Самый простой способ установки - это использование скрипта:
# apt-get install curl # curl -sSL https://get.docker.com/ | sh # docker --version Docker version 1.12.1, build 6f9534c
Варианты установки на других дистрибутивах: https://docs.docker.com/engine/installation/
На 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 version 1.8.0, build f3628c7
Варианты установки на других дистрибутивах: https://docs.docker.com/compose/install/
Подготовка к запуску webitel
Для запуска Webitel Вам необходимо скачать подготовленные для docker-compose
файлы, внести свои правки и запустить.
Текущая стабильная версия Webitel 3.4.1
Получение файлов:
$ sudo gpasswd -a ${USER} docker $ cd /opt $ sudo mkdir /opt/webitel $ sudo git clone https://github.com/webitel/orchestration.git $ sudo chown -R ${USER}:docker /opt/webitel /opt/orchestration $ cd /opt/orchestration $ git tag -l v3.2.0 v3.2.1 v3.2.2 v3.3.0 v3.4.0 v3.4.1 $ git checkout v3.4.1
В результате, мы получили копию подготовленных скриптов для запуска и управления контейнерами Webitel.
Конфигурационные файлы
В директории /opt/orchestration/env поставляются файлы конфигурации с расширением *.example. Вам необходимо скопировать эти файлы без расширения. Самый простой способ - выполнить команду:
$ cd /opt/orchestration/env $ for f in *.example; do cp $f `basename $f .example`; done
Прежде, чем приступить к запуску, нам нужно изменить 2 значения в файле env/environment:
- WEBITEL_HOST - необходимо указать полное FQDN имя или скрипт попытается определить IP адрес вашего сервера webitel автоматически.
- WEBITEL_PASS - пароль для пользователя root.
Запуск Webitel
Имея готовый файл с описанием контейнеров, мы можем скачать образы c Docker Hub на сервер и создать контейнеры.
Основные команды:
Команда | Описание |
---|---|
dev | Запуск в режиме разработчика, когда открыты все порты всех контейнеров. |
fs | Запустить fs_cli для подключения к консоли FreeSWITCH |
backup | Выполняет резервное копирование базы данных и конфигурации webitel |
- | не указывая ничего, запускаем webitel |
Аргументы:
Аргумент | Описание |
---|---|
up | Создать либо пересоздать контейнеры. Для запуска контейнера в фоновом режиме, необходимо добавить ключ -d |
stop | Остановить контейнеры |
start | Запустить созданные раньше контейнеры |
rm | Удалить контейнеры |
pull | Скачать последнюю версию образов |
ps | Вывести список контейнеров и их состояние |
Запускаем webitel:
$ cd /opt/orchestration
./bin/bootstrap.sh pull ./bin/bootstrap.sh up -d
Проверяем, что все запустилось и работает:
./bin/bootstrap.sh ps
Наше приложение готово к работе.
Приложение | URL |
---|---|
Webitel WebClient | http://наш_домен/ |
WebSocket сервер и RESTFul API | http://наш_домен/engine/ |
WebRTC подключение | http://наш_домен/verto/ |
Kibana | http://наш_домен/kibana/ |
Документация по API | http://наш_домен/docs/ |
Теперь можем переходить к разделу Первичная настройка системы.