Skip to content
Merged
Show file tree
Hide file tree
Changes from all commits
Commits
File filter

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
6 changes: 6 additions & 0 deletions .cursor/rules/docs/global-style.mdc
Original file line number Diff line number Diff line change
Expand Up @@ -45,3 +45,9 @@ alwaysApply: true
- Do not use first-level heading (`# ...`) in documentation files.
- Minimum allowed heading level is second-level (`## ...`).
- If a local checklist conflicts with full policy text, follow `.cursor/rules/docs/refs-editorial-policy-full.mdc`.

# Release notes (`content/documentation/release-notes/`)

- Under a heading (`##`, `###`, or `####`), if the only body content is a single top-level bullet (`-` or `*`), do not use a list: write one or more plain paragraphs instead (merge the bullet text with any lead-in sentence on the same topic).
- If there is a lead-in paragraph and exactly one bullet, merge them into continuous prose and drop the list marker.
- When there are two or more top-level bullets under the same heading, keep a Markdown list.
1 change: 1 addition & 0 deletions content/documentation/release-notes/_index.ru.md
Original file line number Diff line number Diff line change
@@ -1,5 +1,6 @@
---
title: История изменений
weight: 80
description: Сводка релизов Deckhouse Development Platform и ссылки на заметки о выпусках по версиям.
---

8 changes: 5 additions & 3 deletions content/documentation/release-notes/v1.0.0.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.0.0
weight: 1000
description: Заметки о выпуске v1.0.0 — виджеты, источники данных, действия, наборы данных, внешние сервисы, роли и исправления.
---

{{< alert level="info" >}}
Expand Down Expand Up @@ -83,7 +84,7 @@ weight: 1000

