====== Установка Коннекторов ======

Установка программного модуля Коннектор на ОС Ubuntu Linux. \\
Подразумевается, что система устанавливается на "чистую" ОС.


===== Установка Docker =====

** Обновление репозитория apt **
<code>
sudo apt-get update
</code>


** Установка требуемых системных пакетов **
<code>
sudo apt-get install \
apt-transport-https \
ca-certificates \
curl \
gnupg-agent \
software-properties-common
</code>

** Получение ключа репозитория docker **
<code>
curl -fsSL https://download.docker.com/linux/ubuntu/gpg | sudo apt-key add –
</code>

** Добавление репозитория docker **
<code>
sudo add-apt-repository \
"deb [arch=amd64] https://download.docker.com/linux/ubuntu \
$(lsb_release -cs) \
stable"
</code>

** Обновление репозитория apt **
<code>
sudo apt-get update
</code>

===== Установка Docker-compose =====

** Скачивание docker-compose **
<code>
sudo curl -L "https://github.com/docker/compose/releases/download/1.27.4/docker-compose-$(uname -s)- $(uname -m)" -o /usr/local/bin/docker-compose
</code>

** Назначить файл исполняемым **
<code>
sudo chmod +x /usr/local/bin/docker-compose
</code>

** Настройка прав пользователю запускать docker от своего имени **
<code>
sudo usermod -aG docker $USER
</code>
Где $USER – имя пользователя, под которым планируется администрирование системы.


===== Установка и настройка Коннекторов =====

Распакуйте содержимое архива с Программным Обеспечением в каталог /opt/diflow

** Для установки системы скопируйте файлы системы с репозитория **
<code>
sudo git clone -b release-1.1 https://{git_username}@dl-git.distate.ru/diflow-connectors.git/ /opt/connector/
</code>
Где {git_username} – имя пользователя для подключения к репозиторию. 

** Измените владельца директории с проектом на пользователя **
<code>
sudo chown -R $USER:users /opt/connector
</code>
Где $USER – имя пользователя, под которым планируется администрирование системы.

** Перейдите в директорию с проектом **
<code>
cd /opt/connector
</code>

** С помощью копирования создайте конфигурационные файлы системы: **
<code>
cp docker-compose.yml.prod.dist docker-compose.yml
cp docker-compose_resources.yml.dist docker-compose_resources.yml
</code>

<note important>
Внимание!!! \\
Перед дальнейшем продолжением установки необходимо сконфигурировать и проверить сервис подписи. \\
Инструкция: [[dsigner_es_install|Установка Электронной Подписи в сервис подписи.]]
</note>

** Развернуть ресурсы **
<code>
docker-compose -f docker-compose_resources.yml up -d
</code>

** Выполнить миграцию **
<code>
./migrate_up.sh
</code>

** Создать конфигурационный файл и прописать в нем нужные значения **
<code>
cp resources/conf.yaml.dist resources/conf.yaml
</code>

** Собрать и запустить сервис коннектора **
<code>
docker-compose -f docker-compose.yml up --build -d connector
</code>

===== Проверка работоспособности системы =====

Вывод команды
<code>
docker ps
</code>
Показывает следующие запущенные контейнеры:
  * diflow-connectors_connector_1
  * connector-db
  * connector-dsigner
  * rabbitmq