UPS. Руководство администратора - История изменений

KorolkovS в 07:24, 12 февраля 2026

2026-02-12T07:24:06Z

← Предыдущая версия		Версия от 10:24, 12 февраля 2026
Строка 39:		Строка 39:

	Разрешите доступ к порту 6182 на нужном интерфейсе по протоколу TCP.		Разрешите доступ к порту 6182 на нужном интерфейсе по протоколу TCP.

			Параметры авторизации по умолчанию: логин: admin, пароль: password

	UPS может работать в составе кластера из двух и более серверов с UPS. Для этого необходимо создать кластер pacemaker/corosync с 2 ресурсами — ресурс systemd UPS и shared IP, и обеспечить их одновременную работу на одной ноде кластера. Синхронизацию изменений обеспечит сервис UPS с помощью lsyncd, для этого есть блок «cluster» в конфигурационном файле. Серверы кластера для этого должны иметь возможность соединения по SSH по ключу.		UPS может работать в составе кластера из двух и более серверов с UPS. Для этого необходимо создать кластер pacemaker/corosync с 2 ресурсами — ресурс systemd UPS и shared IP, и обеспечить их одновременную работу на одной ноде кластера. Синхронизацию изменений обеспечит сервис UPS с помощью lsyncd, для этого есть блок «cluster» в конфигурационном файле. Серверы кластера для этого должны иметь возможность соединения по SSH по ключу.

V.Kazantsev: /* Конфигурирование параметров сервиса */

2025-03-27T06:53:10Z

Конфигурирование параметров сервиса

