Инструкция по установке сервиса “Так короче”

Описание
Система «Так короче» представляет собой приложение, разработанное по микросервисной архитектуре. Компоненты включают в себя сервисы собственной разработки и программное обеспечение (ПО) с открытым исходным кодом. Клиентская часть ПО не устанавливается, поскольку ПО является облачным сервисом, доступ к которому осуществляется путем авторизации по учетной записи.
Требования
● Минимальные требования к аппаратному обеспечению:
○ 1 CPU
○ 2 RAM
○ 10GB HDD

● Операционная система Debian 11+, либо Ubuntu server 20+, либо Astra Linux. Инструкцию по установке можно найти на официальном сайтах:
Инструкция Debian 11+
Инструкция Astra Linux

● Установленные на сервере пакеты Docker и Docker Compose. Инструкцию по установке можно найти на официальном сайте:
Инструкция для Linux
Инструкция для Astra Linux

● Установленные и настроенные программы для авторизации OpenLDAP или MS LDAP. Инструкцию по установке и настройке можно найти на официальном сайтах:
Инструкция для OpenLDAP
Инструкция для MS LDAP
Шаги установки сервиса “Так короче”
Система «Так короче» поддерживает два вида авторизации:

1. OpenLDAP
2. MS LDAP
Установка для авторизации с OpenLDAP
  1. На целевом устройстве перейти в консоль, скачать и распаковать архив сервиса. Установить пакеты wget и unzip (если они не установлены) командами:

apt -y install wget unzip
Ввести команду скачивания и распаковки архива:

wget --user [login] --password [password]
https://demo.tak-koroche.ru/[архив] && sudo unzip [архив]
Доступы для скачивания архива — логин и пароль предоставляются после оплаты сервиса.
2. Перейти в каталог ./demo и импортировать образ сервиса backend_shortner.tar,
командами:

cd demo/
docker load -i backend_shortener.tar
docker load -i nginx.tar
docker load -i openldap.tar
docker load -i phpldapadmin.tar
docker load -i mysql.tar
3. Отредактировать файл конфигураций командой:

mv .env-openldap .env && nano .env
Ввести необходимые значения параметров OpenLDAP авторизации. Параметры
OpenLDAP и их описание представлены в Таблице 1.

Таблица 1

4. Запустить сервис командой:

docker-compose up -d
Необходимо дождаться запуска и инициализации всех сервисов. Ожидание
может быть в пределах 5 минут.
5. После запуска сервиса необходимо выполнить миграцию БД командой:

docker exec -it php-fpm php artisan migrate
6. Чтобы подключиться к сервису shortner, необходимо в браузере ввести IP адрес
сервера, где развернут сервис. Чтобы узнать IP адрес, можно выполнить команду:

ip a
7. Для авторизации необходимо создать пользователей в OpenLDAP.
Установка для авторизации с MS LDAP
  1. На целевом устройстве перейти в консоль скачать и распаковать архив сервиса. Установить пакеты wget и unzip (если они не установлены) командами:

apt -y install wget unzip
wget --user [login] --password [password] https://demo.tak-koroche.ru/[архив]
&& sudo unzip [архив]
Доступы для скачивания архива — логин и пароль предоставляются после оплаты сервиса.
2. Перейти в каталог ./demo и импортировать образ сервиса backend_shortner.tar,
командой:

cd demo/
docker load -i backend_shortener.tar
docker load -i nginx.tar
docker load -i mysql.tar
3. Отредактировать файл конфигураций командой:

mv .env-msldap .env && nano .env
Ввести необходимые значения параметров OpenLDAP авторизации. Параметры MS
LDAP и их описание представлены в Таблице 2.

Таблица 2

4. Запустить сервис командой:

docker-compose -f docker-compose-msldap.yml up -d
Необходимо дождаться запуска и инициализации всех сервисов. Ожидание может быть в пределах 5 минут.
5. После запуска сервиса необходимо выполнить миграцию БД следующей командой:

docker exec -it php-fpm php artisan migrate
6. Чтобы подключиться к сервису shortner, необходимо в браузере ввести IP адрес
сервера, где развернут сервис (чтобы узнать IP адрес, можно выполнить команду:

ip a
7. В случае возникновения сложностей с развёртыванием, просьба связаться с
Зильбергом Игорем Александровичем по почте info@tak-koroche.ru или по телефону
+7 919 680 2830.
ООО «Умная Голова»
г. Казань, Петербургская 50к5, офис 2Г
ИНН 1 655 193 147
КПП 165 501 001
ОГРН 1 101 690 027 207
Made on
Tilda