внесение корректировок

2026-03-27 12:27:45 +03:00
parent 1b96efc894
commit d8165f9442
9 changed files with 210 additions and 275 deletions
@@ -1,14 +1,16 @@
 # Общая схема подключения

-Доступ к кластеру PostgreSQL осуществляется через прокси. Клиентские подключения принимаются прокси, который маршрутизирует трафик к соответствующим узлам кластера (master или replica) в зависимости от выбранного порта. Прямое подключение к узлам базы данных не используется.
+Подключение к кластеру **Cloud PostgreSQL** осуществляется через прокси-сервер. Клиентские подключения принимаются прокси, который маршрутизирует трафик к соответствующим узлам кластера (master или replica) в зависимости от выбранного порта.

-Подключение к кластеру **Cloud PostgreSQL** осуществляется через прокси-сервер. Прокси является единой точкой входа для всех клиентских подключений и принимает входящие соединения от приложений, административных инструментов и пользователей.
+Прокси является единой точкой входа для всех клиентских подключений и принимает входящие соединения от приложений, административных инструментов и пользователей.

 В зависимости от выбранного порта прокси автоматически направляет трафик:
- на активный primary-узел - для операций чтения и записи
- на реплики - для операций только чтения
+- **на активный primary-узел** - для операций чтения и записи
+- **на реплики** - для операций только чтения

-Прямое подключение к отдельным узлам базы данных не используется и не предоставляется. Взаимодействие с кластером всегда выполняется через прокси-сервер.
+::: warning Примечание
+Прямое подключение к отдельным узлам базы данных **не используется и не предоставляется**. Взаимодействие с кластером всегда выполняется **через прокси-сервер**.
+::: 

 ## Подключение к базе данных

@@ -29,13 +31,13 @@
 |6432  |Primary через PgBouncer (чтение и запись)|
 |16432 |Replica через PgBouncer (только чтение)  |

-### Особенности работы портов
+#### Особенности работы портов

- Порты для чтения и записи (5432, 6432) всегда направляют трафик на активный primary-узел. При смене primary переключение происходит автоматически;
- Порты только для чтения (15432, 16432) направляют трафик на активные реплики. Если реплик несколько, нагрузка распределяется между ними по принципу round-robin;
- Если в кластере отсутствуют реплики, порты для чтения не используются - подключение по ним не устанавливается.
+- Порты **для чтения и записи** (5432, 6432) всегда направляют трафик на активный primary-узел. При смене primary переключение происходит автоматически;
+- Порты **только для чтения** (15432, 16432) направляют трафик на активные реплики. Если реплик несколько, нагрузка распределяется между ними по принципу round-robin;
+- Если в кластере **отсутствуют реплики**, порты для чтения не используются - подключение по ним не устанавливается.

-### Рекомендации по выбору порта
+#### Рекомендации по выбору порта

 - Для OLTP-нагрузки и большого количества соединений рекомендуется использовать **порты PgBouncer (6432 или 16432)**;
 - Для операций записи используйте **master-порты (5432 или 6432)**;
@@ -43,7 +45,7 @@

 ## Доступ к pgAdmin

-Для администрирования базы данных используется web-интерфейс pgAdmin.
+Для администрирования базы данных используется [web-интерфейс pgAdmin](./pgadmin.md).
 Доступ осуществляется по DNS-имени, которое нужно прописать локально в инфраструктуре откуда будет происходить доступ к web-интерфейсу сервиса:
 `10.X.X.4 <domain>.cloud-pg.dfcloud.ru`

@@ -52,7 +54,7 @@

 Авторизация выполняется с использованием учётных данных, предоставленных вместе с доступом к сервису.

-::: warning Важно
+::: warning Примечание

 - подключение к базе данных возможно только через указанный прокси-IP;
 - в интерфейсе pgAdmin уже добавлен сервер базы данных, созданный для данной инсталляции. Для подключения требуется ввести пароль от учётной записи базы данных;
@@ -68,7 +70,7 @@
 Подключение через PgBouncer:
 `psql -h 10.X.X.4 -p 6432 -U <username> -d <database>`

-### Подключение через DBeaver / DataGrip
+#### Подключение через DBeaver / DataGrip

 При создании подключения укажите:
 - Host: 10.X.X.4;
@@ -77,7 +79,7 @@
 - User / Password: согласно выданным доступам;
 - Тип подключения: PostgreSQL.

-### Пример строки подключения
+#### Пример строки подключения

 Primary:
 `postgresql://<username>:<password>@10.X.X.4:5432/<database>`