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

Сводка

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

Подробности

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

Содержимое

...	...	@@ -1,13 +3,11 @@
1		-== 1. Описание сервиса ==
2		-
3	3	**SQL REST Proxy** — лёгкий REST-сервис на Python, разработанный как замена прямым вызовам SQL через ADODB.Connection в конфигурациях 1С, работающих на Linux. Поскольку COM-объекты и нативные ODBC-драйверы недоступны на Linux-платформе 1С:Предприятие, этот сервис позволяет выполнять произвольные SQL-запросы к внешним базам данных через стандартный HTTP-вызов из встроенного языка 1С.
4	4
5	5	**Поддерживаемые СУБД**
6	6
7		-|=СУБД     |=Драйвер               |=Порт по умолчанию
8		-|PostgreSQL|psycopg2           |5432
	5	+|=СУБД |=Драйвер |=Порт по умолчанию
	6	+|PostgreSQL|psycopg2 |5432
9	9	|Microsoft SQL Server|pymssql|1433
10		-|MySQL     |PyMySQL               |3306
	8	+|MySQL |PyMySQL |3306
11	11
12	12
13	13
...	...	@@ -22,12 +22,9 @@
22	22	**Мониторинг**
23	23	Эндпоинт /metrics предоставляет метрики в формате Prometheus. Готовый конфиг prometheus.yml для сбора метрик включён в поставку. Эндпоинт /pools/stats возвращает детальную статистику по активным пулам соединений.
24	24
	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		-
31	31	># git clone https://prosto-skud:API_КЛЮЧ_ДЛЯ_ДОСТУПА_К_РЕПОЗИТОРИЮ@github.com/prosto-skud/p-skud-sql-proxy-service.git
32	32
33	33	**Запуск**
...	...	@@ -63,45 +63,3 @@
63	63	Проверка
64	64
65	65	># 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		-