Merge branch 'fix/documentation' into 'main'

Fix/documentation

See merge request common/lk-beecloud/beecloud-docs!42

src/.vitepress/config.mts

@@ -137,17 +137,23 @@ export default defineConfig({
     sidebar: {
 
 
+
+
     '/platform/': [
       { text: 'Обзор', link: '/platform/about.md' },
       { text: 'Техническая поддержка', link: '/platform/support-overview.md' },
     ],
 
 
+
+
       '/legal/': [
-        { text: 'Юридические документы', link: '/legal/index.md' },
+      { text: 'Юридические документы', link: '/legal/index.md' },
       ],
 
 
+
+
       '/security/': [
         { text: 'Сервисы информационной безопасности в Beeline Cloud', link: '/security/index.md' },
       ],
@@ -275,51 +281,40 @@ export default defineConfig({
 
 
     '/PostgreSQL/': [
-      {
+      {text: 'PostgreSQL', link: '/PostgreSQL/PostgreSQL-index.md'},
-        text: 'Начало работы в Cloud PostgreSQL', link: '/PostgreSQL/PostgreSQL-index.md',
+      {text: 'Обзор сервиса', link: '/PostgreSQL/about.md'}, 
-      },
+      {text: 'Описание технических параметров', link: '/PostgreSQL/cluster-parameter.md'},
-      {
+      {text: 'Общая схема подключения', link: '/PostgreSQL/connection.md'},
-        text: 'Cloud PostgreSQL', link: '/PostgreSQL/service/service-index.md',
+      {text: 'Возможности пользователя', link: '/PostgreSQL/user-capabilities.md'},
-        collapsed: true,
+      {text: 'Веб-интерфейс pgAdmin', link: '/PostgreSQL/pgadmin.md'}, 
-        items: [
+      {text: 'Веб-интерфейс Grafana', link: '/PostgreSQL/grafana.md'},
-          {text: 'Обзор сервиса', link: '/PostgreSQL/service/about.md'}, 
+      {text: '1C для PostgreSQL', link: '/PostgreSQL/PostgreSQL-1C.md' },
-          {text: 'Описание технических параметров', link: '/PostgreSQL/service/cluster-parameter.md'},
+    ],
-          {text: 'Общая схема подключения', link: '/PostgreSQL/service/connection.md'},
+
-          {text: 'Возможности пользователя', link: '/PostgreSQL/service/user-capabilities.md'},
+
-          {text: 'Веб-интерфейс pgAdmin', link: '/PostgreSQL/service/pgadmin.md'}, 
+    '/network/': [
-          {text: 'Веб-интерфейс Grafana', link: '/PostgreSQL/service/grafana.md'},
+      {text: 'Сетевое взаимодействие', link: '/network/network-index.md'},
-        ],
+      {text: 'IPsec', link: '/network/IPSEC.md'},
-      },  
+      {text: 'Cloud Interconnect', link: '/network/interconnect.md' },
-      {text: 'IPSEC', link: '/PostgreSQL/IPSEC.md'},
-      {text: 'Cloud Interconnect', wip: true },
-      {text: '1C', wip: true },
     ],
 
 
     '/Deckhouse/': [    
-      { text: 'Deckhouse', link: '/Deckhouse/index.md',
+      {text: 'Cloud Deckhouse Kubernetes', link: '/Deckhouse/index.md'},
-        collapsed: true,
+      {text: 'Обзор сервиса', link: '/Deckhouse/about.md'},
-        items: [
+      {text: 'Права и возможности пользователей', link: '/Deckhouse/user-permissions.md'},
-          {text: 'Обзор сервиса', link: '/Deckhouse/about.md'},
+      {text: 'Описание технических параметров', link: '/Deckhouse/technical-parameters.md'},
-          {text: 'Права и возможности пользователей', link: '/Deckhouse/user-permissions.md'},
+      {text: 'Подключение к сервису', link: '/Deckhouse/connection.md'}
-          {text: 'Описание технических параметров', link: '/Deckhouse/technical-parameters.md'},
-          {text: 'Подключение к сервису', link: '/Deckhouse/connection.md'}
-        ]
-      },
     ],
 
 
     '/Apache-Kafka/': [    
-      { text: 'Apache-Kafka', link: '/Apache-Kafka/Kafka-index.md',
+      {text: 'Apache Kafka', link: '/Apache-Kafka/Kafka-index.md'},
-        collapsed: true,
+      {text: 'Обзор сервиса', link: '/Apache-Kafka/about-service.md'}, 
-        items: [
+      {text: 'Работа с кластером Kafka по тарифу Base', link: '/Apache-Kafka/base-tier-connection.md'},
-          {text: 'Обзор сервиса', link: '/Apache-Kafka/about-service.md'}, 
+      {text: 'Настройка топика по тарифу Base', link: '/Apache-Kafka/base-tier-topics-guide.md'},
-          {text: 'Работа с кластером Kafka по тарифу Base', link: '/Apache-Kafka/base-tier-connection.md'},
+      {text: 'Конфигурация кластера', link: '/Apache-Kafka/cluster-configuretion.md'},
-          {text: 'Настройка топика по тарифу Base', link: '/Apache-Kafka/base-tier-topics-guide.md'},
+      {text: 'Работа с кластером Kafka по тарифу Full', link: '/Apache-Kafka/full-tier-connection.md'}, 
-          {text: 'Конфигурация кластера', link: '/Apache-Kafka/cluster-configuretion.md'},
-          {text: 'Работа с кластером Kafka по тарифу Full', link: '/Apache-Kafka/full-tier-connection.md'}, 
-        ],
-      }  
     ],
 
 
@@ -335,11 +330,8 @@ export default defineConfig({
 
 
     '/vdc/': [
-      {
+      {text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md'},
-        text: 'Виртуальные дата-центры на VMware', link: '/vdc/index.md',
+      {text: 'Обзор сервиса', link: '/vdc/vdc-overview.md',
-      },
-      {
-        text: 'Обзор сервиса', link: '/vdc/vdc-overview.md',
         collapsed: true,
             items: [  
           { text: 'О сервисе', link: '/vdc/vdc-about.md' },
@@ -414,11 +406,10 @@ export default defineConfig({
         ],
 
 
+
         // { text: 'Тарификация', link: '/vdc/vdc-tarif.md' },
       '/monitoring/': [
-      {
+      {text: 'Мониторинг', link: '/monitoring/about.md'},
-        text: 'Мониторинг', link: '/monitoring/about.md',
-      },
       ],    
       },  
     },

src/Apache-Kafka/base-tier-topics-guide.md

@@ -40,6 +40,19 @@ Partitions = max(NP, NC)
 - TP - максимальная пропускная способность одного продюсера для одной партиции;
 - TC - максимальная пропускная способность одного консьюмера для одной партиции.
 
+::: details Пример
+- **TT = 1000 МБ/с**
+
+Тест показал: **TP = 20 МБ/с** (один продюсер в одну партицию)
+
+- **NP = 1000 / 20 = 50 продюсеров**
+
+Значит, нужно минимум 50 партиций (чтобы 50 продюсеров не ждали друг друга).
+- Но если **TC = 10 МБ/с** (консьюмер потребляет медленно), то:
+- **NC = 1000 / 10 = 100 консьюмеров**
+- **Partitions = max(50, 100) = 100**
+:::
+
 ## Фактор репликации (replication-factor)
 
 Фактор репликации определяет количество копий данных, хранящихся на разных брокерах.

src/Deckhouse/index.md

@@ -17,3 +17,5 @@ section_links:
 # Cloud Deckhouse Kubernetes
 
 В данном разделе представлена документация по управлемому сервису **Cloud Deckhouse Kubernetes** платформы Beeline Cloud.
+
+Для более глубокого ознакомления с возможностями Deckhouse рекомендуется обратиться к официальной документации по [ссылке](https://deckhouse.ru/docs/)

src/PostgreSQL/Interconnet.md

@@ -1,3 +0,0 @@
-# Cloud Interconnect
-
-Раздел в разработке.

src/PostgreSQL/PostgreSQL-1C.md

@@ -0,0 +1,129 @@
+# 1С для PostgreSQL
+
+В этой статье описан процесс добавления **информационной базы 1С при использовании PostgreSQL** в качестве сервера баз данных.
+
+## Назначение сервиса
+
+**Информационная база 1С** — это единое хранилище, в котором собраны логика работы программы и данные конкретной организации. В ней находятся:
+
+- конфигурация, определяющая функционал системы;
+- рабочие данные: документы, справочники, регистры учета.
+
+Информационная база необходима для ведения учета и хранения данных компании в одном месте. Через нее пользователи работают в 1С: 
+
+- вводят документы;
+- формируют отчеты;
+- настраивают учет под свои задачи.
+
+Без информационной базы работа в 1С невозможна — она является основой стабильной работы всей системы.
+
+::: info Примечание
+Задержка между кластером «1С:Предприятие» и сервером PostgreSQL **не должна превышать 7–8 миллисекунд**. Превышение этого порога может привести к нестабильной работе системы.
+:::
+
+## Подключение к базе данных
+
+Подключение к информационной базе может быть выполнено двумя способами:
+
+- **через тонкий клиент** — графический способ, подходящий для большинства пользователей;
+- **через консоль** — способ для администраторов и автоматизации процессов.
+
+#### 1. Подключение через тонкий клиент
+
+Этот способ позволяет создать новую базу данных на сервере «1С:Предприятие» из установленного ранее шаблона типовой конфигурации.
+
+##### Подключение к кластеру
+
+1. Запустите программу «1С:Предприятие».
+2. В окне запуска нажмите кнопку **Добавить**.
+3. Запустится мастер добавления информационной базы. Установите переключатель в положение **Создание новой информационной базы** и нажмите **Далее**.
+4. В списке установленных шаблонов конфигураций выберите нужный шаблон и нажмите **Далее**.
+5. Введите имя базы данных — так она будет отображаться в списке информационных баз.
+6. В поле **Тип расположения** укажите **На сервере «1С:Предприятия»** и нажмите **Далее**.
+
+##### Параметры информационной базы
+
+| Параметр                                       | Описание                                                                                                                     |
+|------------------------------------------------|------------------------------------------------------------------------------------------------------------------------------|
+| **Кластер серверов 1С:Предприятия**            | Сетевое имя компьютера с установленным сервером «1С:Предприятия» (центральный кластер). Как правило, совпадает с именем узла |
+| **Имя информационной базы в кластере**         | Уникальное имя для обращения к базе. Должно быть уникально в пределах кластера                                               |
+| **Защищенное соединение**                      | По умолчанию **отключено**                                                                                                   |
+| **Тип СУБД**                                   | Укажите **PostgreSQL**                                                                                                       |
+| **Сервер баз данных**                          | IP-адрес компьютера с сервером PostgreSQL (пример: `192.168.10.4`)                                                           |
+| **Имя базы данных**                            | Имя базы на сервере PostgreSQL. Рекомендуется задавать совпадающим с именем базы в кластере (пример: `db_test`)              |
+| **Пользователь базы данных**                   | Пользователь PostgreSQL, который становится владельцем базы (пример: `user_test`)                                            |
+| **Пароль пользователя**                        | Пароль указанного пользователя                                                                                               |
+| **Смещение дат**                               | Число лет, прибавляемых к датам при сохранении и вычитаемых при извлечении. Для PostgreSQL обычно `0`. При использовании регистров накопления или бухгалтерии рекомендуется `2000` |
+| **Создать базу данных в случае ее отсутствия** | Чекбокс — должен быть **снят**                                                                                               |
+| **Язык (Страна)**                              | Выберите **Русский (Россия)**                                                                                                |
+| **Установить блокировку регламентных заданий** | Запрещает выполнение регламентных заданий. Устанавливается для тестовых баз                                                  |
+| **Запретить локальное распознавание речи**     | Обычно не устанавливается                                                                                                    |
+
+::: info Примечание
+Создание новой базы данных осуществляется на основании обращения в Service Desk. Запрос направляется по электронной почте `servicedesk@datafort.ru`.
+:::
+
+![Загрузка через интерфейс](images/from-the-interface.png)
+
+#### 2. Подключение через консоль
+
+Этот способ позволяет добавить информационную базу в кластер серверов через оснастку «Администрирование серверов 1С:Предприятия». Предварительно должна быть установлена соответствующая оснастка.
+
+::: info Примечание
+Оснастка запускается выполнением файла `1CV8 Servers.msc`, который находится в каталоге установки «1С:Предприятие» в подкаталоге `common`.
+:::
+
+Если оснастка запускается на том же компьютере, где установлен сервер «1С:Предприятия», в дереве слева в ветке с сетевым именем текущего компьютера отображается кластер серверов под названием **Локальный кластер**. При раскрытии вкладки **Информационные базы** отображаются все базы в данном кластере (включая созданные ранее через окно запуска «1С:Предприятие»).
+
+##### Подключение к кластеру
+
+1. На вкладке **Информационные базы** кликните правой кнопкой мыши.
+2. В контекстном меню выберите **Создать** → **Информационная база**.
+3. Откроется окно параметров создаваемой базы.
+4. Заполните параметры (список аналогичен описанному в разделе «Подключение через тонкий клиент», но дополнен новыми полями).
+5. Нажмите **ОК** для запуска процесса создания.
+
+##### Параметры информационной базы
+
+| Параметр                                           | Описание                                                                                                               |
+|----------------------------------------------------|------------------------------------------------------------------------------------------------------------------------|
+| **Блокировка начала сеансов включена**             | Запрещает новые сеансы. Существующие продолжают работу                                                                 |
+| **Начало**                                         | Дата и время начала блокировки (формат: `ГГГГ-ММ-ДД чч:мм:сс`)                                                         |
+| **Конец**                                          | Дата и время окончания блокировки                                                                                      |
+| **Сообщение**                                      | Текст ошибки при попытке подключения к заблокированной базе                                                            |
+| **Код разрешения**                                 | Строка для параметра `/UC` при запуске в обход блокировки                                                              |
+| **Параметр блокировки**                            | Произвольный текст для использования в конфигурациях                                                                   |
+| **Блокировка регламентных заданий включена**       | Запрещает выполнение регламентных заданий                                                                              |
+| **Внешнее управление сеансами**                    | Параметры Web-сервиса внешнего управления сеансами                                                                     |
+| **Обязательное использование внешнего управления** | При установке недоступность Web-сервиса вызывает ошибку подключения                                                    |
+| **Профиль безопасности**                           | Ограничения для прикладного решения                                                                                    |
+| **Профиль безопасности безопасного режима**        | Ограничения для фрагментов в безопасном режиме                                                                         |
+| **Резервирование рабочих процессов**               | Определяет резервирование                                                                                              |
+| **Запретить локальное распознавание речи**         | Обычно не устанавливается                                                                                              |
+| **При отсутствии активных пользователей**          | Группа параметров: задержка выгрузки конфигурации, минимальный период запуска регламентных заданий, максимальный сдвиг |
+
+![Загрузка через консоль](images/from-the-console.png)
+
+После завершения настройки можно приступать к работе с базой данных через интерфейс "1С:Предприятие".
+
+## Миграция базы из старой 1С
+
+#### Выгрузка базы
+
+Чтобы выгрузить базу 1С из старой системы:
+
+1. Откройте базу в **Конфигураторе** на старом клиенте.
+2. Перейдите в меню **Администрирование** → **Выгрузить информационную базу**.
+3. Укажите путь для сохранения файла и выполните выгрузку.
+
+![Выгрузить информационную базу](images/upload.jpg)
+
+#### Загрузка базы
+
+Чтобы загрузить базу на новый сервер 1С:
+
+1. Откройте **Конфигуратор** новой информационной базы.
+2. Перейдите в меню **Администрирование** → **Загрузить информационную базу**.
+3. Выберите файл, выгруженный из старой 1С.
+
+![Загрузить информационную базу](images/download.jpg)

src/PostgreSQL/PostgreSQL-index.md

@@ -1,14 +1,26 @@
 ---
 section_links:
-  - title: Cloud PostgreSQL
+  - title: Назначение сервиса
-    link: /PostgreSQL/service/service-index.md
+    link: /PostgreSQL/about.md
-    description: Обзор сервиса PostgreSQL
+    description: Конфигурации и возможности сервиса
-  - title: IPSEC
+  - title: Параметры кластера PostgreSQL
-    link: /PostgreSQL/IPSEC.md
+    link: /PostgreSQL/cluster-parameter.md
-    description: Параметры конфигурации IPSEC
+    description: Технические параметры кластера PostgreSQL
-  - title: Cloud Interconnect
+  - title: Схема подключения
-    link: 
+    link: /PostgreSQL/connection.md
-    description: Обзор сервиса Interconnect
+    description: Общая схема подключения к Cloud PostgreSQL 
+  - title: Возможности пользователя 
+    link: /PostgreSQL/user-capabilities.md
+    description: Возможности пользователя при создании сервиса
+  - title: Веб-интерфейс Grafana
+    link: /PostgreSQL/grafana.md
+    description: Инструкция по работе с Grafana
+  - title: Веб-интерфейс PgAdmin
+    link: /PostgreSQL/pgadmin.md
+    description: Инструкция по работе с PgAdmin
+  - title: 1C для PostgreSQL
+    link: /PostgreSQL/PostgreSQL-1C.md
+    description: Инструкция по работе с 1C при использовании PostgreSQL 
 ---   
 
 # Cloud PostgreSQL

src/PostgreSQL/cluster-parameter.md

@@ -75,7 +75,7 @@
 ## Сетевой доступ к кластеру
 
 Для организации защищенного подключения к кластеру Kafka доступны стандартные механизмы, используемые во всех сервисах платформы:
-- **IPsec-подключение** - организация защищенного туннеля между инфраструктурой и кластером PostgreSQL. Подробнее см. [раздел IPsec](../IPSEC.md);
+- **IPsec-подключение** - организация защищенного туннеля между инфраструктурой и кластером PostgreSQL. Подробнее см. [раздел IPsec](../network/IPSEC.md);
-- **Interconnection** - прямое сетевое соединение между сервисами внутри платформы без выхода в интернет. Подробнее см. раздел Interconnection.
+- **Interconnection** - прямое сетевое соединение между сервисами внутри платформы без выхода в интернет. Подробнее см. [раздел Interconnection](../network/interconnect.md).
 
 Выбор конкретного способа подключения зависит от архитектуры приложений и требований к безопасности.

src/PostgreSQL/service/1C.md

@@ -1,3 +0,0 @@
-# 1C
-
-Раздел в разработке.

src/PostgreSQL/service/service-index.md

@@ -1,28 +0,0 @@
----
-section_links:
-  - title: Назначение сервиса
-    link: /PostgreSQL/service/about.md
-    description: Конфигурации и возможности сервиса
-  - title: Параметры кластера PostgreSQL
-    link: /PostgreSQL/service/cluster-parameter.md
-    description: Технические параметры кластера PostgreSQL
-  - title: Схема подключения
-    link: /PostgreSQL/service/connection.md
-    description: Общая схема подключения к Cloud PostgreSQL 
-  - title: Возможности пользователя 
-    link: /PostgreSQL/service/user-capabilities.md
-    description: Возможности пользователя при создании сервиса
-  - title: Веб-интерфейс Grafana
-    link: /PostgreSQL/service/grafana.md
-    description: Инструкция по работе с Grafana
-  - title: Веб-интерфейс PgAdmin
-    link: /PostgreSQL/service/pgadmin.md
-    description: Инструкция по работе с PgAdmin
-  - title: 1C для PostgreSQL
-    link: 
-    description: Инструкция по работе с 1C при использовании PostgreSQL 
----    
-
-# Cloud PostgreSQL
-
-В данном разделе представлена документация по управляемому сервису **Cloud PostgreSQL** платформы Beeline Cloud.

src/index.md

@@ -29,18 +29,26 @@ services:
         description: Аренда виртуального дата-центра на базе VMware
         icon: cloud
         link: /vdc/index
-  - title: Базы данных
+  - title: Платформа данных
     articles:
       - title: Cloud PostgreSQL
         description: Объектно-реляционная СУБД с открытым кодом, обеспечивающая высокую надёжность и масштабируемость
         icon: database
         link: /PostgreSQL/PostgreSQL-index
-  - title: Брокеры сообщений
-    articles:
       - title: Apache Kafka
         description: Распределённая система для потоковой передачи данных в реальном времени
         icon: message
         link: /Apache-Kafka/Kafka-index
+  - title: Сетевое взаимодействие
+    articles:
+      - title: Cloud Interconnect
+        description: Виртуальный канал, соединяющий вашу инфраструктуру с платформой на сетевом уровне
+        icon: voice
+        link: /network/interconnect.md
+      - title: IPsec
+        description: Защищённый туннель между инфраструктурой заказчика и кластерами платформы
+        icon: voice
+        link: /network/IPSEC.md
   - title: DevOps Инструменты
     articles:
       - title: Cloud Deckhouse Kubernetes 

src/network/interconnect.md

@@ -0,0 +1,47 @@
+# Cloud Interconnect (L2VPN)
+
+## Назначение сервиса
+
+**Cloud Interconnect (L2VPN)** — это сервис организации виртуального выделенного канала на втором уровне модели OSI (L2). Он обеспечивает двустороннюю передачу данных между ресурсами заказчика и инфраструктурой Beeline Cloud, объединяя их на сетевом уровне L2.
+
+**Основные задачи сервиса:**
+
+- объединение пулов ресурсов (IaaS) внутри одного или между разными ЦОД Beeline Cloud;
+- подключение облачной инфраструктуры (IaaS) к сервису резервного копирования Beeline Cloud;
+- связывание облачных сервисов Beeline Cloud с физическим оборудованием клиента в ЦОД Beeline Cloud (услуга Collocation);
+- создание единого сетевого контура между облаком Beeline Cloud и собственной инфраструктурой заказчика.
+
+## Ключевые параметры при заказе
+
+При оформлении услуги в бланке заказа указываются следующие параметры:
+
+| Параметр                   | Описание                                                                   |
+|----------------------------|----------------------------------------------------------------------------|
+| **Точки предоставления**   | Места подключения каналов                                                  |
+| **Пропускная способность** | От 100 Мбит/с до 2 Гбит/с. Более высокие значения согласовываются отдельно |
+
+## Обеспечение надежности
+
+Beeline Cloud строит сеть по принципам высокой доступности. Это обеспечивает стабильность канала за счет следующих механизмов:
+
+- **Кольцевая топология** — между любыми двумя узлами сети существуют минимум два независимых маршрута;
+- **Автоматическое резервирование (STP)** — при отказе основного соединения трафик переключается на резервное в течение 5–15 секунд;
+- **Горячее резервирование оборудования** — ключевые компоненты сети (коммутаторы, блоки питания) задублированы;
+- **Быстрое восстановление** — сеть стабилизируется после сбоя в течение 1 минуты.
+
+## Тарификация и сроки
+
+##### Структура платежей:
+
+| Тип платежа    | Описание                   |
+|----------------|----------------------------|
+| Единовременный | Оплата подключения сервиса |
+| Ежемесячный    | Аренда канала              |
+
+##### Точка разграничения ответственности:
+
+Сервис передается заказчику на сетевом порту оборудования Beeline Cloud.
+
+##### Срок действия
+
+Сервис предоставляется на **1 год** (или иной срок, указанный в бланке заказа) с автоматической пролонгацией. Для отказа от продления необходимо уведомить провайдера за 30 календарных дней до окончания текущего срока.

src/network/network-index.md

@@ -0,0 +1,13 @@
+---
+section_links:
+    - title: Cloud Interconnect
+      link: /network/interconnect.md
+      description: Обзор сервиса Cloud Interconnect
+    - title: IPsec
+      link: /network/IPSEC.md
+      description: Возможности сервиса IPsec
+---   
+
+# Сетевое взаимодействие
+
+В данном разделе представлена документация по организации сетевого взаимодействия между инфраструктурой заказчика и кластерами платформы Beeline Cloud, включая защищённые туннели и виртуальные каналы связи.