Изменения документа Установка SQL REST Proxy сервиса

Сводка

• Свойства страницы (2 изменено, 0 добавлено, 0 удалено)

Подробности

Свойства страницы

Название

...	...	@@ -1,1 +1,1 @@
1		-Установка RESTAPI SQL сервиса
	1	+Установка SQL REST Proxy сервиса

Содержимое

...	...	@@ -1,33 +1,42 @@
1		-# SQL proxy service
2		-~#~# Для начала нужно скачать проект с github либо развернуть из архива
3		-```
4		-git clone https:~/~/prosto-skud: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@github.com/prosto-skud/p-skud-sql-proxy-service.git
5		-```
	1	+**SQL REST Proxy** — лёгкий REST-сервис на Python, разработанный как замена прямым вызовам SQL через ADODB.Connection в конфигурациях 1С, работающих на Linux. Поскольку COM-объекты и нативные ODBC-драйверы недоступны на Linux-платформе 1С:Предприятие, этот сервис позволяет выполнять произвольные SQL-запросы к внешним базам данных через стандартный HTTP-вызов из встроенного языка 1С.
6	6
7		-~#~# Запуск
8		-~#~## Переходим в директорию сервиса
9		-```
10		-cd p-skud-sql-proxy-service
11		-```
	3	+**Поддерживаемые СУБД**
	4	+СУБД Драйвер Порт по умолчанию
	5	+PostgreSQL psycopg2 5432
	6	+Microsoft SQL Server pymssql 1433
	7	+MySQL PyMySQL 3306
12	12
13		-~#~## Генерируем сертификаты
	9	+**Режим развёртывания**
	10	+Сервис запускается в Docker-контейнере и не требует установки каких-либо драйверов в хост-систему. Управление через docker-compose.
14	14
15		-```
16		-bash generate_certs.sh
17		-```
	12	+**Безопасность**
	13	+- Аутентификация по API-ключу (X-API-Key заголовок)
	14	+- HTTPS/TLS с поддержкой собственного сертификата
	15	+- Параметризованные запросы исключают SQL-инъекции
18	18
19		-~#~## Копируем .env
	17	+**Мониторинг**
	18	+Эндпоинт /metrics предоставляет метрики в формате Prometheus. Готовый конфиг prometheus.yml для сбора метрик включён в поставку. Эндпоинт /pools/stats возвращает детальную статистику по активным пулам соединений.
20	20
21		-```
22		-cp .env.example .env
23		-```
	20	+**Установка**
	21	+Для установки нужно скачать проект с github либо развернуть из архива (доступного для скачивания по ссылке):
	22	+git clone https://prosto-skud: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@github.com/prosto-skud/p-skud-sql-proxy-service.git
24	24
25		-~#~## И если требуется настраиваем под ваш контур .env
26		-```
	24	+**Запуск**
	25	+Переходим в директорию сервиса
	26	+
	27	+{{html}}
	28	+cd p-skud-sql-proxy-service
	29	+{{/html}}
	30	+
	31	+
	32	+Генерируем сертификаты
	33	+bash generate_certs.sh
	34	+Копируем .env
	35	+cp .env.example .env
	36	+И если требуется настраиваем под ваш контур .env
27	27	nano .env
28		-```
29	29	В файле можно изменить:
30		-```
	39	+
31	31	# API Key для аутентификации запросов
32	32	API_KEY=skud_proxy_19e1d5c545b55bdb3459281bd3a1c06a29c467c5645b3ceb748bb2589a5e0d46
33	33
...	...	@@ -34,9 +34,9 @@
34	34	# И порты работы Сервиса
35	35	SERVICE_PORT=8443
36	36	PROMETHEUS_PORT=9090
37		-```
38	38
39		-~#~## Поднимаем все сервисы из docker-compose.yml
40		-```
	47	+Поднимаем все сервисы из docker-compose.yml
41	41	docker compose up -d
42		-```
	49	+
	50	+Проверка
	51	+curl -k https://<server>:8443/health