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

Сводка

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

Подробности

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

Содержимое

...	...	@@ -1,11 +1,13 @@
	1	+== 1. Описание сервиса ==
	2	+
1	1	**SQL REST Proxy** — лёгкий REST-сервис на Python, разработанный как замена прямым вызовам SQL через ADODB.Connection в конфигурациях 1С, работающих на Linux. Поскольку COM-объекты и нативные ODBC-драйверы недоступны на Linux-платформе 1С:Предприятие, этот сервис позволяет выполнять произвольные SQL-запросы к внешним базам данных через стандартный HTTP-вызов из встроенного языка 1С.
2	2
3	3	**Поддерживаемые СУБД**
4	4
5		-|=СУБД |=Драйвер |=Порт по умолчанию
6		-|PostgreSQL|psycopg2 |5432
	7	+|=СУБД     |=Драйвер               |=Порт по умолчанию
	8	+|PostgreSQL|psycopg2           |5432
7	7	|Microsoft SQL Server|pymssql|1433
8		-|MySQL |PyMySQL |3306
	10	+|MySQL     |PyMySQL               |3306
9	9
10	10
11	11
...	...	@@ -20,9 +20,12 @@
20	20	**Мониторинг**
21	21	Эндпоинт /metrics предоставляет метрики в формате Prometheus. Готовый конфиг prometheus.yml для сбора метрик включён в поставку. Эндпоинт /pools/stats возвращает детальную статистику по активным пулам соединений.
22	22
23		-**Установка**
24		-Для установки нужно скачать проект с github либо развернуть из архива (SQL-REST-Proxy.zip находится в каталоге с файлом расширения):
25	25
	26	+== 2. Установка через docker контейнер ==
	27	+
	28	+
	29	+Для установки нужно скачать проект с github либо развернуть из архива (p-skud-sql-proxy-service-main.zip находится в каталоге "Модули и ODBC-драйверы" из поставки расширения):
	30	+
26	26	># git clone https://prosto-skud:API_КЛЮЧ_ДЛЯ_ДОСТУПА_К_РЕПОЗИТОРИЮ@github.com/prosto-skud/p-skud-sql-proxy-service.git
27	27
28	28	**Запуск**
...	...	@@ -58,3 +58,45 @@
58	58	Проверка
59	59
60	60	># curl -k https://<server>:8443/health
	66	+
	67	+== 3. Установка в виде сервиса ==
	68	+
	69	+Для установки нужно скачать проект с github либо развернуть из архива (p-skud-sql-proxy-service-main.zip находится в каталоге "Модули и ODBC-драйверы" из поставки расширения):
	70	+
	71	+># git clone https://prosto-skud:API_КЛЮЧ_ДЛЯ_ДОСТУПА_К_РЕПОЗИТОРИЮ@github.com/prosto-skud/p-skud-sql-proxy-service.git
	72	+
	73	+Для проекта нужен Python 3.11 или версия, с которой зависимости проекта гарантированно устанавливаются. Если в Astra Linux доступен только более старый Python, согласуйте установку Python 3.11 с администратором безопасности. Не заменяйте системный `/usr/bin/python3`.
	74	+
	75	+Минимальный набор пакетов для онлайн-установки зависимостей:
	76	+
	77	+># sudo apt update
	78	+># sudo apt install -y \
	79	+># python3 \
	80	+># python3-venv \
	81	+># python3-pip \
	82	+># python3-dev \
	83	+># build-essential \
	84	+># gcc \
	85	+># g++ \
	86	+># openssl \
	87	+># ca-certificates \
	88	+># freetds-dev \
	89	+># libpq-dev \
	90	+># default-libmysqlclient-dev \
	91	+># pkg-config
	92	+
	93	+Пояснение:
	94	+
	95	+- `freetds-dev` нужен для `pymssql`, который используется для MS SQL Server;
	96	+- `libpq-dev` полезен для PostgreSQL-зависимостей;
	97	+- `default-libmysqlclient-dev` и `pkg-config` могут понадобиться при сборке MySQL-зависимостей, хотя в проекте используется `PyMySQL`;
	98	+- `openssl` нужен для генерации сертификатов;
	99	+- `build-essential`, `gcc`, `g++`, `python3-dev` нужны, если какие-то wheels недоступны и зависимость собирается из исходников.
	100	+
	101	+Если какие-то из пакетов недоступны необходимо добавить добавить и расширенный репозиторий.
	102	+Например для Astra Linux Special Edition 1.8 x86-64:
	103	+># sudo nano /etc/apt/sources.list.d/astra.list
	104	+Содержимое для stable-ветки:
	105	+># deb https://dl.astralinux.ru/astra/stable/1.8_x86-64/main-repository/ 1.8_x86-64 main contrib non-free non-free-firmware
	106	+># deb https://dl.astralinux.ru/astra/stable/1.8_x86-64/extended-repository/ 1.8_x86-64 main contrib non-free non-free-firmware
	107	+