← Предыдущая версия		Версия от 09:53, 27 марта 2025
Строка 252:		Строка 252:
	\|servers.res.cluster		\|servers.res.cluster
	\|"<nowiki>http://192.168.20.246:5601</nowiki>"		\|"<nowiki>http://192.168.20.246:5601</nowiki>"
	\|http адрес Kibana с отчетами. Для доступа к отчетам по http адресу UPS, и для проксирования на порт 5602 кибаны для ssl UPS		\|[https://wiki.connect2ai.net/index.php/RES._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_kibana_+_elasticsearch http адрес Kibana с отчетами.] Для доступа к отчетам по http адресу UPS, и для проксирования на порт 5602 кибаны для ssl UPS
	\|-		\|-
	\|servers.res.auth.username		\|servers.res.auth.username

V.Kazantsev: /* Конфигурирование параметров сервиса */

2025-03-27T06:51:53Z

Конфигурирование параметров сервиса

← Предыдущая версия		Версия от 09:51, 27 марта 2025
Строка 249:		Строка 249:
	\|"127.0.0.1:6191"		\|"127.0.0.1:6191"
	\|Все адреса, в том числе и с SSL (wss), по которым доступен websocket-сервер ses.		\|Все адреса, в том числе и с SSL (wss), по которым доступен websocket-сервер ses.
			\|-
			\|servers.res.cluster
			\|"<nowiki>http://192.168.20.246:5601</nowiki>"
			\|http адрес Kibana с отчетами. Для доступа к отчетам по http адресу UPS, и для проксирования на порт 5602 кибаны для ssl UPS
	\|-		\|-
	\|servers.res.auth.username		\|servers.res.auth.username

V.Kazantsev: /* Конфигурирование параметров сервиса */

2025-03-27T06:35:14Z

Конфигурирование параметров сервиса

← Предыдущая версия		Версия от 09:35, 27 марта 2025
Строка 249:		Строка 249:
	\|"127.0.0.1:6191"		\|"127.0.0.1:6191"
	\|Все адреса, в том числе и с SSL (wss), по которым доступен websocket-сервер ses.		\|Все адреса, в том числе и с SSL (wss), по которым доступен websocket-сервер ses.
			\|-
			\|servers.res.auth.username
			servers.res.auth.password
			\|"reports"
			"reports"
			\|Логин и пароль [https://wiki.connect2ai.net/index.php/RES._%D0%A0%D1%83%D0%BA%D0%BE%D0%B2%D0%BE%D0%B4%D1%81%D1%82%D0%B2%D0%BE_%D0%B0%D0%B4%D0%BC%D0%B8%D0%BD%D0%B8%D1%81%D1%82%D1%80%D0%B0%D1%82%D0%BE%D1%80%D0%B0#%D0%A3%D1%81%D1%82%D0%B0%D0%BD%D0%BE%D0%B2%D0%BA%D0%B0_%D0%B8_%D0%BD%D0%B0%D1%81%D1%82%D1%80%D0%BE%D0%B9%D0%BA%D0%B0_kibana_+_elasticsearch пользователя kibana] с правами доступа на просмотр рабочих столов с отчетами
	\|-		\|-
	\|cluster.logfile		\|cluster.logfile

E.Elagina: /* Общее описание */

2025-02-20T11:44:16Z

Общее описание

Внесённые изменения

V.Kazantsev: /* Конфигурирование параметров сервиса */

2025-02-17T14:52:30Z

Конфигурирование параметров сервиса

@@ Строка 247: / Строка 247: @@
 |3
 |Лимит времени на получение информации о модели
 |-
 |cluster.logfile
@@ Строка 265: / Строка 269: @@
 |-
 |nouserlog
-|[ "POST:/auth/userlog" ]
+|[
 |Исключения из правила логирования действий пользователей
 |-

E.Elagina: /* Часто задаваемые вопросы */

2025-02-07T11:21:56Z

Часто задаваемые вопросы

← Предыдущая версия		Версия от 14:21, 7 февраля 2025
Строка 319:		Строка 319:
	===== '''Удаление UPS''' =====		===== '''Удаление UPS''' =====
	Для удаления выполните команду: <code>/opt/ups/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.		Для удаления выполните команду: <code>/opt/ups/uninstall</code>. Команда деинсталлирует сервис и удалит рабочий каталог, включая все установленные модели.


	~~===== '''Часто задаваемые вопросы''' =====~~
	~~{\| class="wikitable"~~
	\|+
	~~!Вопрос~~
	~~!Ответ~~
	\|-
	\|
	\|
	\|-
	\|
	\|
	\|-
	\|
	\|
	\|}

V.Kazantsev: /* Конфигурирование параметров сервиса */

2024-11-20T13:52:13Z

Конфигурирование параметров сервиса

← Предыдущая версия		Версия от 16:52, 20 ноября 2024
Строка 218:		Строка 218:
	\|servers.{service}.trainer		\|servers.{service}.trainer
	\|<nowiki>http://127.0.0.1:PORT</nowiki>		\|<nowiki>http://127.0.0.1:PORT</nowiki>
	\|Ссылка на сервер для обучения моделей сервисов. Возможные варианты значения service (с портами по умолчанию) следующие: smc (6181), see (6184), spr (6183)		\|Ссылка на сервер для обучения моделей сервисов. Возможные варианты значения service (с портами по умолчанию) следующие: smc (6181), see (6184), spr (6183), qas(6187), res(6156), ses(6190)
	\|-		\|-
	\|servers.{service}.cluster		\|servers.{service}.cluster
	\|<nowiki>[http://127.0.0.1:PORT]</nowiki>		\|<nowiki>[http://127.0.0.1:PORT]</nowiki>
	\|Список ссылок на рабочие серверы сервисов. Возможные варианты значения service (с портами по умолчанию) следующие: smc (6181), see (6184), spr (6183), tts (6186), sbs (6185).		\|Список ссылок на рабочие серверы сервисов. Возможные варианты значения service (с портами по умолчанию) следующие: smc (6181), see (6184), spr (6183), qas(6187), tts (6186), sbs (6185), ses(6190).
			\|-
			\|servers.res.cluster
			\|"<nowiki>https://0.0.0.0:6157</nowiki>
			\|Ссылка на сервис kibana, подключенный через раверс-прокси на nginx(входит в состав res)
	\|-		\|-
	\|servers.{service}.timers.connect		\|servers.{service}.timers.connect
Строка 255:		Строка 259:
	\|[ ]		\|[ ]
	\|Перечень нод кластера UPS на которые будет отправляться содержимое папки "data"		\|Перечень нод кластера UPS на которые будет отправляться содержимое папки "data"
			\|-
			\|userlog
			\|[ "POST:", "DELETE:" ]
			\|Типы действий пользователей которые будут логироваться
			\|-
			\|nouserlog
			\|[ "POST:/auth/userlog" ]
			\|Исключения из правила логирования действий пользователей
	\|-		\|-
	\|nopassword		\|nopassword

Ka.shapovalov в 10:17, 21 октября 2024

2024-10-21T10:17:51Z

Внесённые изменения

E.Elagina: /* Установка/обновление UPS */

2024-10-21T08:32:56Z

Установка/обновление UPS

← Предыдущая версия		Версия от 11:32, 21 октября 2024
Строка 5:		Строка 5:

	===== '''Термины и определения''' =====		===== '''Термины и определения''' =====
	Universal Proxy Server (UPS) – ~~Сервис~~ управления ядром с проксированием запросов.		Universal Proxy Server (UPS) – сервис управления ядром с проксированием запросов.


	===== '''Системные требования''' =====		===== '''Системные требования''' =====
	Для нормальной работы сервиса требуется ~~4Гб~~ оперативной памяти, 1 CPU >= 2.~~20GHz~~ и ~~40Гб~~ дискового пространства.		Для нормальной работы сервиса требуется 4 Гб оперативной памяти, 1 CPU >= 2.20 GHz и 40 Гб дискового пространства.


Строка 19:		Строка 19:
	* Установка/обновление UPS осуществляется скриптом <code>chmod +x ./ups-<версия>-<релиз>.sh && ./ups-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./ups-<версия>-<релиз>.sh</code> без ключей.		* Установка/обновление UPS осуществляется скриптом <code>chmod +x ./ups-<версия>-<релиз>.sh && ./ups-<версия>-<релиз>.sh -i</code> с правами администратора. Список всех ключей инсталлятора можно посмотреть, запустив инсталлятор <code>./ups-<версия>-<релиз>.sh</code> без ключей.
	* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/ups/new</nowiki>" --user '[user]:[pass]' 2>&1 \| bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/ups</nowiki> --user '[user]:[pass]' 2>&1)"</code>.		* Загрузить последнюю версию продукта <code>curl -s "<nowiki>https://repo.connect2ai.net/api/ups/new</nowiki>" --user '[user]:[pass]' 2>&1 \| bash</code> или в интерактивном режиме <code>bash -c "$(curl -s <nowiki>https://repo.connect2ai.net/api/ups</nowiki> --user '[user]:[pass]' 2>&1)"</code>.
	* Обновить UPS <code>/opt/ups/inupdate</code> в интерактивном режиме. Или запустить с ~~ключём~~:		* Обновить UPS <code>/opt/ups/inupdate</code> в интерактивном режиме. Или запустить с ключом:
	** <code>/opt/ups/inupdate -b</code> - обновить до последней beta версии;		** <code>/opt/ups/inupdate -b</code> - обновить до последней beta версии;
	** <code>/opt/ups/inupdate -r</code> - обновить до последней release версии;		** <code>/opt/ups/inupdate -r</code> - обновить до последней release версии;
Строка 28:		Строка 28:
	* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):		* В папке с продуктом можно добавить 2 файла конфигурации (допускается один общий файл на все продукты в папке с окружением /opt/pve/):
	** echo -n <code>"[user]:[pass]"</code> > /opt/ups/.userapi (это файл авторизации в API, нужен для обновления)		** echo -n <code>"[user]:[pass]"</code> > /opt/ups/.userapi (это файл авторизации в API, нужен для обновления)
	** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/ups/.proxy (это файл конфигурации proxy необходим для обновления, при ~~отсутсвующем~~ прямом ~~подключение~~ к интернету)		** echo -n <code>"<nowiki>http://example.com:3128</nowiki> [user] [password]"</code> > /opt/ups/.proxy (это файл конфигурации proxy, необходим для обновления при отсутствующем прямом подключении к интернету).

	При ~~обновление~~ следующий список файлов и папок ~~сохранияется~~: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.		При обновлении следующий список файлов и папок сохраняется: .userapi, .proxy, logs, nnets, config.json, cache, pretrained, pve, data. Сервис не требует остановки и возвращается в актуальное состояние после обновления.

	Не забудьте запустить сервис и включить в автозапуск в системе:		Не забудьте запустить сервис и включить в автозапуск в системе:
Строка 39:		Строка 39:

	<code>systemctl status ups.service</code>		<code>systemctl status ups.service</code>
	Разрешите доступ к порту 6182 на нужном интерфейсе по протоколу ~~tcp~~.
	UPS может работать в составе кластера из двух и более серверов с UPS. Для этого необходимо создать кластер pacemaker/corosync с 2 ресурсами - ресурс systemd UPS и shared IP, и обеспечить их одновременную работу на одной ноде кластера. Синхронизацию изменений обеспечит сервис UPS с помощью lsyncd, для этого есть блок ~~"cluster"~~ в конфигурационном файле. Серверы кластера для этого должны иметь возможность соединения по ~~ssh~~ по ключу.		Разрешите доступ к порту 6182 на нужном интерфейсе по протоколу TCP.

			UPS может работать в составе кластера из двух и более серверов с UPS. Для этого необходимо создать кластер pacemaker/corosync с 2 ресурсами — ресурс systemd UPS и shared IP, и обеспечить их одновременную работу на одной ноде кластера. Синхронизацию изменений обеспечит сервис UPS с помощью lsyncd, для этого есть блок «cluster» в конфигурационном файле. Серверы кластера для этого должны иметь возможность соединения по SSH по ключу.



	====='''Внутренняя база данных'''=====		====='''Внутренняя база данных'''=====
	В каталоге '''/opt/ups/data/db''' находятся папки служебной базы данных. Папки созданы по разделам администрирования UPS. Каждый файл любой папки описывает один объект администрирования, например один из файлов из каталога '''"/opt/ups/data/db/roles"'''		В каталоге '''/opt/ups/data/db''' находятся папки служебной базы данных. Папки созданы по разделам администрирования UPS. Каждый файл любой папки описывает один объект администрирования, например один из файлов из каталога '''"/opt/ups/data/db/roles".'''
	{		{
	"id": "ee1b3b1edb8c4376486189d6540f5635",		"id": "ee1b3b1edb8c4376486189d6540f5635",
Строка 86:		Строка 89:

	====='''Авторизация в UPS'''=====		====='''Авторизация в UPS'''=====
	UPS предполагает доступ по паролю к разделам интерфейса и информации от сервисов. Доступ осуществляется при помощи токена доступа. Токен запрашивается запросом в котором передаются логин и пароль, а в ответ приходит токен авторизации и токен обновления авторизации. ~~Пример запроса:~~		UPS предполагает доступ по паролю к разделам интерфейса и информации от сервисов. Доступ осуществляется при помощи токена доступа. Токен запрашивается запросом, в котором передаются логин и пароль, а в ответ приходит токен авторизации и токен обновления авторизации.

	~~curl -X POST "http://127.0.0.1:6182/auth/access?username=admin&password=password" -H "accept: application/json"~~

	~~пример~~ ответа:		Пример запроса:
			curl -X POST "http://127.0.0.1:6182/auth/access?username=admin&password=password" -H "accept: application/json"
			Пример ответа:

	{		{
Строка 97:		Строка 100:
	}		}

	~~пример~~ запроса с участием токена:		Пример запроса с участием токена:
			curl -X GET "http://127.0.0.1:6182/auth/version" -H "accept: application/json" -H "x-access-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMCIsImNyZWF0ZWQiOjE3MTQ2NTk5MDIuOTk5MzQzNiwidHlwZSI6ImFjY2VzcyJ9.wrTRX2de5jhVFKRQ_Xt0fNXxHWN_yLiqZ6S_inix0Jg"
	curl -X GET "http://127.0.0.1:6182/auth/version" -H "accept: application/json" -H "x-access-token: eyJhbGciOiJIUzI1NiIsInR5cCI6IkpXVCJ9.eyJ1c2VyX2lkIjoiMCIsImNyZWF0ZWQiOjE3MTQ2NTk5MDIuOTk5MzQzNiwidHlwZSI6ImFjY2VzcyJ9.wrTRX2de5jhVFKRQ_Xt0fNXxHWN_yLiqZ6S_inix0Jg"		В случае если UPS работает в закрытом контуре и авторизация не требуется, методы API, которые используются, нужно добавить в раздел «nopassword» конфигурационного файла (см. ниже).

	В случае если UPS работает в закрытом контуре и авторизация не требуется, методы API, которые используются, нужно добавить в раздел ~~"nopassword"~~ конфигурационного файла (см. ниже)

	====='''Установка модулей для UPS'''=====		====='''Установка модулей для UPS'''=====
	Есть возможность создать любой модуль, который будет эмулировать любой API интерфейс любого стороннего сервиса через UPS. Для примера создан интерфейс Яндекс. Установка модулей возможна прямым ~~копирование~~ файлов модуля в директорию /opt/ups/modules/<название модуля>.		Есть возможность создать любой модуль, который будет эмулировать любой API интерфейс любого стороннего сервиса через UPS. Для примера создан интерфейс Яндекс. Установка модулей возможна прямым копированием файлов модуля в директорию /opt/ups/modules/<название модуля>.

	Чтобы убедиться, что модуль доступен и работает, выполните запрос		Чтобы убедиться, что модуль доступен и работает, выполните запрос:

	<code>curl -X GET "<nowiki>http://АДРЕС_СЕРВЕРА:6182/tts/synthesize/yandex_tts_emulator?rate=100&pitch=100&volume=0</nowiki>" --H "accept: application/json" --data-urlencode "text=текст для синтеза" --output out.wav</code>		<code>curl -X GET "<nowiki>http://АДРЕС_СЕРВЕРА:6182/tts/synthesize/yandex_tts_emulator?rate=100&pitch=100&volume=0</nowiki>" --H "accept: application/json" --data-urlencode "text=текст для синтеза" --output out.wav</code>