Установка и запуск ПО

Рекомендации по аппаратному обеспечению


  • 64-разрядный процессор с поддержкой SLAT и Hyper-V

Поддерживает ли ваш процессор технологию виртуализации Intel можно узнать по ссылке https://www.intel.ru/content/www/ru/ru/support/articles/000005486/processors.html

  • Если Linux: Kernel не старее 3.10
  • Если Windows: Windows с поддержкой WSL2
  • 8 GB RAM
  • 100 GB HDD

Общая информация

Link может поставляться:

  • в нескольких Docker контейнерах и разворачиваться с помощью docker-compose
  • в образе виртуальной машины Virtualbox

ПО имеет 2 версии:

  • Бесплатная базовая версия
  • Расширенная версия - отличается от базовой поддержкой SIP телефонии. Для получения триал-лицензии или приобретения обратитесь в отдел продаж.

Для установки расширенной версии ПО рекомендуется использование Linux системы.

Установка Link под Linux с использованием Docker


  1. Установить Docker для своего дистрибутива. В примере ниже используется установка для Ubuntu.

    # Удалить старые версии
    
    sudo apt-get remove docker docker-engine docker.io containerd runc
    
    # Выполнить настройку репозитория
    ## Выполнить обновление индекса apt и установить зависимости
    
    sudo apt-get update
    
    sudo apt-get install \
        apt-transport-https \
        ca-certificates \
        curl \
        gnupg \
        lsb-release
    
    ## Добавить GPG ключ Docker
    
    curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo gpg --dearmor -o /usr/share/keyrings/docker-archive-keyring.gpg
    
    ## Добавить репозиторий
    
    echo \
      "deb [arch=amd64 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
    
    
    # Установить Docker
    
    sudo apt-get update
    
    sudo apt-get install docker-ce docker-ce-cli containerd.io
  2. Установить docker-compose для своего дистрибутива.

    # Скачать docker-compose
    
    sudo curl -L "https://github.com/docker/compose/releases/download/1.29.2/docker-compose-$(uname -s)-$(uname -m)" -o /usr/local/bin/docker-compose
    
    # Дать права выполнения для файла
    
    sudo chmod +x /usr/local/bin/docker-compose
    
    # Добавить симлинк
    
    sudo ln -s /usr/local/bin/docker-compose /usr/bin/docker-compose
  3. Склонировать проект из репозитория.

    git clone https://github.com/basip/link.git


    Проект включает:

    1. docker-compose.yml базовой версии
      1. без http прокси
      2. с http прокси
    2. docker-compose.yml расширенной версии
      1. без http прокси
      2. с http прокси
    3. Выполнить настройки частей приложения, если требуется.
      • Для всех конфигураций возможно изменить:
        • внешние порты приложений
        • пароль БД приложения
        • пароль БД SIP прокси
      • Для конфигураций с http прокси необходимо изменить:
        • значение переменной HTTPS_DOMAIN в .env файле на используемое доменное имя
        • значение HTTPS_MODE на production. Значение staging может использоваться для тестов получения сертификата letsencrypt, подробней в документации
  4. Для расширенной версии создать требуемые docker volumes

    docker volume create --name=app-data
    docker volume create --name=app-storage
    docker volume create --name=system-logs
    docker volume create --name=broker-data
  5. Для версии с прокси создать требуемый docker volume:

    docker volume create --name=app-ssl-certs
  6. Запустить проект.

    docker-compose up -d

После успешного запуска проекта приложение будет доступно на 80/443 порту IP адреса вашего сервера, в зависимости от выбранной версии проекта. 

Обновление ПО

Детали обновления некоторых версий также доступны в репозитории.

  1. Авторизоваться в консоли сервера от имени root пользователя.

    sudo su
  2. Перейти в директорию с docker-compose.yml Link.
    Для Link без телефонии:

    cd link/without-sip

    Для Link с телефонией:

    cd link/with-sip
  3. Остановить контейнеры.

    docker-compose down
  4. Обновить образы.

    docker-compose pull
  5. Запустить Link.

    docker-compose up -d

Удаление ПО

Для удаления LINK с вашего ПК выполните следующие команды в консоли:

  1. docker-compose down
  2. docker system prune - команда удалит все неиспользуемые контейнеры, сети, образы и дисковые пространства безвозвратно