Добавлен тип источника данных **Generic API** для работы с произвольными инфраструктурными сервисами ([подробнее](../../admin/datasources/types/#genericapi)):
- Подключение к любому сервису с REST API.
- Поддержка разных типов пагинации для получения больших объемов данных.
- Поддержка разных типов пагинации для получения больших объёмов данных.
- Настраиваемые параметры запросов (заголовки, авторизация, query-параметры).

### Действия
Expand Down Expand Up @@ -115,8 +116,9 @@ weight: 1000
### Ролевая модель

Добавлены новые разрешения:
- `control:processes` - запуск, остановка и удаление запущенных процессов.
- `run:widget-actions` - выполнение действий виджетов.

- `control:processes` — запуск, остановка и удаление запущенных процессов.
- `run:widget-actions` — выполнение действий виджетов.

## Исправления

Expand Down
9 changes: 4 additions & 5 deletions content/documentation/release-notes/v1.0.1.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.0.1
weight: 990
description: Заметки о выпуске v1.0.1 — действия HashiCorp Vault и исправления.
---

{{< alert level="info" >}}
Expand All @@ -13,12 +14,10 @@ weight: 990

#### HashiCorp Vault

Обновлено действие:
- **CreateVaultSecret** — добавлен параметр `allow_update`. При значении `true` действие создаст новую версию секрета, если секрет с таким именем уже существует. При значении `false` действие вернёт ошибку, если секрет уже существует.
Обновлено действие **CreateVaultSecret** — добавлен параметр `allow_update`. При значении `true` действие создаст новую версию секрета, если секрет с таким именем уже существует. При значении `false` действие вернёт ошибку, если секрет уже существует.

Добавлено новое действие:
- **DeleteVaultSecret** - удаляет секрет из HashiCorp Vault.
Добавлено новое действие **DeleteVaultSecret** — удаляет секрет из HashiCorp Vault.

## Исправления

- Исправлена ошибка с датой создания действия при его перезапуске.
Исправлена ошибка с датой создания действия при его перезапуске.
41 changes: 17 additions & 24 deletions content/documentation/release-notes/v1.1.0.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.1.0
weight: 980
description: Заметки о выпуске v1.1.0 — несовместимые изменения, AI-ассистент, MCP, виджеты, воркеры, проверки статуса, действия, шаблонизация и исправления.
---

{{< alert level="info" >}}
Expand All @@ -26,7 +27,7 @@ weight: 980
enabled: false
```

2. Или настройте политики для поддержки iframe виджетов и внешних изображений:
1. Или настройте политики для поддержки iframe виджетов и внешних изображений:

```yaml
security:
Expand All @@ -37,11 +38,11 @@ weight: 980
allowExternalImages: true
```

Подробнее о настройке заголовков безопасности см. в [документации](../../admin/security/http-security-headers/).
Подробнее о настройке заголовков безопасности в [документации](../../admin/security/http-security-headers/).

### Группировка ресурсов в каталоге

Изменен механизм группировки ресурсов в каталоге. Ранее ресурсы группировались по префиксу в названии с разделителем `:` (например, «Gitlab: группы», «Gitlab: проекты»). Теперь группировка осуществляется через иерархическую структуру с использованием родительских ресурсов ([подробнее](../../user/catalog/#группировка-ресурсов)).
Изменён механизм группировки ресурсов в каталоге. Ранее ресурсы группировались по префиксу в названии с разделителем `:` (например, «Gitlab: группы», «Gitlab: проекты»). Теперь группировка осуществляется через иерархическую структуру с использованием родительских ресурсов ([подробнее](../../user/catalog/#группировка-ресурсов)).

**Что изменилось:**
- Ресурсы больше не группируются по префиксу в названии с разделителем `:`.
Expand All @@ -51,10 +52,10 @@ weight: 980
**Требуется ручная перенастройка:**
- Если у вас были ресурсы с группировкой по двоеточию (например, «Gitlab: группы», «Gitlab: проекты»), необходимо:
1. Создать родительский ресурс (например, «Gitlab»),
2. Убрать префикс из названий дочерних ресурсов (например, «Группы», «Проекты»),
3. Привязать дочерние ресурсы к родительскому через drag and drop в сайдбаре каталога (перетащить дочерний ресурс на родительский),
4. Скорректировать настройки ролевой модели, разрешить пользователям просмотр не только дочернего ресурса, но и всей иерархии родительских.
5. **Важно:** Идентификатор ресурса должен оставаться уникальным в пределах всей платформы и может сохранить префикс (например, `gitlab-groups`, `gitlab-projects`), в то время как название ресурса может быть любым.
1. Убрать префикс из названий дочерних ресурсов (например, «Группы», «Проекты»),
1. Привязать дочерние ресурсы к родительскому через drag and drop в сайдбаре каталога (перетащить дочерний ресурс на родительский),
1. Скорректировать настройки ролевой модели, разрешить пользователям просмотр не только дочернего ресурса, но и всей иерархии родительских.
1. **Важно:** Идентификатор ресурса должен оставаться уникальным в пределах всей платформы и может сохранить префикс (например, `gitlab-groups`, `gitlab-projects`), в то время как название ресурса может быть любым.

**Важно:**
- Название ресурса может быть любым, но идентификатор должен оставаться уникальным в пределах всей платформы.
Expand All @@ -77,20 +78,20 @@ weight: 980
Экспериментальный функционал
{{< /alert >}}

Добавлена поддержка AI-ассистента и MCP-сервера для интеграции с внешними AI моделями и клиентами.
Добавлена поддержка AI-ассистента и MCP-сервера для интеграции с внешними AI-моделями и клиентами.

#### AI-ассистент

**AI-ассистент** — интеллектуальный помощник, интегрированный в интерфейс платформы, который предоставляет пользователям доступ к AI-моделям через удобный чат-интерфейс ([подробнее](../../user/ai-assistant/)):

- **Настраиваемые провайдеры** — поддержка различных AI-провайдеров (OpenAI, локальные модели и др.).
- **Интеграция с MCP инструментами** — AI-ассистент автоматически использует доступные инструменты MCP-сервера для выполнения запросов.
- **Интеграция с MCP-инструментами** — AI-ассистент автоматически использует доступные инструменты MCP-сервера для выполнения запросов.

#### MCP-сервер

**MCP-сервер** — сервер, реализующий протокол MCP (Model Context Protocol) для предоставления инструментов внешним AI-клиентам ([подробнее](../../user/mcp-server/)):

- **Протокол MCP** — стандартизированный интерфейс для взаимодействия с AI моделями через JSON-RPC 2.0.
- **Протокол MCP** — стандартизированный интерфейс для взаимодействия с AI-моделями через JSON-RPC 2.0.
- **Доступные инструменты**:
- `get_resource_entities` — получение сущностей ресурсов платформы для анализа,
- `get_external_data` — выполнение HTTP-запросов к внешним сервисам (GitLab, SonarQube, Kubernetes и др.).
Expand All @@ -101,15 +102,11 @@ weight: 980

#### Kubernetes deployments

Обновлен виджет Kubernetes deployments ([подробнее](../../admin/widgets/types/#kubernetes-deployments)):

* Добавлена возможность просмотра и редактирования ресурсов контейнеров (CPU и Memory для requests и limits).
Обновлен виджет Kubernetes deployments ([подробнее](../../admin/widgets/types/#kubernetes-deployments)): добавлена возможность просмотра и редактирования ресурсов контейнеров (CPU и Memory для requests и limits).

#### Статистика событий

Обновлен виджет Статистика событий ([подробнее](../../admin/widgets/types/#статистика-событий)):

* Добавлена вкладка «События в Redis» для отслеживания событий, хранящихся в Redis Streams.
Обновлен виджет Статистика событий ([подробнее](../../admin/widgets/types/#статистика-событий)): добавлена вкладка «События в Redis» для отслеживания событий, хранящихся в Redis Streams.

#### CodeScoring виджеты

Expand Down Expand Up @@ -170,15 +167,11 @@ weight: 980

#### CodeScoring Vulnerabilities

Добавлена проверка статуса для CodeScoring ([подробнее](../../admin/healthchecks/types/#codescoring-vulnerabilities)):

- **CodeScoring Vulnerabilities** — проверка количества уязвимостей по метрикам CVSS2 и CVSS3 для проекта в CodeScoring с настраиваемыми пороговыми значениями для каждого уровня критичности.
Добавлена проверка статуса для CodeScoring ([подробнее](../../admin/healthchecks/types/#codescoring-vulnerabilities)): **CodeScoring Vulnerabilities** — проверка количества уязвимостей по метрикам CVSS2 и CVSS3 для проекта в CodeScoring с настраиваемыми пороговыми значениями для каждого уровня критичности.

#### SonarQube Quality Gate

Добавлена проверка статуса для SonarQube Quality Gate ([подробнее](../../admin/healthchecks/types/#sonarqube-quality-gate)):

- **SonarQube Quality Gate** — проверка статуса Quality Gate проекта в SonarQube.
Добавлена проверка статуса для SonarQube Quality Gate ([подробнее](../../admin/healthchecks/types/#sonarqube-quality-gate)): **SonarQube Quality Gate** — проверка статуса Quality Gate проекта в SonarQube.

### Действия

Expand All @@ -191,11 +184,11 @@ weight: 980

#### GitLab

- **CreateGitlabRelease** — позволяет создавать релизы на основе существующих тегов GitLab ([подробнее](../../admin/actions/types/#creategitlabrelease)).
**CreateGitlabRelease** — позволяет создавать релизы на основе существующих тегов GitLab ([подробнее](../../admin/actions/types/#creategitlabrelease)).

#### Vault

- **CreateVaultSecret** расширена опция `allow_update`: добавлено значение `merge`. При выставлении значения `merge` обновляются или создаются только те ключи секрета, которые указаны в действии. Существующие ключи, не упомянутые в действии, сохраняются без изменений.
**CreateVaultSecret** расширена опция `allow_update`: добавлено значение `merge`. При выставлении значения `merge` обновляются или создаются только те ключи секрета, которые указаны в действии. Существующие ключи, не упомянутые в действии, сохраняются без изменений.

### Шаблонизация

Expand Down
1 change: 1 addition & 0 deletions content/documentation/release-notes/v1.1.1.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.1.1
weight: 970
description: Заметки о выпуске v1.1.1 — исправления сценариев и командных переменных.
---

{{< alert level="info" >}}
Expand Down
3 changes: 2 additions & 1 deletion content/documentation/release-notes/v1.2.0.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.2.0
weight: 960
description: Заметки о выпуске v1.2.0 — иконки, AI-ассистент, действия Nexus, владение объектами, роли и исправления.
---

{{< alert level="info" >}}
Expand All @@ -17,7 +18,7 @@ weight: 960

### AI-ассистент

Добавлен механизм безопасного хранения учетных данных для AI-провайдеров ([подробнее](../../user/ai-assistant/#учетные-данные-для-провайдеров)).
Добавлен механизм безопасного хранения учётных данных для AI-провайдеров ([подробнее](../../user/ai-assistant/#учетные-данные-для-провайдеров)).

### Действия

Expand Down
1 change: 1 addition & 0 deletions content/documentation/release-notes/v1.2.1.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.2.1
weight: 950
description: Заметки о выпуске v1.2.1 — улучшения вебхук-действий и учётных данных пользователя.
---

{{< alert level="info" >}}
Expand Down
5 changes: 2 additions & 3 deletions content/documentation/release-notes/v1.3.0.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.3.0
weight: 940
description: Заметки о выпуске v1.3.0 — источники данных, виджеты, процессы, каталог, роли, параметры, учётные данные и предупреждение об удалении Kubernetes-источников.
---

{{< alert level="info" >}}
Expand Down Expand Up @@ -62,6 +63,4 @@ weight: 940

## Предупреждение об удалении

В релизе 1.4.0 будут удалены следующие механизмы:

- Источники данных для конкретных ресурсов Kubernetes: `KubernetesNamespaces`, `KubernetesDeployments`, `KubernetesIngresses`, `KubernetesPods` — для замены рекомендуется использовать общий источник данных [KubernetesResources](../../admin/datasources/types/#kubernetesresources).
В релизе 1.4.0 будут удалены механизмы источников данных для конкретных ресурсов Kubernetes: `KubernetesNamespaces`, `KubernetesDeployments`, `KubernetesIngresses`, `KubernetesPods`. Для замены рекомендуется использовать общий источник данных [KubernetesResources](../../admin/datasources/types/#kubernetesresources).
1 change: 1 addition & 0 deletions content/documentation/release-notes/v1.3.1.ru.md
Original file line number Diff line number Diff line change
@@ -1,6 +1,7 @@
---
title: v1.3.1
weight: 935
description: Заметки о выпуске v1.3.1 — исправление отображения дочерних ресурсов в каталоге.
---

{{< alert level="info" >}}
Expand Down
Loading
Loading