Skip to content

Commit 2e696e0

Browse files
DDP-fix-release-notes (#197)
* fix Signed-off-by: sidorok <a.sidorok@me.com> * Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> * Apply suggestions from code review Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> --------- Signed-off-by: sidorok <a.sidorok@me.com> Signed-off-by: Anastasia Sidorok <a.sidorok@me.com> Co-authored-by: Lada Lysenko <127337005+Lada7878@users.noreply.github.com>
1 parent dd123dd commit 2e696e0

12 files changed

Lines changed: 48 additions & 44 deletions

File tree

.cursor/rules/docs/global-style.mdc

Lines changed: 6 additions & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -45,3 +45,9 @@ alwaysApply: true
4545
- Do not use first-level heading (`# ...`) in documentation files.
4646
- Minimum allowed heading level is second-level (`## ...`).
4747
- If a local checklist conflicts with full policy text, follow `.cursor/rules/docs/refs-editorial-policy-full.mdc`.
48+
49+
# Release notes (`content/documentation/release-notes/`)
50+
51+
- 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).
52+
- If there is a lead-in paragraph and exactly one bullet, merge them into continuous prose and drop the list marker.
53+
- When there are two or more top-level bullets under the same heading, keep a Markdown list.
Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,5 +1,6 @@
11
---
22
title: История изменений
33
weight: 80
4+
description: Сводка релизов Deckhouse Development Platform и ссылки на заметки о выпусках по версиям.
45
---
56

content/documentation/release-notes/v1.0.0.ru.md

Lines changed: 5 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.0.0
33
weight: 1000
4+
description: Заметки о выпуске v1.0.0 — виджеты, источники данных, действия, наборы данных, внешние сервисы, роли и исправления.
45
---
56

67
{{< alert level="info" >}}
@@ -83,7 +84,7 @@ weight: 1000
8384

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

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

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

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

Lines changed: 4 additions & 5 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.0.1
33
weight: 990
4+
description: Заметки о выпуске v1.0.1 — действия HashiCorp Vault и исправления.
45
---
56

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

1415
#### HashiCorp Vault
1516

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

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

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

24-
- Исправлена ошибка с датой создания действия при его перезапуске.
23+
Исправлена ошибка с датой создания действия при его перезапуске.

content/documentation/release-notes/v1.1.0.ru.md

Lines changed: 17 additions & 24 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.1.0
33
weight: 980
4+
description: Заметки о выпуске v1.1.0 — несовместимые изменения, AI-ассистент, MCP, виджеты, воркеры, проверки статуса, действия, шаблонизация и исправления.
45
---
56

67
{{< alert level="info" >}}
@@ -26,7 +27,7 @@ weight: 980
2627
enabled: false
2728
```
2829
29-
2. Или настройте политики для поддержки iframe виджетов и внешних изображений:
30+
1. Или настройте политики для поддержки iframe виджетов и внешних изображений:
3031
3132
```yaml
3233
security:
@@ -37,11 +38,11 @@ weight: 980
3738
allowExternalImages: true
3839
```
3940
40-
Подробнее о настройке заголовков безопасности см. в [документации](../../admin/security/http-security-headers/).
41+
Подробнее о настройке заголовков безопасности в [документации](../../admin/security/http-security-headers/).
4142
4243
### Группировка ресурсов в каталоге
4344
44-
Изменен механизм группировки ресурсов в каталоге. Ранее ресурсы группировались по префиксу в названии с разделителем `:` (например, «Gitlab: группы», «Gitlab: проекты»). Теперь группировка осуществляется через иерархическую структуру с использованием родительских ресурсов ([подробнее](../../user/catalog/#группировка-ресурсов)).
45+
Изменён механизм группировки ресурсов в каталоге. Ранее ресурсы группировались по префиксу в названии с разделителем `:` (например, «Gitlab: группы», «Gitlab: проекты»). Теперь группировка осуществляется через иерархическую структуру с использованием родительских ресурсов ([подробнее](../../user/catalog/#группировка-ресурсов)).
4546

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

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

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

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

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

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

8990
#### MCP-сервер
9091

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

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

102103
#### Kubernetes deployments
103104

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

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

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

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

@@ -170,15 +167,11 @@ weight: 980
170167

171168
#### CodeScoring Vulnerabilities
172169

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

177172
#### SonarQube Quality Gate
178173

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

183176
### Действия
184177

@@ -191,11 +184,11 @@ weight: 980
191184

192185
#### GitLab
193186

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

196189
#### Vault
197190

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

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

content/documentation/release-notes/v1.1.1.ru.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.1.1
33
weight: 970
4+
description: Заметки о выпуске v1.1.1 — исправления сценариев и командных переменных.
45
---
56

67
{{< alert level="info" >}}

content/documentation/release-notes/v1.2.0.ru.md

Lines changed: 2 additions & 1 deletion
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.2.0
33
weight: 960
4+
description: Заметки о выпуске v1.2.0 — иконки, AI-ассистент, действия Nexus, владение объектами, роли и исправления.
45
---
56

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

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

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

2223
### Действия
2324

content/documentation/release-notes/v1.2.1.ru.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.2.1
33
weight: 950
4+
description: Заметки о выпуске v1.2.1 — улучшения вебхук-действий и учётных данных пользователя.
45
---
56

67
{{< alert level="info" >}}

content/documentation/release-notes/v1.3.0.ru.md

Lines changed: 2 additions & 3 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.3.0
33
weight: 940
4+
description: Заметки о выпуске v1.3.0 — источники данных, виджеты, процессы, каталог, роли, параметры, учётные данные и предупреждение об удалении Kubernetes-источников.
45
---
56

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

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

65-
В релизе 1.4.0 будут удалены следующие механизмы:
66-
67-
- Источники данных для конкретных ресурсов Kubernetes: `KubernetesNamespaces`, `KubernetesDeployments`, `KubernetesIngresses`, `KubernetesPods` — для замены рекомендуется использовать общий источник данных [KubernetesResources](../../admin/datasources/types/#kubernetesresources).
66+
В релизе 1.4.0 будут удалены механизмы источников данных для конкретных ресурсов Kubernetes: `KubernetesNamespaces`, `KubernetesDeployments`, `KubernetesIngresses`, `KubernetesPods`. Для замены рекомендуется использовать общий источник данных [KubernetesResources](../../admin/datasources/types/#kubernetesresources).

content/documentation/release-notes/v1.3.1.ru.md

Lines changed: 1 addition & 0 deletions
Original file line numberDiff line numberDiff line change
@@ -1,6 +1,7 @@
11
---
22
title: v1.3.1
33
weight: 935
4+
description: Заметки о выпуске v1.3.1 — исправление отображения дочерних ресурсов в каталоге.
45
---
56

67
{{< alert level="info" >}}

0 commit comments

Comments
 (0)