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

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

Установка docker

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

# apt-get install curl
# curl -sSL https://get.docker.com/ | sh
# docker --version
Docker version 17.04.0-ce, build 4845c56

Варианты установки на других дистрибутивах: 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. Установка:

# curl -L "https://github.com/docker/compose/releases/download/1.11.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
# chmod +x /usr/local/bin/docker-compose
# docker-compose --version
docker-compose version 1.11.2, build dfed245

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

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

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

$ 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
v3.4.2
v3.5.0
v3.6.0

$ git checkout v3.6.0

В результате, мы получили копию подготовленных скриптов для запуска и управления контейнерами Webitel. 

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

В директории /opt/orchestration/env поставляются файлы конфигурации с расширением *.example. Вам необходимо скопировать эти файлы без расширения. Самый простой способ - выполнить команду:

$ cd /opt/orchestration/env
$ for f in *.example; do cp $f `basename $f .example`; done

Прежде, чем приступить к запуску, нам нужно изменить 2 значения в файле env/environment:

$ sudo echo "vm.max_map_count=262144" >> /etc/sysctl.conf
$ sudo sysctl -p

$ sudo cp /opt/orchestration/etc/cron.d/webitel /etc/cron.d/

Запуск Webitel

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

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

Аргументы:

Запускаем webitel:

$ cd /opt/orchestration

./bin/bootstrap.sh pull
./bin/bootstrap.sh up -d

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

./bin/bootstrap.sh ps

В статусе Exit 0 у вас должны быть только контейнер с Webitel Client (web-client)

Что бы перезапустить полностью все контейнеры webitel, используйте последовательность:

./bin/reboot.sh

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

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