From 4bb2e0c4780e839703af6b798fd350313c57726d Mon Sep 17 00:00:00 2001 From: Nikita Velgin Date: Tue, 10 Nov 2026 12:06:01 +0300 Subject: [PATCH] docs: release v1.8.0 --- content/documentation/admin/ai-pdlc.ru.md | 71 +++++++++++ content/documentation/admin/datasets.ru.md | 18 +-- .../admin/examples/home-custom-catalog.ru.md | 1 - .../documentation/admin/home/mapping.ru.md | 20 ++-- .../documentation/admin/home/overview.ru.md | 4 +- content/documentation/admin/overview.ru.md | 1 + .../admin/processes/decisions.ru.md | 39 ++++++ .../admin/processes/overview.ru.md | 13 +- .../documentation/admin/security/rbac.ru.md | 18 ++- .../documentation/release-notes/v1.8.0.ru.md | 113 +++++++++++++----- content/documentation/user/credentials.ru.md | 11 +- .../user/home/applications.ru.md | 87 ++++++++++++++ .../user/home/architecture.ru.md | 79 ++++++------ .../documentation/user/home/decisions.ru.md | 25 ++++ .../user/home/microservices.ru.md | 5 +- .../documentation/user/home/overview.ru.md | 10 +- content/documentation/user/home/teams.ru.md | 38 ++---- content/documentation/user/overview.ru.md | 2 + 18 files changed, 416 insertions(+), 139 deletions(-) create mode 100644 content/documentation/admin/ai-pdlc.ru.md create mode 100644 content/documentation/admin/processes/decisions.ru.md create mode 100644 content/documentation/user/home/applications.ru.md create mode 100644 content/documentation/user/home/decisions.ru.md diff --git a/content/documentation/admin/ai-pdlc.ru.md b/content/documentation/admin/ai-pdlc.ru.md new file mode 100644 index 00000000..8bd9f009 --- /dev/null +++ b/content/documentation/admin/ai-pdlc.ru.md @@ -0,0 +1,71 @@ +--- +title: Настройка AI PDLC +weight: 73 +description: Подключение приложений каталога к AI PDLC, настройка набора данных, согласующих и автоматического развёртывания выпусков. +--- + +AI PDLC связывает приложение каталога, рабочее пространство с агентом и процесс изменения. Пользователь ставит задачу, согласует спецификацию, проверяет MR в GitLab и отслеживает выпуск. Порядок работы описан в руководстве [«Приложения и изменения»](../user/home/applications/). + +## Подготовка + +Перед применением набора данных подготовьте: + +1. Внешние сервисы GitLab и Kubernetes. Backend и worker должны иметь доступ к ним. +1. Неймспейс рабочих пространств, [домен IDE, DNS и TLS](workspaces/overview/). +1. Сервисную учётную запись DDP с токеном Kubernetes для запуска рабочих пространств. Этот токен используется в пространствах всех пользователей AI PDLC. +1. Ресурс приложений в [маппинге главной](home/mapping/) с ролью «Микросервис». Назначьте его параметрам роли «Репозиторий микросервиса» и «Ветка по умолчанию микросервиса» и заполните значения у приложений. +1. Ресурс с ролью главной «Окружение» для связи с окружением выпуска. +1. Роль пользователей с глобальными разрешениями `read:entities`, `create:workspaces`, `use:ai-agents`, `use:workspace-templates` и `create:pdlc-changes`. Назначьте роль участникам. + +У каждого пользователя должны быть собственные токен GitLab и AI-провайдер в профиле. Личный токен Kubernetes пользователю AI PDLC не требуется. + +## Применение набора + +В разделе «Администрирование» → «Наборы данных» найдите «AI PDLC», нажмите «Применить» и заполните параметры: + +| Параметр | Что указать | +| --- | --- | +| «Подключение GitLab» | Внешний сервис с репозиториями приложений | +| «Подключение Kubernetes» | Внешний сервис кластера рабочих пространств | +| «Namespace рабочих пространств» | Подготовленный неймспейс | +| «Домен IDE» | Домен с DNS и TLS для поддоменов рабочих пространств | +| «Учётная запись Kubernetes» | Сервисная учётная запись с токеном Kubernetes | +| «Роль пользователей PDLC» | Роль с перечисленными выше глобальными разрешениями | +| «Ресурс приложений» | Ресурс с настроенной ролью репозитория в маппинге главной | +| «Рабочих пространств на пользователя» | Лимит одновременно запущенных пространств одного пользователя | +| «Рабочих пространств всего» | Общий лимит запущенных пространств | +| «Срок работы рабочего пространства, часы» | Срок от 1 до 720 часов | + +Набор проверяет разрешения выбранной роли, но не выдаёт их. При ошибке добавьте недостающие разрешения и повторите применение. + +Набор создаёт шаблон рабочего пространства «AI PDLC», навыки `pdlc-spec` и `pdlc-implement`, процесс «AI PDLC: изменение приложения» с действиями и включает возможность «AI PDLC» на выбранном ресурсе. + +## Настройка приложения + +В карточке сущности приложения заполните репозиторий и ветку по умолчанию. Включённая возможность AI PDLC добавляет параметр «Согласующие спецификаций» и связь «Окружение выпуска». + +Укажите пользователей в «Согласующие спецификаций», если спецификацию должен проверять кто-то кроме автора. При пустом списке согласует автор изменения; при нескольких пользователях достаточно ответа одного. + +В секции связей выберите одно «Окружение выпуска». Несколько окружений дают неоднозначный выбор и не запускают автоматическое развёртывание. + +Для развёртывания настройте слот «Развернуть микросервис на окружение» в маппинге главной: процесс шаблона приложения либо единственный процесс для приложения без шаблона. DDP передаёт этому процессу приложение и выбранное окружение. Успешное завершение процесса переводит выпуск в «Развёрнут». + +Блок «Готовность к AI PDLC» на странице приложения помогает проверить настройки. Приложения без репозитория не появляются в списке. + +## Создание приложений из шаблонов + +Для кнопки «Новое приложение» дополнительно настройте [реестр шаблонов](templates/registry/) и процесс слота «Создать микросервис» для каждого используемого шаблона. Процесс должен зарегистрировать созданную сущность в ресурсе приложений. + +Пользователям требуются `read:template-packs` и `control:processes` глобально или для ресурса систем. Набор AI PDLC эти разрешения не проверяет. Процесс развёртывания назначьте отдельно: без него создание приложения работает, но выпуски не развёртываются. + +Выбранное при создании окружение DDP записывает связью после регистрации приложения. Если у ресурса нет нужной связи, пользователь получает сообщение и может задать её в карточке приложения. + +## Доступ + +Приложения, их выпуски и показатели доступны пользователям, которые могут читать соответствующую сущность. Для изменений действуют отдельные [разрешения AI PDLC](security/rbac/#изменения-ai-pdlc). Адресат решения получает доступ к изменению и спецификации, но не к рабочему пространству автора. + +## Повторное применение и удаление + +Повторное применение заменяет лимиты рабочих пространств и срок работы значениями из формы, включая ранее изменённые вручную. При выборе другого ресурса процесс изменения переносится на него, а возможность AI PDLC на прежнем ресурсе остаётся включённой, пока её не отключат в форме ресурса. + +Удаление набора архивирует шаблон и навыки, удаляет процесс изменения с действиями и выключает возможность AI PDLC на ресурсах. Параметр согласующих, связь окружения с их значениями, выпуски, рабочие пространства, лимиты и срок работы сохраняются. Удаляйте ненужные рабочие пространства [отдельно](../user/workspaces/#удаление). diff --git a/content/documentation/admin/datasets.ru.md b/content/documentation/admin/datasets.ru.md index b9bbf5a5..eb693b43 100644 --- a/content/documentation/admin/datasets.ru.md +++ b/content/documentation/admin/datasets.ru.md @@ -58,12 +58,16 @@ weight: 74 ### Первоначальная настройка Кнопка «Первоначальная настройка» открывает мастер, который применяет наборы данных «Каноничной архитектуры» для главной одним запуском: модель каталога, правила маппинга, подключения к Kubernetes, Vault и GitLab, источники данных, процессы и виджеты. -Мастер и наборы данных, которые он применяет, описаны в разделе [«Первоначальная настройка»](../home/setup/). +Мастер и наборы данных, которые он применяет, описаны в разделе [«Первоначальная настройка»](home/setup/). Переключатель «Показывать баннер первоначальной настройки» возвращает на главную баннер «Платформа готова к настройке», скрытый кнопкой «Скрыть». ## Доступные наборы данных +### AI PDLC + +Набор «AI PDLC» подготавливает рабочее пространство приложения с навыками спецификации и реализации, процесс изменения, согласующих и связь с окружением выпуска. Требования, параметры и поведение повторного применения описаны в руководстве [«Настройка AI PDLC»](ai-pdlc/). + ### GitLab Набор данных предназначен для подключения к API GitLab. @@ -82,7 +86,7 @@ weight: 74 После применения заполните в профиле пользователя учётные данные «GitLab токен» и «GitLab username». -Группы и виджеты GitLab для главной создают наборы данных «GitLab: группы» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](../home/setup/#наборы-данных-мастера). +Группы и виджеты GitLab для главной создают наборы данных «GitLab: группы» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](home/setup/#наборы-данных-мастера). ### Kubernetes @@ -112,7 +116,7 @@ weight: 74 Настройка: -Набор данных настраивает подключение к API Vault через внешний сервис с авторизацией по заголовку `X-Vault-Token`. Подробнее о формате авторизации — в разделе [«Внешние сервисы»](../external-services/#vault). +Набор данных настраивает подключение к API Vault через внешний сервис с авторизацией по заголовку `X-Vault-Token`. Подробнее о формате авторизации — в разделе [«Внешние сервисы»](external-services/#vault). {{< alert level="info" >}} После применения укажите в профиле суперадминистратора токен Vault в учётных данных «Vault токен». @@ -132,7 +136,7 @@ weight: 74 1. Заполните учётные данные «Vault токен». 1. Подключите внешний сервис «Vault» к действиям, виджетам или источникам данных, которые обращаются к API Vault. -После этого запросы через внешний сервис будут использовать токен из учётных данных пользователя. Например, внешний сервис можно подключить к виджету [«Секреты Vault»](../widgets/generic/vault/) для просмотра секретов в KV v2. +После этого запросы через внешний сервис будут использовать токен из учётных данных пользователя. Например, внешний сервис можно подключить к виджету [«Секреты Vault»](widgets/generic/vault/) для просмотра секретов в KV v2. ### Deckhouse managed PostgreSQL @@ -142,7 +146,7 @@ weight: 74 Настройка: -Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). +Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold). {{< alert level="info" >}} Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». @@ -169,7 +173,7 @@ weight: 74 Настройка: -Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). +Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold). {{< alert level="info" >}} Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». @@ -196,7 +200,7 @@ weight: 74 Настройка: -Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold). +Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold). {{< alert level="info" >}} Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных». diff --git a/content/documentation/admin/examples/home-custom-catalog.ru.md b/content/documentation/admin/examples/home-custom-catalog.ru.md index 168d4db5..7976f21e 100644 --- a/content/documentation/admin/examples/home-custom-catalog.ru.md +++ b/content/documentation/admin/examples/home-custom-catalog.ru.md @@ -26,7 +26,6 @@ description: Настройка правил маппинга главной DDP | Роль | Объект каталога | | --- | --- | | `system` | Ресурс «Продукты» | -| `system_domain` | Параметр `domain` ресурса «Продукты» | | `system_lifecycle` | Параметр `status` ресурса «Продукты» | | `microservice` | Ресурс «Сервисы» | | `microservice_language` | Параметр `lang` ресурса «Сервисы» | diff --git a/content/documentation/admin/home/mapping.ru.md b/content/documentation/admin/home/mapping.ru.md index e8263c01..d7a16638 100644 --- a/content/documentation/admin/home/mapping.ru.md +++ b/content/documentation/admin/home/mapping.ru.md @@ -105,20 +105,19 @@ description: Справочник по наборам маппинга глав | Область | Раздел главной | Роль ресурса | Роли связей | Роли свойств | Слоты | | --- | --- | --- | --- | --- | --- | -| «Системы» | «Системы» | `system` | `has_ingress`, `system_has_deployment`, `system_has_integration` | `system_domain`, `system_lifecycle` | — | +| «Системы» | «Системы» | `system` | `has_ingress`, `system_has_deployment`, `system_has_integration` | `system_lifecycle` | — | | «Микросервисы» | «Микросервисы» | `microservice` (несколько ресурсов) | `contains_service`, `has_deployment` | `microservice_*` | `deploy_microservice`, `delete_microservice`; действия по шаблонам; слоты виджетов | | «Окружения» | «Окружения» | `environment` | `environment_hosts_ingress` | `environment_type`, `environment_ttl`, `environment_marked_for_deletion`, `environment_domain` | `create_environment`, `delete_environment` | | «Общие ресурсы» | «Заказ ресурсов» | `shared_resource` (несколько ресурсов) | `contains_shared`, `shared_has_deployment` | `shared_environment`, `shared_kind`, `shared_provider` | `order_resource`, `connect_shared_resource`, `disconnect_shared_resource`, `delete_shared_resource` | | «Развёртывания» | «Развертывание систем» | `deployment` | `deployment_in_environment` | `deployment_*` | — | | «Ingress» | «Развертывание систем» | `ingress` | `ingress_routes_to` | `ingress_host`, `ingress_routes` | — | | «Кластеры» | «Кластеры и сети» | `cluster` | `cluster_hosts_environment` | `cluster_region`, `cluster_provider` | — | -| «Гайды» | «Как работает платформа» | `guide` | — | `guide_category`, `guide_video_url`, `guide_doc_url` | — | | «Интеграции» | «Интеграции» | `integration` | `integration_targets_system` | `integration_criticality`, `integration_link_type` | — | | «Пространства в системе контроля версий» | «Создать микросервис» | `vcs_namespace` | — | `vcs_namespace_id` | — | Если в наборе есть ключи, которые не относятся к известным областям, форма показывает их в области «Прочее». -Разделы «Команды», «Диаграммы» и «Потребление ресурсов» собственных областей не имеют и используют роли других областей. +Разделы «Команды» и «Потребление ресурсов» собственных областей не имеют и используют роли других областей. ## Роли ресурсов @@ -133,7 +132,6 @@ description: Справочник по наборам маппинга глав | `deployment` | «Развёртывание» | Развёртывания микросервисов и систем на окружениях | «Deployments» (`kubernetes-deployments`) | | `ingress` | «Ingress» | Точки входа на схеме развёртывания | «Ingresses» (`kubernetes-ingresses`) | | `cluster` | «Кластер» | Кластеры, в которых размещены окружения | «Кластеры» (`clusters`) | -| `guide` | «Гайд» | Карточки раздела «Как работает платформа» | «Справка» (`guides`) | | `integration` | «Интеграция» | Интеграции между системами | «Интеграции» (`integrations`) | | `vcs_namespace` | «Пространство в системе контроля версий» | Группы, в которых создаются репозитории микросервисов | «Groups» (`gitlab-groups`) | @@ -164,23 +162,19 @@ description: Справочник по наборам маппинга глав Роль свойства содержит идентификатор параметра сущности. Параметр выбирается из параметров ресурса родительской роли: для `system_*` — ресурса роли `system`, для `microservice_*` — ресурса роли `microservice` и т. д. -### Системы, интеграции, кластеры, гайды +### Системы, интеграции и кластеры -Роли свойств систем, интеграций, кластеров и гайдов: +Роли свойств систем, интеграций и кластеров: | Роль | Название в форме | Где отображается | Каноничный параметр | | --- | --- | --- | --- | -| `system_domain` | «Домен системы» | Дерево «Домены» в разделе «Системы», колонка «Домен» в разделе «Микросервисы» | `domain` | -| `system_lifecycle` | «Жизненный цикл системы» | «Жизненный цикл» на вкладке «Справка» системы | `lifecycle` | -| `integration_criticality` | «Критичность интеграции» | «Критичность» интеграции, карточка «Критичные связи» | `criticality` | +| `system_lifecycle` | «Жизненный цикл системы» | Жизненный цикл в профиле системы и фильтр списка | `lifecycle` | +| `integration_criticality` | «Критичность интеграции» | Критичность в профиле интеграции и фильтр списка | `criticality` | | `integration_link_type` | «Тип связи интеграции» | «Тип связи» интеграции | `link_type` | | `cluster_region` | «Регион кластера» | Карточка кластера | `region` | | `cluster_provider` | «Провайдер кластера» | Карточка кластера | `provider` | -| `guide_category` | «Категория гайда» | Группировка и фильтр гайдов | `category` | -| `guide_video_url` | «URL видео гайда» | Кнопка «Смотреть видео» | `video_url` | -| `guide_doc_url` | «URL документации гайда» | Кнопка «Открыть документацию» | `doc_url` | -Интеграция считается критичной, если значение параметра `integration_criticality` равно `high` без учёта регистра. +Критичность описывает значение интеграции для системы; результаты проверок её состояния отображаются отдельно. ### Микросервисы diff --git a/content/documentation/admin/home/overview.ru.md b/content/documentation/admin/home/overview.ru.md index c21bfe6c..9bf17e60 100644 --- a/content/documentation/admin/home/overview.ru.md +++ b/content/documentation/admin/home/overview.ru.md @@ -83,12 +83,12 @@ flowchart LR | Группа | Раздел | Роли ресурсов | Слоты действий и действия по шаблонам | | --- | --- | --- | --- | | AI-инструменты | [«Рабочие пространства»](../../user/workspaces/) | Правила маппинга не требуются | — | +| AI-инструменты | [«Приложения»](../ai-pdlc/) | `microservice`, `environment`; возможность AI PDLC | Процесс изменения; создание и развёртывание по шаблону | +| AI-инструменты | [«Решения»](../processes/decisions/) | Правила маппинга не требуются | — | | Организация | «Команды» | Команды портала; `system`, `microservice` | — | | Архитектура | «Системы» | `system`, `microservice`, `shared_resource`, `deployment`, `environment`, `cluster`, `integration` | — | | Архитектура | «Интеграции» | `system`, `integration` | — | -| Архитектура | «Диаграммы» | `system`, `microservice`, `shared_resource` | — | | Архитектура | «Кластеры и сети» | `cluster`, `environment` | — | -| Архитектура | «Как работает платформа» | `guide` | — | | Разработка | «Создать микросервис» | `system`, `vcs_namespace` | Действие по шаблону «Создать микросервис» | | Разработка | «Микросервисы» | `microservice`, `system`, `shared_resource`, `deployment`, `environment`, `cluster` | Действие по шаблону «Обновить микросервис из шаблона»; слоты виджетов вкладок «Пайплайны» и «MRs» | | Разработка | «Развертывание систем» | `system`, `microservice`, `environment`, `shared_resource`, `ingress`, `deployment` | `deploy_microservice`, `delete_microservice`, `order_resource`, `connect_shared_resource`, `disconnect_shared_resource`, `delete_shared_resource`; действия по шаблону «Развернуть микросервис на окружение» и «Удалить микросервис с окружения» | diff --git a/content/documentation/admin/overview.ru.md b/content/documentation/admin/overview.ru.md index 9659cbae..de911412 100644 --- a/content/documentation/admin/overview.ru.md +++ b/content/documentation/admin/overview.ru.md @@ -8,6 +8,7 @@ weight: 10 Для настройки новых сценариев используйте руководства: +- [Настройка AI PDLC](ai-pdlc/): приложения, согласование изменений и автоматические выпуски. - [Подготовка рабочих пространств](workspaces/overview/): подключения, сеть, хранилище и лимиты. - [Создание шаблона](workspaces/templates/): проект OpenTofu, параметры, публикация и активация. - [Файлы и скрипты](workspaces/files/) и [образы, Ingress и хранение](workspaces/network-storage/): примеры изменения стартового шаблона. diff --git a/content/documentation/admin/processes/decisions.ru.md b/content/documentation/admin/processes/decisions.ru.md new file mode 100644 index 00000000..09a84ec6 --- /dev/null +++ b/content/documentation/admin/processes/decisions.ru.md @@ -0,0 +1,39 @@ +--- +title: Решение в процессе +weight: 25 +description: Настройка вопроса пользователям, вариантов ответа и ветвления процесса по принятому решению. +--- + +Элемент «Решение» приостанавливает выполнение своей ветки до ответа пользователя. Он подходит для согласования спецификации или выбора дальнейших действий. В отличие от подтверждения запуска действия, решение сохраняет выбранный вариант и комментарий в [хранилище процесса](store/). + +## Настройка элемента + +Добавьте «Решение» на схему процесса и заполните его конфигурацию: + +| Поле | Значение | +| --- | --- | +| «Вопрос» | Обязательный Go-шаблон текста, который увидит пользователь | +| «Адресат» | Go-шаблон, возвращающий email или UUID пользователя; несколько значений разделяются запятыми. Пустое поле означает инициатора запуска | +| «Варианты» | От двух до пяти ответов. У каждого должны быть уникальный непустой «Ключ» и «Название» для пользователя | +| «Ключ store» | Обязательный путь в хранилище без ведущей точки, например `approval` | + +У элемента должна быть ровно одна исходящая связь. Для ветвления разместите после него [эксклюзивный шлюз](overview/#эксклюзивный-шлюз). + +## Результат + +Если «Ключ store» равен `approval`, после ответа доступны значения: + +| Выражение | Содержимое | +| --- | --- | +| `{{ .store.approval.option }}` | Ключ выбранного ответа | +| `{{ .store.approval.comment }}` | Комментарий пользователя | +| `{{ .store.approval.decidedBy }}` | Email ответившего пользователя | +| `{{ .store.approval.decidedAt }}` | Время принятия решения | + +Например, создайте ответы с ключами `approve` и `revise`. В условии шлюза сравните `{{ .store.approval.option }}` со строкой `approve`: положительная ветка продолжит выполнение, другая направит процесс на доработку. + +## Работа с решениями + +Адресаты отвечают в запуске процесса или в разделе [«Главная» → «AI-инструменты» → «Решения»](../../user/home/decisions/). Если адресатов несколько, достаточно ответа одного. Ответ принимается только один раз. + +Право управлять процессом не заменяет участие в решении. Ответить может адресат или суперадминистратор; если все адресаты удалены, остаётся только суперадминистратор. При остановке процесса ожидающие решения отменяются. diff --git a/content/documentation/admin/processes/overview.ru.md b/content/documentation/admin/processes/overview.ru.md index e796b276..9e0ae403 100644 --- a/content/documentation/admin/processes/overview.ru.md +++ b/content/documentation/admin/processes/overview.ru.md @@ -15,6 +15,7 @@ description: Создание и запуск процессов — элеме * «Начало» — точка входа в процесс. * «Действие» — выполнение конкретного действия. * «AI-агент» — отправка задачи AI-агенту и запись его ответа в хранилище процесса. +* [«Решение»](decisions/) — вопрос пользователям с вариантами ответа и записью решения в хранилище. * «Эксклюзивный шлюз» — условное ветвление. * «Параллельный шлюз» — объединение нескольких веток процесса в одну. * «Цикл» — повторение части процесса фиксированное число раз или обход JSON-массива из хранилища. @@ -35,7 +36,7 @@ description: Создание и запуск процессов — элеме * «Название» — название процесса, от 3 до 64 символов. * «Описание» — подробное описание назначения процесса. -* «Ресурс» — один или несколько ресурсов, для сущностей которых может запускаться процесс. Процесс без ресурсов не запускается. Запуск для сущности другого ресурса, в том числе через API и MCP-сервер портала, отклоняется с ошибкой `422`. [Автоматизацию](../../automations/#выполнение) с процессом, не привязанным к ресурсам, для сущностей которых она его запускает, сохранить нельзя, а [автоматическое обновление из шаблона](../../templates/updates/#автоматическое-обновление) пропускает микросервисы, к ресурсу которых процесс обновления не привязан. +* «Ресурс» — один или несколько ресурсов, для сущностей которых может запускаться процесс. Процесс без ресурсов не запускается. Запуск для сущности другого ресурса, в том числе через API и MCP-сервер портала, отклоняется с ошибкой `422`. [Автоматизацию](../automations/#выполнение) с процессом, не привязанным к ресурсам, для сущностей которых она его запускает, сохранить нельзя, а [автоматическое обновление из шаблона](../templates/updates/#автоматическое-обновление) пропускает микросервисы, к ресурсу которых процесс обновления не привязан. * «Владелец» — пользователь, ответственный за процесс. * «Команда-владелец» — команда, ответственная за процесс. * «Теги» — теги для категоризации процесса. @@ -53,7 +54,7 @@ description: Создание и запуск процессов — элеме Чтобы добавить элементы на схему: -1. Добавьте элемент, выбрав его тип на панели редактора. Элементы сгруппированы на панели по назначению: «Поток» («Начало», «Конец», «Ошибка»), «Работа» («Действие», «AI-агент», «Шаблон», «Источник данных»), «Ветвление» (шлюзы), «Время» («Таймер», «Цикл») и «Разметка» («Примечание»). +1. Добавьте элемент, выбрав его тип на панели редактора. Элементы сгруппированы на панели по назначению: «Поток» («Начало», «Конец», «Ошибка»), «Работа» («Действие», «AI-агент», «Решение», «Шаблон», «Источник данных»), «Ветвление» (шлюзы), «Время» («Таймер», «Цикл») и «Разметка» («Примечание»). 1. Настройте параметры элемента в боковой панели (действие, условия и др.). 1. Свяжите элементы друг с другом. @@ -67,7 +68,7 @@ description: Создание и запуск процессов — элеме Поле «Таймаут (секунды)» задаёт, сколько ждать завершения действия. Если поле не заполнено, ожидание длится 60 минут. По истечении действие отменяется, а задача получает статус `Timeout`. -Если действие не запустилось из-за [условий выполнения](../../actions/overview/#условия-выполнения), задача получает статус `Declined` и обрабатывается так же, как задача, завершившаяся ошибкой: если из неё выходит связь к эксклюзивному шлюзу или связь с условием, процесс продолжается по исходящим связям, иначе ветка процесса на этой задаче завершается. +Если действие не запустилось из-за [условий выполнения](../actions/overview/#условия-выполнения), задача получает статус `Declined` и обрабатывается так же, как задача, завершившаяся ошибкой: если из неё выходит связь к эксклюзивному шлюзу или связь с условием, процесс продолжается по исходящим связям, иначе ветка процесса на этой задаче завершается. Если пользователь отменил действие задачи, ветка процесса на этой задаче завершается без перехода по исходящим связям, а отмена учитывается в [итоговом статусе процесса](#статусы-процесса). @@ -349,7 +350,7 @@ AI-провайдер ищется по названию среди провай - **Одно хранилище на запуск** — у каждого экземпляра процесса своё хранилище; его можно просмотреть на вкладке «Хранилище» при визуализации запуска. - **Вложенные пути** — ключи задаются через точку: `notification.module_name`, `ctx.job.id`; поддерживаются индексы массивов: `items[0].status`. -- **Запись по правилам** — данные попадают в хранилище после успешного выполнения действия или при проходе элементов «Шаблон» и «AI-агент». Доступны операции записи строки и JSON, добавления, слияния и удаления, а также условие на каждое правило. Настройка правил в действии описана в разделе [«Обновление хранилища процесса»](../../actions/overview/#обновление-хранилища-процесса). +- **Запись по правилам** — данные попадают в хранилище после успешного выполнения действия или при проходе элементов «Шаблон» и «AI-агент». Доступны операции записи строки и JSON, добавления, слияния и удаления, а также условие на каждое правило. Настройка правил в действии описана в разделе [«Обновление хранилища процесса»](../actions/overview/#обновление-хранилища-процесса). - **Чтение** — Go-шаблоны `{{ .store.<путь> }}` в конфигурации действий и условиях шлюзов. Синтаксис описан в разделе [«Хранилище процесса»](../../user/templating/#хранилище-процесса) страницы «Шаблонизация». Если ключа нет в хранилище, шаблон `{{ .store.<путь> }}` завершит шаг с ошибкой. @@ -446,14 +447,14 @@ AI-провайдер ищется по названию среди провай На панели визуализации запуска процесса доступна вкладка «Таймлайн», на которой отображается хронология выполнения процесса: для каждого элемента, который участвовал в текущем запуске, показаны время начала и окончания, длительность и состояние. -Состояние элемента отображается цветом полосы и подписью в легенде: «Выполнено», «Выполнено после повтора», «Выполняется», «Ожидание», «Ждёт подтверждения», «Ошибка», «Отклонено», «Отменено» или «Пропущено». «Отклонено» означает задачу, действие которой не запустилось из-за [условий выполнения](../../actions/overview/#условия-выполнения), «Пропущено» — шаг, выключенный при запуске. +Состояние элемента отображается цветом полосы и подписью в легенде: «Выполнено», «Выполнено после повтора», «Выполняется», «Ожидание», «Ждёт подтверждения», «Ошибка», «Отклонено», «Отменено» или «Пропущено». «Отклонено» означает задачу, действие которой не запустилось из-за [условий выполнения](../actions/overview/#условия-выполнения), «Пропущено» — шаг, выключенный при запуске. Пока запуск выполняется, незавершённые элементы продолжаются до отметки «Сейчас». После завершения запуска элемент, который не завершился сам, например цикл, на итерации которого процесс завершился с ошибкой, заканчивается в момент завершения запуска и получает его итоговый статус. #### Схема запуска Пока запуск выполняется, схема обновляется каждые 5 секунд. Состояние элемента показывает отметка в углу элемента: выполнен, выполнен после повтора, ошибка, отклонён, отменён, выполняется, ожидание, пропущен или ожидает подтверждения. Для завершённого запуска боковая панель элемента, который не завершился сам, показывает итоговый статус запуска и время его завершения. -Задачу, которая ожидает подтверждения, можно подтвердить кнопкой «Подтвердить» прямо на схеме. Кнопка активна только для пользователей из списка [подтверждающих](../../actions/overview/#подтверждение) действия. +Задачу, которая ожидает подтверждения, можно подтвердить кнопкой «Подтвердить» прямо на схеме. Кнопка активна только для пользователей из списка [подтверждающих](../actions/overview/#подтверждение) действия. Пройденный путь выделяется цветом, связи, по которым процесс не прошёл, отображаются светло-серыми. Элементы, пройденные на предыдущих итерациях цикла, отображаются приглушёнными, а цикл показывает «Итерация {current} из {total}». Если элемент выполнялся несколько раз, в его боковой панели лог каждого прохождения отображается отдельно с заголовком «Посещение {n}». diff --git a/content/documentation/admin/security/rbac.ru.md b/content/documentation/admin/security/rbac.ru.md index cd429050..ee758724 100644 --- a/content/documentation/admin/security/rbac.ru.md +++ b/content/documentation/admin/security/rbac.ru.md @@ -202,13 +202,13 @@ AI-агенты и навыки: Типы учётных данных: - `edit:user-access-credentials-types` — создание, редактирование и удаление типов учётных данных; настройка интеграции с Vault (просмотр и изменение конфигурации, проверка подключения). -- `rotate:encryption-key` — ротация ключа шифрования. Подробнее — [в документации по ротации ключа шифрования](../encryption-key-rotation/). +- `rotate:encryption-key` — ротация ключа шифрования. Подробнее — [в документации по ротации ключа шифрования](encryption-key-rotation/). Пользователи: - `edit:users` — создание, блокировка, разблокировка и удаление пользователей, управление AI-провайдерами сервис-аккаунтов и просмотр AI-провайдеров всех пользователей. - `create:users` — разрешение есть в списке разрешений роли, но портал его не проверяет. Для создания пользователей требуется `edit:users`. -- `impersonate:users` — запуск и завершение имперсонации пользователей. Подробнее — [в документации по имперсонации](../impersonation/). +- `impersonate:users` — запуск и завершение имперсонации пользователей. Подробнее — [в документации по имперсонации](impersonation/). Роли и привязки ролей: @@ -217,7 +217,7 @@ AI-агенты и навыки: Аудит-логи: -- `read:audit-logs` — просмотр аудит-логов и их выгрузка в CSV. Подробнее — [в документации по аудит-логам](../audit-logs/). +- `read:audit-logs` — просмотр аудит-логов и их выгрузка в CSV. Подробнее — [в документации по аудит-логам](audit-logs/). {{< alert level="info" >}} Разрешение `update:team-variables` позволяет редактировать переменные только тех команд, участником которых является пользователь. Даже супер-администратор не сможет изменить переменные команд, в которых не состоит. @@ -274,6 +274,14 @@ AI-агенты и навыки: - `sync:datasource` — синхронизация конкретного источника данных. - `run:widget-action` — выполнение действий конкретного виджета. +#### Изменения AI PDLC + +Для [AI PDLC](../ai-pdlc/) используются глобальные разрешения `read:pdlc-changes`, `create:pdlc-changes`, `cancel:pdlc-changes` и `delete:pdlc-changes`. Для отдельного изменения доступны `read:pdlc-change`, `cancel:pdlc-change` и `delete:pdlc-change`. + +Автор получает доступ как владелец при включённой настройке `owner-is-admin`. Адресат решения процесса может читать связанное изменение и спецификацию. Доступ к изменению не открывает чат и IDE автора. + +Создание изменения также требует `create:workspaces`, доступа к приложению, использования шаблона рабочего пространства и AI-агента. Для просмотра выпусков и показателей достаточно права читать сущность приложения. + #### MCP-коллекции Для MCP-коллекций действуют разрешения: @@ -313,7 +321,7 @@ AI-агенты и навыки: Прикрепление к чату и выполнение заданий процесса требуют пространства самого пользователя. Для процесса также необходима привязка к его сущности. -Публиковать порты, менять их уровень доступа и отменять публикацию может владелец с правом обновления рабочего пространства. Для приложений «Только владелец» действует такое же ограничение на открытие. Приложения «Пользователи DDP» доступны любому вошедшему незаблокированному пользователю, «Публично» — без входа; права на карточку рабочего пространства для открытия этих ссылок не требуются. Допустимый уровень публикации портов [ограничивается шаблоном](../../workspaces/apps/#уровни-доступа). +Публиковать порты, менять их уровень доступа и отменять публикацию может владелец с правом обновления рабочего пространства. Для приложений «Только владелец» действует такое же ограничение на открытие. Приложения «Пользователи DDP» доступны любому вошедшему незаблокированному пользователю, «Публично» — без входа; права на карточку рабочего пространства для открытия этих ссылок не требуются. Допустимый уровень публикации портов [ограничивается шаблоном](../workspaces/apps/#уровни-доступа). Для других объектов (действия, автоматизации, процессы, вебхуки, виджеты, дашборды, внешние сервисы и т. д.): - `read:[object-type]` — просмотр объекта. @@ -330,7 +338,7 @@ AI-агенты и навыки: | Просмотр записи и её видимость в списке | `read:entities` глобально или на ресурс, `read:entity`, владение сущностью | `read:entities` глобально или на ресурс, `read:entity`, владение сущностью | `read:actions` глобально, `read:action` на действие | | Отмена, перезапуск и удаление | `control:processes` глобально, на ресурс или на сущность | `run:actions` глобально, на ресурс или на сущность | `run:actions` глобально, `run:action` на действие | -Инициатор запуска и подтверждающие всегда видят запись, например в панели «Мои активности», но управлять ею могут только с разрешениями из таблицы. Подтвердить запуск может только пользователь из списка [подтверждающих](../../actions/overview/#подтверждение), а удалить временный ответ — только инициатор. +Инициатор запуска и подтверждающие всегда видят запись, например в панели «Мои активности», но управлять ею могут только с разрешениями из таблицы. Подтвердить запуск может только пользователь из списка [подтверждающих](../actions/overview/#подтверждение), а удалить временный ответ — только инициатор. Без нужного разрешения кнопки управления записью неактивны. diff --git a/content/documentation/release-notes/v1.8.0.ru.md b/content/documentation/release-notes/v1.8.0.ru.md index 77473c0f..e20ab846 100644 --- a/content/documentation/release-notes/v1.8.0.ru.md +++ b/content/documentation/release-notes/v1.8.0.ru.md @@ -1,7 +1,7 @@ --- title: v1.8.0 weight: 880 -description: Рабочие пространства с IDE, AI-агентом и приложениями, новые MCP-инструменты, каталог навыков, статистика AI и синхронизация источников данных в процессах. +description: Рабочие пространства с AI-агентом, цикл изменений AI PDLC, решения в процессах, каталог навыков, новые инструменты MCP и обновлённая главная. --- {{< alert level="info" >}} @@ -10,44 +10,103 @@ description: Рабочие пространства с IDE, AI-агентом ## Несовместимые изменения -При обновлении учитывайте изменения проверок и доступа: +### AI-агенты и MCP -- Для использования AI-агентов применяются `use:ai-agents` и объектное `use:ai-agent` вместо прежних `run:ai-agents` и `run:ai-agents-a2a`. Проверьте [роли и доступ к агентам](../admin/security/rbac/#ai-агенты). -- Привязка микросервиса к шаблону хранится в [управляемых параметрах с префиксом `ddp_`](../admin/templates/updates/#привязка-микросервиса-к-шаблону). Включите «Реестр шаблонов» в возможностях ресурса и явно сопоставьте параметры репозитория ролям главной. -- Прежние списки инструментов агентов и источников не переносятся: назначьте [MCP-коллекции](../user/mcp-management/#связь-с-ai-ассистентом-и-mcp-сервером) заново. Это относится и к встроенным инструментам. -- Форма сущности проверяет [обязательные параметры](../user/properties/#конфигурация); окна запуска также требуют обязательные значения типов Users, Teams и Object. +- Разрешения `run:ai-agents` и `run:ai-agents-a2a` заменены на `use:ai-agents` и объектное `use:ai-agent`. +- Настройка инструментов агентов и источников переведена на MCP-коллекции. Прежние списки не переносятся: назначьте коллекции заново, в том числе для встроенных инструментов. + +### Шаблоны микросервисов + +Привязка микросервиса к шаблону перенесена в [управляемые параметры с префиксом `ddp_`](../admin/templates/updates/#привязка-микросервиса-к-шаблону). + +### Формы + +Усилена проверка обязательных параметров в формах сущностей и запуска: незаполненные значения, включая Users, Teams и Object, блокируют сохранение или запуск. ## Новые возможности -Добавлены возможности работы с проектами, AI и внешними данными: +### Рабочие пространства + +- Добавлены [рабочие пространства](../user/workspaces/) с IDE, AI-агентом, веб-терминалом и публикацией HTTP-портов с настраиваемым доступом. +- Добавлены [шаблоны рабочих пространств](../admin/workspaces/templates/) с параметрами, файлами и скриптами, публикацией версий вручную и [импортом из GitLab](../admin/workspaces/sources/). + +### AI PDLC + +Добавлен цикл [AI PDLC](../user/home/applications/): создание приложений из шаблонов, согласование спецификаций изменений, реализация агентом, отслеживание MR и автоматические выпуски с показателями изменений. + +### AI-агенты + +- Добавлен [каталог навыков](../admin/ai-agents/skills/) с версиями инструкций и материалов, [импортом из GitLab](../admin/ai-agents/skill-sources/) и установкой в IDE. +- Добавлена [статистика использования AI](../user/ai-statistics/): агентов, моделей, MCP, навыков и рабочих пространств. -- Добавлены [рабочие пространства](../user/workspaces/) с IDE и AI-агентом для работы с проектами: создание из шаблона, редактирование файлов и выполнение заданий из чата. -- [Шаблоны рабочих пространств](../admin/workspaces/templates/) поддерживают пользовательские параметры, файлы и скрипты; версии публикуются вручную или [из GitLab](../admin/workspaces/sources/). -- [Каталог навыков](../admin/ai-agents/skills/) хранит версии инструкций и материалов, поддерживает [импорт из GitLab](../admin/ai-agents/skill-sources/) и установку в IDE. -- [MCP-сервер](../user/mcp-server/) предоставляет инструменты операций API и новые инструменты работы с каталогом. Коллекция может включать отдельные инструменты, серверы и группы портала целиком. -- [Синхронизация внешних MCP-серверов](../user/mcp-management/#автоматическая-синхронизация) поддерживает расписание и сохраняет последний успешный каталог при ошибке. -- [Статистика AI](../user/ai-statistics/) показывает использование агентов, моделей, MCP, навыков и рабочих пространств. -- Элемент процесса [«Источник данных»](../admin/processes/overview/#источник-данных) запускает синхронизацию выбранных источников и продолжает процесс после её окончания. -- Параметр действия [«RelatedEntities»](../admin/actions/overview/#связанные-сущности) получает данные связанных сущностей автоматически или по выбору пользователя для использования в шаблонах и правилах действия. +### MCP + +- В MCP-сервер добавлены [инструменты операций REST API](../user/mcp-server/#инструменты-операций-api), автоматически формируемые из описания API. +- Добавлены [MCP-инструменты «Обозревателя каталога»](../user/mcp-server/#инструменты-работы-с-каталогом) для поиска и группировки сущностей, обхода связей, диагностики процессов и проверки готовности запуска. +- В [MCP-коллекции](../user/mcp-management/#группы-и-серверы-целиком) добавлена возможность включать серверы и группы инструментов целиком с исключением отдельных инструментов. +- Добавлена [синхронизация внешних MCP-серверов по расписанию](../user/mcp-management/#автоматическая-синхронизация). При ошибке синхронизации сохраняется последний успешно полученный каталог инструментов. + +### Процессы + +- Добавлен элемент процесса [«Решение»](../admin/processes/decisions/) для запроса ответа пользователя и сохранения его в хранилище. Адресованные вопросы доступны в новом разделе [«Решения»](../user/home/decisions/) на главной. +- Добавлен элемент процесса [«Источник данных»](../admin/processes/overview/#источник-данных) для запуска синхронизации выбранных источников и ожидания её окончания. + +### Действия + +Добавлен тип параметра действия [«RelatedEntities»](../admin/actions/overview/#связанные-сущности): данные связанных сущностей передаются в шаблоны и правила действия автоматически или по выбору пользователя. ## Улучшения -Улучшены каталог, формы и выполнение процессов: +Обновлены работа с каталогом и выполнение процессов: -- Главная страница доступна всем пользователям по умолчанию. Настройка скрытия главной страницы удалена. +- [Главная](../user/home/overview/) теперь доступна всем пользователям; настройка её скрытия удалена. +- В разделе [команд](../user/home/teams/) карта заменена представлениями «Мои команды», «Каталог команд» и «Владение ландшафтом» с поиском объектов без ответственных. +- В разделах [архитектуры](../user/home/architecture/) добавлены фильтры систем и интеграций, представления «Требуют внимания» и «Влияние изменений»; схемы состава, зависимостей и размещения перенесены в профиль системы. - Обновлена [страница сущности](../user/catalog/#страница-сущности); в списке доступны фильтры по статусу и команде. -- Для элементов «Действие», «AI-агент» и параллельных шлюзов процессов настраивается [тайм-аут](../admin/processes/overview/#действие). +- В редактор процесса добавлена настройка [тайм-аута](../admin/processes/overview/#действие) для действий, AI-агентов и параллельных шлюзов. +- Добавлена [история запусков синхронизации источника данных](../admin/datasources/overview/#запуски-синхронизации) со статусом, временем и инициаторами. +- Новые [параметры форм](../user/properties/#конфигурация) теперь необязательны по умолчанию; обязательность включается при настройке параметра. - Лимит [чатов AI-ассистента](../user/ai-assistant/#чаты) увеличен с 20 до 50 на пользователя. -- Новые [параметры форм](../user/properties/#конфигурация) по умолчанию необязательны; обязательность задаётся при настройке параметра. -- Элемент параметра типа [«Array»](../user/properties/#array) задаётся текстом или JSON. -- Схема нового процесса [настраивается при создании](../admin/processes/overview/#настройка-процесса), до первого сохранения. -- [История синхронизаций источника данных](../admin/datasources/overview/#запуски-синхронизации) показывает статус, время и инициаторов запусков. ## Исправления -Исправлены заметные ошибки выполнения: - -- Процессы сохраняют свою схему при редактировании, корректно обрабатывают параллельные ветки, таймеры, подтверждения и [восстановление запусков](../admin/processes/overview/). -- Переключение чатов во время ответа агента больше не смешивает сообщения разных диалогов. +- Устранён самопроизвольный выход из аккаунта при временной недоступности сервиса авторизации или БД. +- Устранены повторяющиеся уведомления об одной ошибке при автоматическом обновлении таблиц. +- Восстановлена обработка событий автоматизациями после истечения срока хранения потока событий в Redis. +- Исправлено игнорирование фильтра по ресурсу при поиске сущностей. +- Устранена подмена результатов таблицы устаревшим ответом при быстром переключении фильтров. +- Исправлено сохранение типов элементов массива при редактировании; некорректный JSON теперь блокирует сохранение. +- Исправлено отображение незаполненного логического параметра как значения «Нет». +- Сохранение сущности больше не перезаписывает актуальное состояние здоровья и назначения ролей данными из формы. +- Исправлены преждевременное завершение процесса с активными параллельными ветвями и восстановление таких запусков после перезапуска сервера. +- Изменение определения процесса больше не влияет на схему уже выполняющегося запуска. +- Устранён повторный запуск одного процесса на одной сущности при одновременных запросах. +- Устранено повторное выполнение завершённого действия при восстановлении процесса после перезапуска сервера. +- Повторные запуски действий и процессов, а также новые итерации цикла больше не наследуют результаты и согласования предыдущего выполнения. +- Исправлены числовое сравнение, проверка наличия поля и выбор ветки «иначе» в условиях процесса. +- Исправлена запись результатов шагов по вложенным путям в хранилище процесса. +- Исправлены зависание таймеров после паузы и продолжения процесса и срабатывание тайм-аута объединения параллельных ветвей в состоянии ожидания. +- Исправлено завершение шага AI-агента по установленному тайм-ауту. +- Отмена отдельного действия больше не останавливает другие активные ветви процесса. +- Исправлено отображение завершившихся с ошибкой шагов процесса как выполняющихся. +- В истории действий теперь отображаются название и согласующие, сохранённые при запуске. - Записи действий больше не остаются выполняющимися после удаления связанной сущности. -- [MCP-серверы и инструменты](../user/mcp-management/), а также [шаблоны AI-провайдеров](../admin/ai-agents/provider-templates/), созданные выключенными, сохраняют это состояние. +- Исправлено ошибочное завершение webhook-действия с успехом при ответе 3xx без выполненного перенаправления. +- При переключении чатов во время ответа агента сообщения разных диалогов больше не смешиваются. +- Исправлено включение [MCP-серверов и инструментов](../user/mcp-management/), а также [шаблонов AI-провайдеров](../admin/ai-agents/provider-templates/) при создании в выключенном состоянии. +- Исправлен учёт объектных прав при просмотре и редактировании AI-агентов и объектов MCP в интерфейсе. +- Редактирование источника AI-агентов больше не сбрасывает время последней синхронизации. +- Исправлены зависание загрузки и неполные результаты статистики Kaiten при большом количестве карточек. +- API назначения роли теперь возвращает связанных пользователей и команды. +- Исправлен учёт прав доступа при просмотре списка и счётчика запусков действий, отмене, повторном запуске и удалении записей. +- Устранено попадание секретов в журнал аудита, отображаемые аргументы MCP-вызовов и ошибки URL-проверок здоровья. +- Исправлены ответы API: конфликты, отсутствующие объекты и некорректные параметры теперь возвращают 409, 404 и 422 вместо внутренней ошибки 500. +- Исправлено сохранение некорректных cron-расписаний проверок здоровья: расписание проверяется при сохранении. + +## Рекомендации по обновлению + +После обновления проверьте настройки: + +1. Проверьте [роли и доступ к AI-агентам](../admin/security/rbac/#ai-агенты), затем назначьте агентам и источникам нужные [MCP-коллекции](../user/mcp-management/#связь-с-ai-ассистентом-и-mcp-сервером). +1. Включите «Реестр шаблонов» в возможностях ресурса микросервисов и явно сопоставьте параметры репозитория [ролям главной](../admin/home/mapping/#микросервисы). +1. Проверьте [обязательность параметров](../user/properties/#конфигурация) в используемых формах и окнах запуска. diff --git a/content/documentation/user/credentials.ru.md b/content/documentation/user/credentials.ru.md index b14f9be1..96af1873 100644 --- a/content/documentation/user/credentials.ru.md +++ b/content/documentation/user/credentials.ru.md @@ -1,6 +1,7 @@ --- title: Учётные данные menuTitle: Учётные данные +description: Сохранение личных реквизитов доступа и проверка сообщений об ошибках авторизации MCP-серверов. --- Учётные данные — это механизм безопасного хранения и использования реквизитов доступа к внешним сервисам (токены, пароли, ключи API и т. д.) в Deckhouse Development Portal (DDP, портал). @@ -9,7 +10,7 @@ menuTitle: Учётные данные Всё взаимодействие с инфраструктурными сервисами в DDP происходит с использованием учётных данных конкретного пользователя. Учётные данные шифруются перед сохранением в базе данных и расшифровываются только при необходимости их использования в действиях, источниках данных и виджетах. -Механизм работы, шифрование и настройка учётных данных описаны в разделе [«Учётные данные» документации администратора](../../admin/security/credentials/). +Механизм работы, шифрование и настройка учётных данных описаны в разделе [«Учётные данные» документации администратора](../admin/security/credentials/). ## Заполнение учётных данных @@ -17,6 +18,14 @@ menuTitle: Учётные данные Например, если администратор создал тип учётных данных «Kubernetes token», то вы в своём профиле сможете добавить персональный токен для доступа в Kubernetes. +## Состояние реквизитов + +В профиле подпись «Значение задано» или «Значение не задано» показывает, сохранены ли реквизиты. Наличие значения не означает, что внешний сервис его принимает. + +Если MCP-сервер отклонил реквизиты с ответом `401`, рядом появляется сообщение «Сервер {serverName} отклонил учётные данные». Проверьте токен и повторите обращение к этому серверу с исправленными реквизитами. Сообщение не удаляет сохранённое значение и не запрещает следующую попытку. + +Ошибки относятся к конкретному серверу и пользователю. Порядок выбора учётной записи для вызовов и синхронизации описан в разделе [«Управление MCP»](mcp-management/#учётные-записи). + ## Особенности работы с учётными данными - После сохранения учётных данных вы не сможете посмотреть их значение, только обновить его. diff --git a/content/documentation/user/home/applications.ru.md b/content/documentation/user/home/applications.ru.md new file mode 100644 index 00000000..1fee2b15 --- /dev/null +++ b/content/documentation/user/home/applications.ru.md @@ -0,0 +1,87 @@ +--- +title: Приложения и изменения +weight: 15 +description: Работа с AI PDLC — создание приложения, постановка изменения, согласование спецификации, реализация, выпуск и показатели. +--- + +Раздел «Главная» → «AI-инструменты» → «Приложения» объединяет приложения каталога с репозиториями GitLab. AI PDLC проводит изменение от постановки и согласования спецификации до реализации агентом, запроса на слияние (MR) и развёртывания выпуска. + +Перед началом администратор должен [настроить AI PDLC](../../admin/ai-pdlc/). Сохраните токен GitLab в [учётных данных](../credentials/) и подключите [AI-провайдера](../ai-assistant/#подключение-ai-провайдера). + +## Выбор приложения + +Откройте приложение из списка. Поиск отбирает приложения по названию или идентификатору. В карточке приложения доступны изменения, выпуски и показатели, а блок «Готовность к AI PDLC» показывает репозиторий, ветку по умолчанию, согласующих, окружение выпуска и процесс развёртывания. + +Кнопка «Открыть рабочее пространство» открывает ваше пространство для приложения или создаёт его из шаблона AI PDLC. Если у вас несколько AI-провайдеров, выберите один. Чат и IDE доступны владельцу пространства; согласование спецификации не предоставляет доступ к ним другим пользователям. + +## Новое приложение + +Кнопка «Новое приложение» создаёт приложение через [реестр шаблонов](microservices/#создание-микросервиса): + +1. Выберите шаблон и заполните параметры создания микросервиса. +1. При необходимости задайте «Окружение выпуска». Без него приложение можно создать, но автоматическое развёртывание выпусков не начнётся. +1. Нажмите «Продолжить» и дождитесь завершения процесса создания. +1. На открывшейся странице приложения заполните диалог первого изменения. + +Если создание завершается ошибкой, нажмите «Открыть прогон» и проверьте результат процесса. Если окружение выпуска не удалось записать, задайте связь в карточке приложения. Сообщение об отсутствии процесса развёртывания передайте администратору. + +## Новое изменение + +Изменение начинается с постановки задачи: + +1. Откройте приложение и нажмите «Новое изменение». +1. Укажите «Название» и «Постановка»: что требуется изменить и зачем. +1. При запросе выберите LLM-провайдера и нажмите «Создать». +1. Следите за шагами на странице изменения. Агент подготовит спецификацию в ветке GitLab и передаст её на согласование. + +Пока изменение готовит спецификацию или реализацию, приложение занято: другое изменение можно начать после открытия MR или завершения текущего изменения. Страница сообщает название и автора изменения, которое удерживает приложение. + +Спецификация хранится в репозитории по пути `docs/changes/<идентификатор>.md`. DDP проверяет наличие результата в GitLab: ответа агента в чате недостаточно для завершения шага. + +## Согласование спецификации + +Согласующие задаются в параметре приложения «Согласующие спецификаций». Если список пуст, спецификацию согласует автор изменения. При нескольких адресатах достаточно решения одного из них. + +Откройте изменение или раздел [«Решения»](decisions/), прочитайте спецификацию и выберите действие: + +| Действие | Результат | +| --- | --- | +| «Согласовать» | Агент начинает реализацию согласованной версии спецификации | +| «Вернуть на доработку» | Изменение возвращается автору; комментарий объясняет, что требуется исправить | +| «Доработать агентом» | Автор поручает агенту исправить возвращённую спецификацию | +| «Готово к согласованию» | Автор повторно передаёт текущую спецификацию согласующим | + +Для ручной доработки измените спецификацию в рабочем пространстве, сохраните коммит в ветке GitLab и отправьте её на согласование. На странице показаны версия спецификации и SHA согласованного коммита. + +## Реализация и проверка + +После согласования агент изменяет код, выполняет проверки проекта и открывает MR. На странице изменения появляются ссылка на MR и его состояние. Проверку и слияние выполняйте в GitLab; DDP отслеживает результат и переводит изменение в «Влито» или «MR закрыт». + +При ошибке страница показывает незавершённый шаг и число попыток. Автор может открыть чат изменения, чтобы проверить ответ агента и результат работы. + +Кнопка «Отменить изменение» останавливает процесс. Ветка и MR остаются в GitLab. Удаление доступно после завершения или отмены изменения и также не удаляет ветку и MR. + +## Выпуски + +После слияния DDP собирает изменения приложения в выпуск и запускает настроенный процесс развёртывания. Для этого у приложения должно быть одно «Окружение выпуска», указанное связью в каталоге, и однозначно выбранный процесс развёртывания. Если настройки отсутствуют, изменение остаётся в состоянии «Влито», а страница показывает причину ожидания. + +На вкладке «Выпуски» откройте выпуск, чтобы проверить его состав, окружение, версию, release notes и прогон развёртывания. Версия фиксирует SHA основной ветки на момент подготовки развёртывания. Release notes собираются из разделов `What changes` спецификаций вошедших изменений. + +Состояния выпуска означают: + +| Состояние | Значение | +| --- | --- | +| «Ожидает» | Выпуск собран и ожидает запуска; причина ожидания показана на странице | +| «Развёртывается» | Выполняется процесс развёртывания | +| «Развёрнут» | Процесс развёртывания завершился успешно | +| «Не удался» | Развёртывание завершилось ошибкой, было остановлено или его прогон удалён | + +Одновременно развёртывается один выпуск приложения. Новые слияния во время развёртывания собираются в следующий выпуск. После неудачного выпуска его изменения войдут в следующий выпуск после нового слияния; автоматического повтора того же выпуска нет. + +Статус «Развёрнут» отражает результат процесса. Поле «Образ в окружении» берётся из каталога и зависит от синхронизации данных развёртывания. + +## Показатели + +Вкладка «Показатели» показывает изменения за 30, 90 или 365 дней по дате постановки. Здесь доступны число изменений по состояниям, возвраты на доработку, медианное время стадий и расход агента: токены, число ходов и время работы. + +Для стадий учитываются изменения, у которых есть соответствующие отметки времени; рядом с медианой показано их число. На странице отдельного изменения блок «Стоимость и сроки» показывает данные этого изменения. Расход токенов не является денежной оценкой. diff --git a/content/documentation/user/home/architecture.ru.md b/content/documentation/user/home/architecture.ru.md index 360a340d..de9137af 100644 --- a/content/documentation/user/home/architecture.ru.md +++ b/content/documentation/user/home/architecture.ru.md @@ -1,82 +1,73 @@ --- title: Архитектура weight: 30 -description: Разделы главной DDP группы «Архитектура» — системы и их зависимости, интеграции, диаграммы, кластеры и сети, гайды «Как работает платформа». +description: Каталог систем и интеграций DDP, ответственность команд, схемы состава и размещения, оценка влияния изменений. --- -Разделы группы «Архитектура» показывают системы, связи между ними и инфраструктуру, на которой они размещены. Разделы группы предназначены для просмотра и не запускают процессы. +Разделы «Главная» → «Архитектура» показывают системы, интеграции и инфраструктуру по данным каталога. Они помогают найти ответственных, состав системы и её связи. ## Системы -Раздел «Системы» показывает системы, сгруппированные по доменам, и сведения о выбранной системе. +Раздел «Системы» предлагает представления «Все системы», «Мои системы» и «Требуют внимания». В «Мои системы» попадают системы в вашем владении или во владении ваших команд. -### Дерево доменов +Поиск учитывает название и описание системы, команду, владельца и сервисы. Фильтры позволяют выбрать команду, жизненный цикл, результаты проверок и окружение. Отсутствие домена не исключает систему из списка. -В левой панели «Домены» системы сгруппированы по доменам. Домены и системы отсортированы по названию. -Поле «Поиск по системе или домену» фильтрует дерево по названию домена или системы. +В представлении «Требуют внимания» видны как ошибки проверок системы и её сервисов, так и пробелы в описании: отсутствующие команда, жизненный цикл или сервисы. Отсутствие результатов проверок само по себе не означает ошибку. -Системы без домена в дереве не отображаются. +### Профиль системы -При открытии раздела выбрана первая по названию система. Чтобы выбрать другую систему, нажмите на неё в дереве. - -### Вкладки системы - -Сведения о выбранной системе распределены по вкладкам. При выборе системы открывается вкладка «Зависимости». +Нажмите на систему, чтобы открыть её профиль. В нём доступны вкладки: | Вкладка | Содержимое | | --- | --- | -| «Справка» | «Домен», «Владелец», «Команда владелец», «Жизненный цикл», «Состояние» | -| «Зависимости» | Граф зависимостей системы и таблица интеграций с колонками «Клиент», «Сервер», «Интеграция» | -| «Микросервисы» | Микросервисы системы: «Микросервис», «Язык», «Состояние» | -| «Общесистемные ресурсы» | Общие ресурсы системы: «Ресурс», «Тип» | -| «Окружения» | Окружения, на которых развёрнуты микросервисы системы: «Название», «Тип», «Кластер» | +| «Обзор» | Описание, ответственность, жизненный цикл и результаты проверок | +| «Состав» | Сервисы системы, их команды и проверки | +| «Ресурсы» | Общесистемные ресурсы | +| «Зависимости» | Входящие и исходящие интеграции | +| «Размещение» | Окружения, кластеры, развёртывания, версии образов и реплики | -Поле «Состояние» показывает результат проверок статуса сущности: «В норме», «С проблемами», «Ошибка» или «Неизвестно». +Команда системы и команды её сервисов показаны отдельно. Принадлежность сервиса к системе не меняет его команду-владельца. -### Граф зависимостей +### Схемы системы -Граф зависимостей показывает выбранную систему и системы, с которыми она связана интеграциями. Системы связаны друг с другом только через интеграции: система-клиент обращается к системе-серверу через интеграцию. +В профиле системы нажмите «Развернуть схему ↗», чтобы открыть нужную схему: -На линии между двумя системами отображаются названия интеграций. Если интеграций больше одной, остальные скрыты под тегом «+N»; наведите на тег, чтобы увидеть их список. Если системы обращаются друг к другу в обе стороны, линия отмечена стрелками с обоих концов. +- «Состав» показывает сервисы и общие ресурсы внутри системы. +- «Зависимости» показывает системы-клиенты и системы-серверы через зарегистрированные интеграции. +- «Размещение» группирует развёртывания по окружениям и кластерам. -Нажмите на линию или название интеграции, чтобы открыть панель интеграции. В панели отображаются описание интеграции, системы «Клиент» и «Сервер», «Тип связи» и «Критичность». +Масштаб меняется колесом мыши и кнопками «Увеличить» и «Уменьшить». Перетаскивание перемещает схему, кнопка «По размеру» помещает её целиком в окно. Нажмите на объект или подпись связи, чтобы открыть подробности. -Если у системы нет интеграций, отображается сообщение «У выбранной системы нет зависимостей.». +Схемы отражают данные каталога. Версии образов и число реплик не показывают фактическую нагрузку и текущее состояние подов. При частично недоступных данных сводки и схемы могут быть неполными. ## Интеграции -Раздел «Интеграции» показывает все интеграции между системами. +Раздел «Интеграции» показывает взаимодействия систем. Одна интеграция может связывать несколько систем с каждой стороны: клиенты обращаются к серверам. -В верхней части раздела отображаются показатели: +Выберите область «Все интеграции», «Моих команд» или «Требуют внимания». Область «Моих команд» включает интеграции в вашем владении или во владении ваших команд, а также связи с участием систем ваших команд. -- «Интеграции» — число интеграций; -- «Зависимости» — число пар систем «клиент — сервер», связанных интеграциями; -- «Критичные связи» — число интеграций с высокой критичностью. +Поиск учитывает название, описание и системы обеих сторон. Фильтры отбирают интеграции по системе, направлению относительно неё, команде стороны, типу связи и критичности. -На вкладке «Таблица» интеграции перечислены с колонками «Интеграция», «Клиент», «Сервер», «Тип связи», «Критичность». Нажмите на строку, чтобы открыть панель интеграции. +### Представления интеграций -На вкладке «Граф» отображается граф зависимостей первой системы каталога. +Переключатель представления меняет способ просмотра выбранных интеграций: + +| Представление | Назначение | +| --- | --- | +| «Каталог» | Таблица интеграций, клиентов, серверов, типа связи и критичности | +| «Схема связей» | Весь ландшафт или связи вокруг выбранной системы; схема и таблица используют одни фильтры | +| «Влияние изменений» | Непосредственные зависимости выбранной системы со стороны клиентов и серверов | -## Диаграммы +«Влияние изменений» помогает определить участников обсуждения. Это оценка по зарегистрированным связям, а не прогноз распространения сбоя. -Раздел «Диаграммы» показывает схемы системы в трёх видах. Вид выбирается переключателем: +### Профиль интеграции -- «Зависимости» — граф зависимостей системы через интеграции; -- «Состав» — дерево системы с её микросервисами и общими ресурсами; -- «Развёртывание» — сводка по системе, её микросервисам и общим ресурсам. Систему выберите в списке «Система». +Нажмите на интеграцию, чтобы открыть её описание, проверки, владельца и участников с обеих сторон. Команда самой интеграции указана отдельно от команд систем. Из профиля можно открыть систему или показать интеграцию на схеме систем. -Кнопка «Скачать диаграмму» сохраняет выбранную схему в текстовый файл. +В «Требуют внимания» входят ошибки проверок и незаполненные клиент, сервер, тип связи или критичность. Критичность интеграции не является результатом проверки доступности. ## Кластеры и сети Раздел «Кластеры и сети» показывает кластеры и окружения, размещённые в них. В верхней части раздела отображаются показатели «Кластеры» и «Окружения». Для каждого кластера отображается карточка с провайдером, названием, регионом и окружениями кластера. - -## Как работает платформа - -Раздел «Как работает платформа» содержит гайды по основным сценариям работы с порталом. Гайды сгруппированы по категориям; гайды без категории отображаются в группе «Без категории». - -Гайды фильтруются полем «Поиск по гайдам» и переключателем категорий. Переключатель категорий отображается, если категорий больше одной. - -В карточке гайда отображаются категория, дата обновления, название и описание. Кнопка «Открыть документацию» открывает документацию гайда, кнопка «Смотреть видео» — видео. diff --git a/content/documentation/user/home/decisions.ru.md b/content/documentation/user/home/decisions.ru.md new file mode 100644 index 00000000..8b0f734b --- /dev/null +++ b/content/documentation/user/home/decisions.ru.md @@ -0,0 +1,25 @@ +--- +title: Решения +weight: 17 +description: Ответы на адресованные пользователю решения процессов и просмотр ранее принятых решений. +--- + +Раздел «Главная» → «AI-инструменты» → «Решения» показывает решения процессов, адресованные вам. Здесь можно согласовать спецификацию [изменения приложения](applications/) или ответить на вопрос другого процесса. + +## Ответ на вопрос + +Чтобы продолжить ожидающий процесс: + +1. Откройте вкладку «Ожидают». +1. Найдите вопрос по объекту, процессу и шагу. При необходимости откройте объект: для AI PDLC ссылка ведёт на изменение, для остальных процессов — на сущность каталога. +1. Прочитайте вопрос, укажите необязательный «Комментарий» и выберите один из предложенных ответов. + +Если адресатов несколько, отвечает любой из них. Первый принятый ответ завершает ожидание; изменить его повторным нажатием нельзя. Если другой адресат уже ответил, портал сообщает «Решение уже принято». + +Отвечать могут адресаты и суперадминистратор. Разрешение управлять процессом само по себе не делает пользователя адресатом решения. Если все адресаты удалены, ответить может только суперадминистратор. + +## Принятые решения + +Вкладка «Принятые» показывает ранее адресованные вам решения с выбранным ответом, автором и временем ответа. Для проверки контекста откройте связанное изменение или сущность. + +Как добавить вопрос и варианты ответа в схему процесса, описано в руководстве [«Решение в процессе»](../../admin/processes/decisions/). diff --git a/content/documentation/user/home/microservices.ru.md b/content/documentation/user/home/microservices.ru.md index cea6d359..550d29cf 100644 --- a/content/documentation/user/home/microservices.ru.md +++ b/content/documentation/user/home/microservices.ru.md @@ -79,7 +79,7 @@ description: Создание микросервиса из шаблона на - «Связанные системы» — число систем, в которые входят микросервисы; - «Проблемные» — число микросервисов, у которых проверка статуса вернула «С проблемами» или «Ошибка». -Таблица фильтруется полем «Поиск по имени или системе» и списками «Все домены» и «Все языки». Кнопка «Сбросить» очищает фильтры. +Таблица фильтруется полем «Поиск по имени или системе» и списком «Все языки». Кнопка «Сбросить» очищает фильтры. Колонки таблицы: @@ -87,7 +87,6 @@ description: Создание микросервиса из шаблона на | --- | --- | | «Микросервис» | Название микросервиса и ссылка на репозиторий | | «Владелец» | Владелец сущности микросервиса | -| «Домен» | Домен системы, в которую входит микросервис | | «Система» | Системы, в которые входит микросервис | | «Язык» | Язык микросервиса | | «Окружения» | Окружения, на которых развёрнут микросервис | @@ -97,7 +96,7 @@ description: Создание микросервиса из шаблона на ## Карточка микросервиса -Карточка микросервиса открывается в правой панели. В заголовке отображаются название, состояние, домен и язык микросервиса. +Карточка микросервиса открывается в правой панели. В заголовке отображаются название, состояние и язык микросервиса. ### Вкладка «Справка» diff --git a/content/documentation/user/home/overview.ru.md b/content/documentation/user/home/overview.ru.md index 6c9b3142..5d215540 100644 --- a/content/documentation/user/home/overview.ru.md +++ b/content/documentation/user/home/overview.ru.md @@ -13,7 +13,7 @@ description: Главная страница DDP — разделы и нави Главная открывается вкладкой «Главная» в верхней панели портала и доступна всем пользователям. Первым открывается раздел «Рабочие пространства». -Раздел «Рабочие пространства» показывает ваши рабочие пространства. В остальных разделах собраны данные каталога: команды, системы, микросервисы и окружения. +Раздел «Рабочие пространства» показывает ваши рабочие пространства. «Приложения» ведут изменения AI PDLC, «Решения» собирают вопросы процессов. В остальных разделах доступны команды, системы, микросервисы и окружения. ## Разделы @@ -22,12 +22,12 @@ description: Главная страница DDP — разделы и нави | Группа | Раздел | Назначение | | --- | --- | --- | | «AI-инструменты» | [«Рабочие пространства»](../workspaces/) | Ваши рабочие пространства, создание из шаблона, IDE и чат агента | +| «AI-инструменты» | [«Приложения»](applications/) | Изменения с агентом, согласование спецификаций и выпуски | +| «AI-инструменты» | [«Решения»](decisions/) | Ожидающие и принятые решения процессов | | «Организация» | [«Команды»](teams/) | Команды портала, их участники, системы и микросервисы | -| «Архитектура» | [«Системы»](architecture/#системы) | Системы по доменам, их зависимости, микросервисы, общие ресурсы и окружения | +| «Архитектура» | [«Системы»](architecture/#системы) | Системы, ответственные, состав, зависимости и размещение | | «Архитектура» | [«Интеграции»](architecture/#интеграции) | Интеграции между системами | -| «Архитектура» | [«Диаграммы»](architecture/#диаграммы) | Схемы зависимостей, состава и развёртывания системы | | «Архитектура» | [«Кластеры и сети»](architecture/#кластеры-и-сети) | Кластеры и размещённые в них окружения | -| «Архитектура» | [«Как работает платформа»](architecture/#как-работает-платформа) | Гайды по сценариям работы с порталом | | «Разработка» | [«Создать микросервис»](microservices/#создание-микросервиса) | Создание микросервиса из шаблона | | «Разработка» | [«Микросервисы»](microservices/#список-микросервисов) | Список микросервисов, карточка микросервиса, обновление из шаблона | | «Разработка» | [«Развертывание систем»](deployment/#развертывание-систем) | Схема развёртывания системы на окружении, развёртывание микросервисов, подключение ресурсов | @@ -35,7 +35,7 @@ description: Главная страница DDP — разделы и нави | «Разработка» | [«Окружения»](deployment/#окружения) | Создание и удаление окружений, домен окружения | | «Разработка» | [«Потребление ресурсов»](deployment/#потребление-ресурсов) | Запросы и лимиты CPU и памяти по развёртываниям | -Разделы с меткой «TBD» в меню находятся в разработке. При открытии такого раздела отображается сообщение «Раздел пока недоступен». +Разделы «DORA и SDLC метрики» и «Затраты на эксплуатацию» с меткой «TBD» находятся в разработке. При открытии такого раздела отображается сообщение «Раздел пока недоступен». ## Если данных нет diff --git a/content/documentation/user/home/teams.ru.md b/content/documentation/user/home/teams.ru.md index 564215d8..83601a44 100644 --- a/content/documentation/user/home/teams.ru.md +++ b/content/documentation/user/home/teams.ru.md @@ -1,41 +1,29 @@ --- title: Команды weight: 20 -description: Раздел главной DDP «Команды» — показатели команд, карта команд и профиль команды с её системами и микросервисами. +description: Поиск команд, просмотр собственных команд и ответственности за системы и сервисы в каталоге DDP. --- -Раздел «Команды» показывает команды портала, их участников и системы и микросервисы, которыми владеют команды. Чтобы открыть раздел, перейдите в «Главная» → «Организация» → «Команды». +Раздел «Главная» → «Организация» → «Команды» показывает участников команд и объекты каталога, за которые они отвечают. Состав команд задаётся в разделе «Администрирование»; подробнее — в руководстве [«Команды и пользователи»](../teams-users/). -Команды и их участники задаются в разделе «Администрирование». Подробнее — в разделе [«Команды и пользователи»](../teams-users/). Системы и микросервисы команды определяются по полю «Команда владелец» их сущностей в каталоге. +## Представления -## Показатели +Выберите представление под задачу: -В верхней части раздела отображаются показатели: - -| Показатель | Значение | +| Представление | Назначение | | --- | --- | -| «Команды» | Число команд портала | -| «Участники команд» | Число уникальных пользователей во всех командах | -| «Средний размер» | Среднее число участников в команде | -| «Пустые команды» | Число команд без участников | - -## Карта команд +| «Мои команды» | Ваши команды и их системы и сервисы; можно выбрать одну команду или все свои команды | +| «Каталог команд» | Поиск команды по названию, участникам, системам и сервисам | +| «Владение ландшафтом» | Системы и микросервисы с командами-владельцами и результатами проверок | -Карта команд показывает все команды портала. Для каждой команды отображаются аватар, название, идентификатор и число участников. +В «Каталог команд» можно найти команды без участников. В «Владение ландшафтом» используйте фильтры типа и состояния объектов: например, найдите объекты «Без команды», «Требуют внимания» или «Без данных о проверках». -Карта масштабируется колесом мыши и кнопками «Уменьшить», «Увеличить» и «Показать весь граф в окне». Чтобы сдвинуть карту, перетащите её фон. - -Если команд нет, отображается сообщение «Команд пока нет. Создайте команды в разделе «Администрирование», чтобы увидеть их здесь.». +Результаты проверок и отсутствие данных показаны отдельно. Если часть каталога недоступна, портал сообщает об этом; число объектов и сводки могут быть неполными. ## Профиль команды -Профиль открывается в правой панели при нажатии на команду на карте. При открытии раздела выбрана первая по названию команда. - -В профиле отображаются: +Нажмите на команду, чтобы открыть профиль с описанием, участниками, системами и сервисами. Из профиля можно перейти к нужной системе или сервису. -- описание команды и участники; -- «Идентификатор», «Участники», «Дата создания», «Дата обновления»; -- «Системы» — системы, у которых команда указана в поле «Команда владелец»; -- «Микросервисы» — микросервисы, у которых команда указана в поле «Команда владелец», и микросервисы систем команды. +Сервисы разделены на «Сервисы команды» и «Другие сервисы в системах команды». Первая группа определяется командой-владельцем самого сервиса, вторая — его принадлежностью к системе команды. Наличие сервиса в системе не передаёт владение им команде этой системы. -Чтобы закрыть профиль, нажмите на выбранную команду ещё раз, на пустую область карты или на кнопку закрытия панели. +Объекты без команды-владельца остаются видимыми в представлении «Владение ландшафтом» и не назначаются команде автоматически. diff --git a/content/documentation/user/overview.ru.md b/content/documentation/user/overview.ru.md index 1e0bee2d..638a8d5a 100644 --- a/content/documentation/user/overview.ru.md +++ b/content/documentation/user/overview.ru.md @@ -12,6 +12,8 @@ Deckhouse Development Portal (DDP) объединяет каталог серв | Запустить действие или процесс | [Страница сущности](catalog/#страница-сущности) | | Подключить языковую модель | [AI-провайдер в профиле](ai-assistant/#подключение-ai-провайдера) | | Создать IDE с агентом для проекта | [Создание рабочего пространства](workspaces/#создание-рабочего-пространства) | +| Провести изменение от постановки до выпуска | [Приложения и изменения](home/applications/) | +| Ответить на вопрос процесса | [Решения](home/decisions/) | | Поручить агенту изменить файлы | [Чат рабочего пространства](workspace-chat/) | | Подключить MCP-клиент | [MCP-сервер](mcp-server/#подключение-mcp-сервера) | | Посмотреть использование AI | [Статистика AI](ai-statistics/) |