Merge branch 'fix/documentation' into 'test'

Fix/documentation

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

src/.vitepress/config.mts

@@ -137,17 +137,16 @@ export default defineConfig({
     sidebar: {
 
 
+
+
     '/platform/': [
-      {
+      {text: 'Платформа Beeline Cloud', link: '/platform/index.md'},
-        text: 'Платформа Beeline Cloud', link: '/platform/index.md',
-        collapsed: true,
-          items: [
       {text: 'Обзор', link: '/platform/about.md'},
       {text: 'Типы тарификации', link: '/platform/billing-types.md'},
       {text: 'Техническая поддержка', link: '/platform/support/support-overview.md'},
       ],
-        },
+
-      ],
+
 
 
       '/legal/': [
@@ -155,12 +154,11 @@ export default defineConfig({
       ],
 
 
+
+
       '/security/': [
-        {
+        {text: 'Сервисы информационной безопасности в Beeline Cloud', link: '/security/index.md'},
-          text: 'Сервисы информационной безопасности в Beeline Cloud', link: '/security/index.md',
+        {text: 'Cloud Security Awareness (SA)', link: '/security/Cloud-SA/SA-index.md',
-        },
-        {
-          text: 'Cloud Security Awareness (SA)', link: '/security/Cloud-SA/SA-index.md',
           collapsed: true,
           items: [  
             {
@@ -240,6 +238,7 @@ export default defineConfig({
           { text: 'Состав сервиса', link: '/security/Cloud-NGFW/compound.md' },
           { text: 'Сроки и условия предоставления сервиса. Зоны ответственности', link: '/security/Cloud-NGFW/provision.md' },
           { text: 'Структура платежей', link: '/security/Cloud-NGFW/payment.md' },
+          { text: 'Структура платежей', link: '/security/Cloud-NGFW/payment.md' },
         ]
       },
       {
@@ -255,8 +254,7 @@ export default defineConfig({
           { text: 'Тестирование сервиса', link: '/security/Cloud-NGFW-F/testing.md' },
         ]
       },
-      {
+      { text: 'Cloud NGFW Pro', link: '/security/Cloud-NGFW-Pro/NGFW-Pro-index.md',
-        text: 'Cloud NGFW Pro', link: '/security/Cloud-NGFW-Pro/NGFW-Pro-index.md',
         collapsed: true,
         items: [
             { text: 'Обзор сервиса', link: '/security/Cloud-NGFW-Pro/about.md'},
@@ -292,52 +290,41 @@ 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'}, 
-          {text: 'Веб-интерфейс Grafana', link: '/PostgreSQL/service/grafana.md'},
-          {text: '1C для PostgreSQL', link: '/PostgreSQL/service/PostgreSQL-1C.md' },
     ],
-      },  
+
-      {text: 'IPSEC', link: '/PostgreSQL/IPSEC.md'},
+
-      {text: 'Cloud Interconnect', link: '/PostgreSQL/interconnect.md' },
+    '/network/': [
+      {text: 'Сетевое взаимодействие', link: '/network/network-index.md'},
+      {text: 'IPsec', link: '/network/IPSEC.md'},
+      {text: 'Cloud Interconnect', link: '/network/interconnect.md' },
     ],
 
 
     '/Deckhouse/': [    
-      { text: 'Deckhouse', link: '/Deckhouse/index.md',
+      {text: 'Cloud Deckhouse Kubernetes', link: '/Deckhouse/index.md'},
-        collapsed: true,
-        items: [
       {text: 'Обзор сервиса', link: '/Deckhouse/about.md'},
       {text: 'Права и возможности пользователей', link: '/Deckhouse/user-permissions.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,
-        items: [
       {text: 'Обзор сервиса', link: '/Apache-Kafka/about-service.md'}, 
       {text: 'Работа с кластером Kafka по тарифу Base', link: '/Apache-Kafka/base-tier-connection.md'},
       {text: 'Настройка топика по тарифу Base', link: '/Apache-Kafka/base-tier-topics-guide.md'},
       {text: 'Конфигурация кластера', link: '/Apache-Kafka/cluster-configuretion.md'},
       {text: 'Работа с кластером Kafka по тарифу Full', link: '/Apache-Kafka/full-tier-connection.md'}, 
     ],
-      }  
-    ],
 
 
     '/finance/': [
@@ -352,11 +339,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' },
@@ -431,11 +415,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/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: /PostgreSQL/interconnect.md
+    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/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: /PostgreSQL/service/PostgreSQL-1C.md
-    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/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, включая защищённые туннели и виртуальные каналы связи.