From da7f6db6ab8da1d57d4b7f14184a715f55f50c6c Mon Sep 17 00:00:00 2001 From: Nikita Velgin Date: Fri, 30 Oct 2026 13:38:56 +0300 Subject: [PATCH 1/2] docs: workspace runtime sandbox --- .../upgraderepositoryfromtemplatepack.ru.md | 6 +- content/documentation/admin/datasets.ru.md | 2 +- .../admin/datasources/types.ru.md | 2 +- .../admin/examples/home-custom-catalog.ru.md | 22 +-- .../admin/examples/home-quick-start.ru.md | 10 +- .../admin/examples/home-widget-slot.ru.md | 6 +- .../documentation/admin/home/mapping.ru.md | 78 +++++----- .../documentation/admin/home/overview.ru.md | 36 ++--- .../documentation/admin/home/processes.ru.md | 2 +- content/documentation/admin/home/setup.ru.md | 6 +- .../documentation/admin/security/rbac.ru.md | 4 +- .../admin/templates/updates.ru.md | 38 +++-- .../admin/workspaces/_index.ru.md | 2 +- .../admin/workspaces/overview.ru.md | 2 + .../admin/workspaces/sandbox.ru.md | 133 ++++++++++++++++++ .../admin/workspaces/templates.ru.md | 2 +- .../documentation/release-notes/v1.8.0.ru.md | 4 +- .../user/home/microservices.ru.md | 3 +- .../documentation/user/home/overview.ru.md | 9 +- content/documentation/user/home/teams.ru.md | 2 +- content/documentation/user/interface.ru.md | 4 +- .../documentation/user/workspace-chat.ru.md | 8 +- content/documentation/user/workspaces.ru.md | 46 ++++-- 23 files changed, 292 insertions(+), 135 deletions(-) create mode 100644 content/documentation/admin/workspaces/sandbox.ru.md diff --git a/content/documentation/admin/actions/gitlab/upgraderepositoryfromtemplatepack.ru.md b/content/documentation/admin/actions/gitlab/upgraderepositoryfromtemplatepack.ru.md index 2563ca9a..0176affd 100644 --- a/content/documentation/admin/actions/gitlab/upgraderepositoryfromtemplatepack.ru.md +++ b/content/documentation/admin/actions/gitlab/upgraderepositoryfromtemplatepack.ru.md @@ -29,15 +29,15 @@ updateAddIfMissing: ### Спецификация запроса -Незаданные поля `templateId`, `templatePackSource`, `targetRepositoryUrl` и `targetBranch` заполняются из параметров сущности микросервиса по ролям [правил маппинга](../../home/mapping/#микросервисы). +Незаданные `templateId` и `templatePackSource` заполняются из управляемых параметров сущности микросервиса. Поля `targetRepositoryUrl` и `targetBranch` заполняются по ролям [правил маппинга](../../home/mapping/#микросервисы). | Название | Обязательность | Описание | Значение по умолчанию | | ------------------------ | -------------- | ---------------------------------------------------------------------------------------- | --------------------- | | targetRepositoryUrl | Да | HTTPS-адрес репозитория микросервиса | Роль `microservice_repository` | | targetBranch | Нет | Ветка, от которой создаётся ветка обновления | Роль `microservice_default_branch`, затем «Ветка по умолчанию» реестра шаблонов, затем `main` | | sourceBranch | Нет | Ветка, в которую записываются изменения | `<префикс ветки обновления><версия>`, например `ddp/template-upgrade-1.3.0` | -| templateId | Да | Идентификатор шаблона | Роль `microservice_binding_template_id` | -| templatePackSource | Да | Название подключения в реестре шаблонов | Роль `microservice_binding_template_source` | +| templateId | Да | Идентификатор шаблона | Параметр `ddp_template_id` | +| templatePackSource | Да | Название подключения в реестре шаблонов | Параметр `ddp_template_source` | | templateVersion | Нет | Целевая версия шаблона в формате semver | Последняя версия шаблона | | upgradeStrategy | Нет | Стратегия обновления: `selective`, `additive`, `selective_additive`, `full` или `merge` | Параметр микросервиса, затем стратегия пакета, затем `selective` | | updateOverwrite | Нет | Glob-шаблоны перезаписываемых путей | Параметр микросервиса, затем список пакета | diff --git a/content/documentation/admin/datasets.ru.md b/content/documentation/admin/datasets.ru.md index 34e8e00d..b9bbf5a5 100644 --- a/content/documentation/admin/datasets.ru.md +++ b/content/documentation/admin/datasets.ru.md @@ -82,7 +82,7 @@ weight: 74 После применения заполните в профиле пользователя учётные данные «GitLab токен» и «GitLab username». -Группы, репозитории и виджеты GitLab для главной создают наборы данных «GitLab: группы», «GitLab: активность репозиториев» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](../home/setup/#наборы-данных-мастера). +Группы и виджеты GitLab для главной создают наборы данных «GitLab: группы» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](../home/setup/#наборы-данных-мастера). ### Kubernetes diff --git a/content/documentation/admin/datasources/types.ru.md b/content/documentation/admin/datasources/types.ru.md index 990e6bcf..541a985e 100644 --- a/content/documentation/admin/datasources/types.ru.md +++ b/content/documentation/admin/datasources/types.ru.md @@ -84,7 +84,7 @@ DDP (портал) выполняет GET-запрос по URL: `/api/v2/produc Источник данных типа `GitlabRepositoryActivity` возвращает активность проектов GitLab: число открытых merge request, последний коммит и последний пайплайн ветки по умолчанию. -Источник заполняет показатели карточки микросервиса на главной и используется набором данных «GitLab: активность репозиториев». +Источник можно настроить для записи активности репозиториев в собственные параметры каталога. Для вывода пайплайнов и запросов на слияние в карточке микросервиса на главной используются [слоты виджетов](../home/mapping/#слоты-виджетов). ### Авторизация diff --git a/content/documentation/admin/examples/home-custom-catalog.ru.md b/content/documentation/admin/examples/home-custom-catalog.ru.md index ab5c5cb5..168d4db5 100644 --- a/content/documentation/admin/examples/home-custom-catalog.ru.md +++ b/content/documentation/admin/examples/home-custom-catalog.ru.md @@ -57,27 +57,27 @@ description: Настройка правил маппинга главной DDP ## Заполнение областей -Области заполняются по очереди: связи и параметры роли выбираются из ресурса её родительской роли, поэтому сначала сопоставьте ресурсы. +Добавьте существующие ресурсы в соответствующие области. В таблицах их свойств и связей назначьте значения в поле «Роль на главной». Заполните область «Системы»: -1. В блоке «Ресурс каталога» выберите «Продукты». -1. В блоке «Свойства» выберите `domain` для «Домен системы» и `status` для «Жизненный цикл системы». +1. Нажмите «Добавить ресурс каталога» и выберите «Продукты». +1. В таблице «Свойства ресурса» назначьте параметру `domain` роль «Домен системы», а параметру `status` — «Жизненный цикл системы». Заполните область «Микросервисы»: -1. В блоке «Ресурсы каталога» нажмите «Добавить ресурс» и выберите «Сервисы». -1. В карточке ресурса выберите параметры `lang` для «Язык микросервиса» и `repo_url` для «Репозиторий микросервиса». -1. Выберите связь «Продукт — сервис» для «Содержит микросервис» и связь «Сервис — workload» для «Имеет развёртывание». +1. Нажмите «Добавить ресурс каталога» и выберите «Сервисы». +1. Параметру `lang` назначьте роль «Язык микросервиса», а параметру `repo_url` — «Репозиторий микросервиса». +1. В таблице «Связи ресурса» назначьте связи «Продукт — сервис» роль «Содержит микросервис», а связи «Сервис — workload» — «Имеет развёртывание». Заполните области «Окружения» и «Развёртывания»: -1. В области «Окружения» выберите ресурс «Стенды» и параметры `stand_type` для «Тип окружения» и `base_domain` для «Домен окружения». -1. В области «Развёртывания» выберите ресурс «Workloads», связь «Workload — стенд» для «Развёртывание в окружении» и параметры `replicas` и `image`. +1. В области «Окружения» добавьте ресурс «Стенды». Параметру `stand_type` назначьте роль «Тип окружения», параметру `base_domain` — «Домен окружения». +1. В области «Развёртывания» добавьте ресурс «Workloads». Связи «Workload — стенд» назначьте роль «Развёртывание в окружении», параметру `replicas` — «Реплики развёртывания», параметру `image` — «Тег образа развёртывания». +1. В поле «Пример значений» выберите сущность и проверьте, что строки параметров содержат ожидаемые значения. +1. Нажмите «Сохранить». -Нажмите «Сохранить». - -Если после сохранения изменить ресурс роли, форма очистит зависимые связи и параметры. Проверьте их перед повторным сохранением. +Сопоставления отдельного ресурса можно изменить из каталога: откройте меню ресурса → «Маппинг главной», выберите «Роль ресурса на главной» и назначьте роли его свойствам и связям. Порядок описан [в настройке со страницы ресурса](../home/mapping/#настройка-со-страницы-ресурса). ## Проверка результата diff --git a/content/documentation/admin/examples/home-quick-start.ru.md b/content/documentation/admin/examples/home-quick-start.ru.md index 569274e8..588a6f88 100644 --- a/content/documentation/admin/examples/home-quick-start.ru.md +++ b/content/documentation/admin/examples/home-quick-start.ru.md @@ -1,7 +1,7 @@ --- title: Быстрая настройка главной weight: 30 -description: Пошаговая настройка главной DDP на новой установке — мастер первоначальной настройки, включение главной, учётные данные, реестр шаблонов, привязка процессов к шаблонам и проверка результата. +description: Пошаговая настройка главной DDP на новой установке — мастер первоначальной настройки, учётные данные, реестр шаблонов, привязка процессов к шаблонам и проверка результата. --- Инструкция описывает настройку главной на новой установке Deckhouse Development Portal (DDP, портал) с каноничной моделью каталога. В результате на главной отображаются окружения и развёртывания кластера, а разработчики создают микросервисы из шаблонов и разворачивают их на окружения. @@ -36,15 +36,15 @@ description: Пошаговая настройка главной DDP на но Если применение набора завершилось ошибкой, исправьте причину и нажмите «Повторить с текущего». -## Включение главной +## Проверка набора маппинга -Главная выключена после установки портала. Включите её: +Проверьте, что мастер создал набор маппинга для разделов каталога: 1. Перейдите в раздел «Администрирование» → «Справочники» → «Правила маппинга». 1. Убедитесь, что в таблице есть набор «Главная (по умолчанию)» с включённым переключателем «По умолчанию для главной». -1. Включите переключатель «Показывать главную». +1. Откройте вкладку «Главная» и перейдите из раздела «Рабочие пространства» в нужный раздел каталога. -В верхней панели портала появится вкладка «Главная». +Вкладка «Главная» доступна сразу после установки портала. ## Учётные данные diff --git a/content/documentation/admin/examples/home-widget-slot.ru.md b/content/documentation/admin/examples/home-widget-slot.ru.md index cd359976..589dde87 100644 --- a/content/documentation/admin/examples/home-widget-slot.ru.md +++ b/content/documentation/admin/examples/home-widget-slot.ru.md @@ -14,7 +14,7 @@ description: Вывод виджета GitLab на вкладках «Пайпл - разрешения на создание виджетов и разрешение `update:home-mapping-sets`; - внешний сервис GitLab; -- у сущностей микросервисов — параметр с числовым ID проекта GitLab, сопоставленный роли `microservice_gitlab_project_id`. В каноничной модели каталога это параметр `gitlab_repository_id`, который заполняет процесс создания микросервиса из шаблона или источник данных «GitLab: активность репозиториев». +- у сущностей микросервисов — параметр с числовым ID проекта GitLab, сопоставленный роли `microservice_repository_id`. В каноничной модели каталога это параметр `vcs_repository_id`, который заполняет процесс создания микросервиса из шаблона. Для собственного каталога настройте заполнение параметра вашим процессом или источником данных. Набор данных «GitLab: виджеты» создаёт готовые виджеты для обеих вкладок. Инструкция показывает, как настроить виджет самостоятельно, например для другой системы контроля версий или с другими параметрами. @@ -33,7 +33,7 @@ description: Вывод виджета GitLab на вкладках «Пайпл | `.context.microservice.uuid` | UUID сущности микросервиса | | `.context.microservice.slug` | Идентификатор микросервиса | | `.context.microservice.name` | Название микросервиса | -| `.context.repository.id` | Значение роли `microservice_gitlab_project_id` | +| `.context.repository.id` | Значение роли `microservice_repository_id` | | `.context.repository.url` | Значение роли `microservice_repository` | Контекст передаётся только на вкладках карточки микросервиса. Для дашбордов создайте отдельный виджет с конкретным ID проекта. @@ -58,4 +58,4 @@ description: Вывод виджета GitLab на вкладках «Пайпл На вкладке отображаются пайплайны репозитория выбранного микросервиса. При выборе другого микросервиса виджет показывает пайплайны его репозитория. -Если на вкладке отображается «Раздел пока недоступен», слот виджета не заполнен. Если виджет не показывает данные, проверьте, что у микросервиса заполнен параметр, сопоставленный роли `microservice_gitlab_project_id`. +Если на вкладке отображается «Раздел пока недоступен», слот виджета не заполнен. Если виджет не показывает данные, проверьте, что у микросервиса заполнен параметр, сопоставленный роли `microservice_repository_id`. diff --git a/content/documentation/admin/home/mapping.ru.md b/content/documentation/admin/home/mapping.ru.md index 3ee6237a..e8263c01 100644 --- a/content/documentation/admin/home/mapping.ru.md +++ b/content/documentation/admin/home/mapping.ru.md @@ -13,7 +13,6 @@ description: Справочник по наборам маппинга глав На панели над таблицей расположены: -- переключатель «Показывать главную» — включает и выключает главную для всех пользователей; - кнопка «Создать» — открывает форму нового набора; - поле «Поиск» — фильтрует наборы по названию и идентификатору. @@ -36,7 +35,7 @@ description: Справочник по наборам маппинга глав Права на работу с наборами: - `create:home-mapping-sets` — создание наборов; -- `update:home-mapping-sets` — изменение наборов, выбор набора по умолчанию, переключатель «Показывать главную»; +- `update:home-mapping-sets` — изменение наборов, выбор набора по умолчанию, настройка сопоставлений со страницы ресурса; - `delete:home-mapping-sets` — удаление наборов. Для просмотра наборов разрешение не требуется: наборы читает каждая страница главной. @@ -52,40 +51,53 @@ description: Справочник по наборам маппинга глав - «Идентификатор» — стабильный идентификатор набора: от 3 до 64 символов, строчные латинские буквы, цифры и дефис. После создания не меняется; - «По умолчанию для главной» — делает набор набором по умолчанию. Первый созданный набор становится набором по умолчанию автоматически. -На вкладке «Маппинг каталога» правила сгруппированы по областям главной. Каждая область раскрывается отдельно и содержит блоки: +На вкладке «Маппинг каталога» правила сгруппированы по областям главной. В области выберите ресурс каталога, затем назначьте роли его свойствам и связям. Действия, процессы шаблонов и виджеты настраиваются для всей области: | Блок | Назначение | | --- | --- | -| «Ресурс каталога» | Ресурс, на котором строится область | -| «Ресурсы каталога» | Несколько ресурсов области, у каждого свои свойства и связи. Используется в областях «Микросервисы» и «Общие ресурсы» | -| «Связи» | Связи, по которым главная обходит сущности области | -| «Свойства» | Идентификаторы параметров сущностей, которые читает главная | +| «Ресурсы каталога» | Карточки ресурсов выбранной области. Кнопка «Добавить ресурс каталога» добавляет ресурс; нажатие на карточку открывает его настройки | +| «Свойства ресурса» | Параметры выбранного ресурса с типами, примерами значений и полем «Роль на главной» | +| «Связи ресурса» | Связи выбранного ресурса, его роль в каждой связи, примеры и поле «Роль на главной» | +| «Возможности ресурса» | Состояние подключения реестра шаблонов для микросервисов; ссылка «Настройки ресурса» открывает каталог | | «Действия» | Слоты действий области | | «Действия по шаблонам» | Процессы, привязанные к шаблону микросервиса. Только в области «Микросервисы» | | «Виджеты» | Слоты виджетов. Только в области «Микросервисы» | -У каждого поля формы есть подсказка с описанием назначения роли, её действия и места на главной. +У каждой роли есть подсказка с описанием назначения и места использования на главной. Кнопка «Редактор спецификации» открывает весь набор в виде документа JSON. Кнопка «К форме» возвращает к форме. Удаление ключа в тексте спецификации не удаляет значение из формы: очистите значение в форме или замените его в тексте. ### Выбор связей и свойств -Список связей и свойств роли строится по ресурсу её родительской роли. Например, связь `has_deployment` выбирается из связей ресурса роли `microservice`, а свойство `environment_domain` — из параметров ресурса роли `environment`. +Настройка начинается с существующих свойств и связей ресурса. В строке параметра или связи выберите значение в поле «Роль на главной»; неиспользуемые строки оставьте со значением «Не используется». -Пока родительская роль не сопоставлена ресурсу, поле недоступно и отображается подсказка «Сначала настройте маппинг связанной роли ресурса, чтобы выбрать элементы из его каталога». +Для проверки значений выберите сущность в поле «Пример значений». В таблице свойств появятся её значения, в таблице связей — число связанных сущностей. Если сущностей нет, назначение ролей остаётся доступным. -При смене ресурса роли форма очищает связи и свойства, которые зависят от этой роли. -Например, при смене ресурса роли `system` очищаются связи `contains_service` и `contains_shared` во всех ресурсах областей «Микросервисы» и «Общие ресурсы». -Очистка выполняется в форме до сохранения; сохраните набор, чтобы изменения применились. +При добавлении ресурса форма предлагает свободные роли по идентификаторам параметров. Например, `language` сопоставляется с `microservice_language`, а `kind` — с `shared_kind`. Такие значения отмечаются «Предложено»; проверьте их перед сохранением. + +Одну роль свойства можно назначить только одному параметру выбранного ресурса. В списке занятая роль отмечается «Роль уже назначена: {property}». Направление роли связи зависит от того, является выбранный ресурс родителем или потомком. + +Незаполненные роли перечисляются в строке «Не закрыто: {roles}». Раздел продолжает работать, а соответствующие поля сущностей остаются пустыми. Для данных собственного каталога назначайте роли явно: идентификатор параметра сам по себе не заменяет сохранённое сопоставление. ### Несколько ресурсов области В областях «Микросервисы» и «Общие ресурсы» роль можно сопоставить нескольким ресурсам каталога, например микросервисам из разных систем учёта. Для каждого ресурса задаются собственные свойства и связи. -Чтобы добавить ресурс, нажмите «Добавить ресурс» и заполните карточку ресурса. -Связь, родитель которой находится в другой области, например `contains_service` от системы к микросервису, доступна для выбора после того, как сопоставлен ресурс этой области. -При смене ресурса в карточке её свойства и связи очищаются. +Нажмите «Добавить ресурс каталога», выберите ресурс и настройте его строки. Для перехода между ресурсами нажимайте их карточки. Кнопка «Убрать ресурс из роли» удаляет сопоставление выбранного ресурса; сам ресурс каталога сохраняется. + +## Настройка со страницы ресурса + +Роль ресурса и его сопоставления можно изменить непосредственно в каталоге. Для этого требуется `update:home-mapping-sets`: + +1. Откройте страницу ресурса в разделе «Каталог». +1. В меню ресурса выберите «Маппинг главной». +1. В поле «Роль ресурса на главной» выберите роль, например «Микросервис». +1. Назначьте роли в таблицах «Свойства ресурса» и «Связи ресурса», проверьте примеры значений и нажмите «Сохранить». + +Изменения записываются в набор по умолчанию. При смене роли ресурс удаляется из прежней роли и добавляется в выбранную. Очистка поля снимает его участие в главной. + +Действия, процессы по шаблонам и виджеты раздела настраиваются [с главной](#настройка-маппинга-с-главной) или в форме набора. Если набора нет, сначала создайте его в «Администрирование» → «Справочники» → «Правила маппинга». ## Области маппинга @@ -172,32 +184,22 @@ description: Справочник по наборам маппинга глав ### Микросервисы -Роли свойств микросервисов. Значения ролей `microservice_binding_*` записывает процесс создания микросервиса из шаблона; по ним работает [обновление из шаблона](../templates/updates/). +Роли свойств микросервисов сопоставляются параметрам репозитория и языка в вашей модели каталога: | Роль | Название в форме | Назначение | Каноничный параметр | | --- | --- | --- | --- | | `microservice_language` | «Язык микросервиса» | Колонка «Язык», фильтр «Все языки» | `language` | | `microservice_repository` | «Репозиторий микросервиса» | Ссылка на репозиторий; `.context.repository.url` виджетов | `repository` | -| `microservice_gitlab_project_id` | «ID проекта GitLab» | `.context.repository.id` виджетов | `gitlab_repository_id` | -| `microservice_binding_template_id` | «Идентификатор шаблона микросервиса» | Шаблон, из которого создан микросервис. По нему выбираются действия по шаблонам | `template_id` | -| `microservice_binding_template_version` | «Версия шаблона микросервиса» | Текущая версия шаблона в репозитории | `template_version` | -| `microservice_binding_template_source` | «Источник шаблона микросервиса» | Название реестра, из которого получен шаблон | `template_source` | -| `microservice_binding_template_update_policy` | «Политика обновления шаблона» | `manual` или `review-auto` | `template_update_policy` | -| `microservice_binding_template_upgrade_strategy` | «Стратегия обновления шаблона» | Стратегия обновления, заданная для микросервиса | `template_upgrade_strategy` | -| `microservice_binding_template_upgrade_overwrite` | «Пути, перезаписываемые при обновлении» | Список путей для перезаписи, заданный для микросервиса | `template_upgrade_overwrite` | -| `microservice_binding_template_upgrade_add_if_missing` | «Пути, добавляемые при обновлении» | Список добавляемых путей, заданный для микросервиса | `template_upgrade_add_if_missing` | +| `microservice_repository_id` | «Идентификатор репозитория в VCS» | `.context.repository.id` виджетов | `vcs_repository_id` | | `microservice_vcs_provider` | «Провайдер системы контроля версий» | Провайдер репозитория микросервиса | `vcs_provider` | -| `microservice_vcs_external_service_uuid` | «Внешний сервис системы контроля версий» | Внешний сервис GitLab, в котором находится репозиторий | `vcs_external_service_uuid` | -| `microservice_default_branch` | «Ветка по умолчанию микросервиса» | Ветка, в которую создаётся запрос на слияние с обновлением | `default_branch` | -| `microservice_open_mr_count` | «Открытые merge request» | Показатель «Открытые MR» | `open_mr_count` | -| `microservice_last_pipeline_status` | «Статус последнего пайплайна» | Показатель «Последний пайплайн» | `last_pipeline_status` | -| `microservice_last_pipeline_id` | «ID последнего пайплайна» | Номер пайплайна в показателе «Последний пайплайн» | `last_pipeline_id` | -| `microservice_last_pipeline_web_url` | «Ссылка на последний пайплайн» | Ссылка на пайплайн | `last_pipeline_web_url` | -| `microservice_last_commit_sha` | «Хэш последнего коммита» | Строка «Последняя поставка» | `last_commit_sha` | -| `microservice_last_commit_message` | «Сообщение последнего коммита» | Строка «Последняя поставка» | `last_commit_message` | -| `microservice_last_commit_author` | «Автор последнего коммита» | Строка «Последняя поставка» | `last_commit_author` | - -Если роли `microservice_binding_*`, `microservice_vcs_*` или `microservice_default_branch` не сопоставлены, механизм обновления из шаблона использует каноничные идентификаторы параметров из таблицы. +| `microservice_vcs_external_service_uuid` | «Внешний сервис системы контроля версий» | Внешний сервис, через который выполняются операции с репозиторием | `vcs_external_service_uuid` | +| `microservice_default_branch` | «Ветка по умолчанию микросервиса» | Ветка для сверки версии и запроса на слияние с обновлением | `default_branch` | + +Для обновления из шаблона сопоставьте параметры репозитория, провайдера, внешнего сервиса, идентификатора репозитория и ветки. Если роль не сопоставлена, соответствующее значение считается незаданным. + +Сведения о самом шаблоне записываются в [управляемые параметры](../templates/updates/#привязка-микросервиса-к-шаблону) с префиксом `ddp_`. Чтобы портал добавил их в схему ресурса, включите «Реестр шаблонов» на вкладке «Возможности DDP» формы «Редактировать ресурс». + +Управляемые параметры не участвуют в сопоставлении ролей. Их нельзя удалить, изменить их идентификатор или тип либо сделать редактируемыми. Префикс `ddp_` зарезервирован для параметров DDP. Выключение возможности сохраняет уже добавленные параметры. ### Окружения @@ -292,7 +294,7 @@ description: Справочник по наборам маппинга глав Если шаблон, к которому привязаны процессы, больше не доступен в реестре, строка отмечается «нет в реестре». Если реестр пуст, отображается подсказка «В реестре шаблонов нет доступных шаблонов — синхронизируйте реестр, чтобы привязать действия». -Главная определяет шаблон микросервиса по роли свойства `microservice_binding_template_id` в ресурсе этого микросервиса и выбирает процессы следующим образом: +Главная определяет шаблон микросервиса по управляемому параметру `ddp_template_id` сущности этого микросервиса и выбирает процессы следующим образом: - у микросервиса есть шаблон — используется процесс, привязанный к этому шаблону. Если процесс для действия не привязан, действие недоступно с подсказкой, например «Для шаблона {template} не задан процесс развёртывания»; - у микросервиса нет шаблона — для развёртывания и удаления с окружения используются процессы слотов `deploy_microservice` и `delete_microservice` из блока «Действия». @@ -319,7 +321,7 @@ description: Справочник по наборам маппинга глав | `.context.microservice.uuid` | UUID сущности микросервиса | | `.context.microservice.slug` | Идентификатор микросервиса | | `.context.microservice.name` | Название микросервиса | -| `.context.repository.id` | Значение роли `microservice_gitlab_project_id`, пустая строка, если значение не задано | +| `.context.repository.id` | Значение роли `microservice_repository_id`, пустая строка, если значение не задано | | `.context.repository.url` | Значение роли `microservice_repository` | Пример настройки — в разделе [«Виджет на вкладке микросервиса»](../examples/home-widget-slot/). diff --git a/content/documentation/admin/home/overview.ru.md b/content/documentation/admin/home/overview.ru.md index 9786983a..c21bfe6c 100644 --- a/content/documentation/admin/home/overview.ru.md +++ b/content/documentation/admin/home/overview.ru.md @@ -1,11 +1,11 @@ --- title: Обзор weight: 10 -description: Как главная страница DDP получает данные из каталога, какой набор правил маппинга она использует, как её включить и какие права нужны для работы с ней. +description: Как главная страница DDP получает данные из каталога, какой набор правил маппинга она использует, как настроить разделы и какие права нужны для работы с ними. --- -Главная — рабочее пространство разработчиков и владельцев систем в Deckhouse Development Portal (DDP, портал). -На ней собраны команды, системы и их интеграции, микросервисы, окружения, развёртывания, общие ресурсы и потребление ресурсов кластера. +Главная — страница разработчиков и владельцев систем в Deckhouse Development Portal (DDP, портал). +На ней собраны рабочие пространства с AI-агентом и IDE, команды, системы и их интеграции, микросервисы, окружения, развёртывания, общие ресурсы и потребление ресурсов кластера. С главной пользователи создают микросервисы из шаблонов, разворачивают их на окружения, заказывают ресурсы и обновляют микросервисы до новых версий шаблонов. {{< alert level="warning" >}} @@ -16,7 +16,9 @@ description: Как главная страница DDP получает дан ## Принцип работы -Главная не хранит собственных данных. Все объекты, которые она показывает, — это сущности каталога, а все действия — это процессы каталога. +Раздел «Рабочие пространства» показывает рабочие пространства пользователя и управляет их запуском, остановкой, IDE и чатом. Для его работы [подготовьте шаблоны и доступы](../workspaces/overview/). + +Остальные разделы используют сущности и процессы каталога. Какие ресурсы, связи, параметры, процессы и виджеты использовать, задают правила маппинга. Правила маппинга сопоставляют понятиям главной объекты каталога: @@ -66,32 +68,21 @@ flowchart LR Правила маппинга действуют для всех пользователей портала. Выбрать другой набор на главной пользователь не может. -## Включение главной - -Главная выключена после установки портала: вкладка «Главная» скрыта у всех пользователей, а адреса страниц главной перенаправляют в каталог. - -Чтобы включить главную: +## Открытие главной -1. Перейдите в раздел «Администрирование» → «Справочники» → «Правила маппинга». -1. Включите переключатель «Показывать главную». +Вкладка «Главная» доступна всем пользователям в верхней панели портала. При переходе на неё открывается раздел «Рабочие пространства». -Переключатель действует сразу для всех пользователей. Для его изменения требуется разрешение `update:home-mapping-sets`. - -При включении главной у пользователей в верхней панели появляется вкладка «Главная», а при переходе на неё открывается раздел «Команды». - -{{< alert level="info" >}} -Баннер «Платформа готова к настройке», из которого запускается мастер первоначальной настройки, отображается на главной. -Пока главная выключена, мастер доступен только в разделе «Администрирование» → «Справочники» → «Наборы данных». -{{< /alert >}} +Пользователи с разрешением `apply:seeds` могут запустить [мастер первоначальной настройки](setup/) из баннера «Платформа готова к настройке» на главной. ## Разделы главной -Разделы главной сгруппированы в боковом меню. Для работы каждого раздела нужны свои роли маппинга; если основная роль раздела не сопоставлена ресурсу каталога, в разделе отображается сообщение «Настройте правила маппинга или примените набор данных «Каноничная архитектура»». +Разделы главной сгруппированы в боковом меню. Раздел «Рабочие пространства» работает независимо от маппинга. Для разделов каталога нужны свои роли маппинга; если основная роль раздела не сопоставлена ресурсу каталога, в разделе отображается сообщение «Настройте правила маппинга или примените набор данных «Каноничная архитектура»». В таблице перечислены разделы, их основные роли ресурсов и слоты действий: | Группа | Раздел | Роли ресурсов | Слоты действий и действия по шаблонам | | --- | --- | --- | --- | +| AI-инструменты | [«Рабочие пространства»](../../user/workspaces/) | Правила маппинга не требуются | — | | Организация | «Команды» | Команды портала; `system`, `microservice` | — | | Архитектура | «Системы» | `system`, `microservice`, `shared_resource`, `deployment`, `environment`, `cluster`, `integration` | — | | Архитектура | «Интеграции» | `system`, `integration` | — | @@ -123,11 +114,11 @@ flowchart LR | `run:actions` на сущность микросервиса | Кнопка «Обновить» в карточке микросервиса | | `read:template-packs` | Галерея шаблонов в разделе «Создать микросервис» и уведомление о новой версии шаблона в карточке микросервиса | | `read:template-registries` | Уведомления о предварительных (prerelease) версиях шаблонов в карточке микросервиса | -| `update:home-mapping-sets` | Переключатели «Показывать главную» и «Настроить маппинг», изменение правил маппинга | +| `update:home-mapping-sets` | Переключатель «Настроить маппинг», изменение правил маппинга, в том числе со страницы ресурса | | `create:home-mapping-sets`, `delete:home-mapping-sets` | Создание и удаление наборов маппинга главной | | `apply:seeds` | Баннер «Платформа готова к настройке» и мастер первоначальной настройки | -Для просмотра главной отдельное разрешение не требуется: вкладка «Главная» доступна всем пользователям, если главная включена. +Для просмотра главной отдельное разрешение не требуется: вкладка «Главная» доступна всем пользователям. Для рабочих пространств действуют [права на пространства и шаблоны](../security/rbac/#рабочие-пространства-и-шаблоны); доступ к разделу «AI» для работы со своими пространствами на главной не требуется. {{< alert level="warning" >}} Пресет роли «Developer» не содержит разрешения `read:entities`. @@ -141,7 +132,6 @@ flowchart LR Чтобы подготовить главную к работе, выполните следующие шаги: 1. Примените наборы данных [мастером первоначальной настройки](setup/) или настройте [правила маппинга](mapping/) для собственной модели каталога. -1. Включите переключатель «Показывать главную». 1. Подключите [реестр шаблонов](../templates/registry/) и привяжите процессы к шаблонам в блоке «Действия по шаблонам». 1. При необходимости добавьте собственные процессы в слоты действий. Требования к таким процессам описаны в разделе [«Процессы главной»](processes/). diff --git a/content/documentation/admin/home/processes.ru.md b/content/documentation/admin/home/processes.ru.md index 7ad8fc28..21a7323e 100644 --- a/content/documentation/admin/home/processes.ru.md +++ b/content/documentation/admin/home/processes.ru.md @@ -103,7 +103,7 @@ properties: | --- | --- | | `.context.template.id` | Идентификатор шаблона микросервиса | | `.context.template.version` | Целевая версия шаблона — последняя доступная | -| `.context.upgrade.strategy` | Стратегия обновления: значение роли `microservice_binding_template_upgrade_strategy` микросервиса, если оно задано, иначе стратегия из пакета шаблона | +| `.context.upgrade.strategy` | Стратегия обновления: значение управляемого параметра `ddp_template_upgrade_strategy` микросервиса, если оно задано, иначе стратегия из пакета шаблона | | `.context.upgrade.overwrite` | Перезаписываемые пути: значение микросервиса или пакета | | `.context.upgrade.add_if_missing` | Добавляемые пути: значение микросервиса или пакета | | `.context.review.title` | Заголовок запроса на слияние: `Upgrade to ` | diff --git a/content/documentation/admin/home/setup.ru.md b/content/documentation/admin/home/setup.ru.md index 2bfd90cf..08c0d152 100644 --- a/content/documentation/admin/home/setup.ru.md +++ b/content/documentation/admin/home/setup.ru.md @@ -30,7 +30,7 @@ description: Мастер первоначальной настройки гла Баннер видят только пользователи с разрешением `apply:seeds`. Баннер скрывается для всех пользователей кнопкой «Скрыть» или автоматически после успешного применения всех выбранных наборов. Чтобы вернуть баннер, включите переключатель «Показывать баннер первоначальной настройки» в разделе «Наборы данных». -Главная выключена после установки портала, поэтому на новой установке баннер не отображается, пока не включён переключатель «Показывать главную». +Главная доступна сразу после установки. Для запуска мастера откройте вкладку «Главная» в верхней панели портала. ## Шаги мастера @@ -90,13 +90,10 @@ description: Мастер первоначальной настройки гла | «Привязка общих ресурсов» | Источник данных «Привязки секретов», процессы «Подключить секреты к приложению» и «Отключить общий ресурс» | «Внешний сервис Kubernetes», «Источник данных Deployments» | | «Управление окружениями» | Процессы «Создать окружение» и «Удалить окружение» | «Внешний сервис Kubernetes», «Источник данных Namespaces» | | «GitLab: группы» | Источник данных групп GitLab для выбора пространства при создании микросервиса | «Внешний сервис GitLab» | -| «GitLab: активность репозиториев» | Источник данных, который заполняет в карточке микросервиса число открытых запросов на слияние, последний пайплайн и последний коммит | «Внешний сервис GitLab», «Все репозитории», «ID групп GitLab», «Включать подгруппы» | | «GitLab: виджеты» | Виджеты «GitLab: пайплайны репозитория» и «GitLab: merge requests репозитория» для вкладок карточки микросервиса | «Внешний сервис GitLab» | | «Deckhouse managed PostgreSQL», «Deckhouse managed Valkey», «Deckhouse managed Kafka» | Действия, процессы заказа и удаления managed-сервиса, источник данных | «Внешний сервис Kubernetes», «Внешний сервис Vault или Stronghold», «Префикс пути Vault» и параметры создания объектов | | «Каноничная архитектура (привязки главной)» | Добавляет процессы и виджеты выбранных наборов в слоты набора маппинга `home-default`. Применяется только мастером | — | -Если в наборе «GitLab: активность репозиториев» выключен параметр «Все репозитории», заполните «ID групп GitLab». - Источники данных Kubernetes собирают только объекты с лейблом `ddp.deckhouse.io/environment` и пропускают неймспейсы `d8-*` и `kube-*`. Какие слоты заполняет набор «Каноничная архитектура (привязки главной)», показано в таблице: @@ -116,7 +113,6 @@ description: Мастер первоначальной настройки гла Мастер не выполняет часть настроек, которые зависят от конкретной установки. Выполните их вручную: -1. Включите главную: «Администрирование» → «Справочники» → «Правила маппинга» → переключатель «Показывать главную». 1. Заполните учётные данные в профиле пользователя: токен сервисного аккаунта Kubernetes, токен Vault, персональный токен и имя пользователя GitLab. Процессы главной выполняют действия с учётными данными пользователя, который их запускает, поэтому учётные данные нужны каждому пользователю, запускающему процессы. 1. Подключите реестр шаблонов и выполните синхронизацию. Порядок описан в разделе [«Реестр шаблонов»](../templates/registry/). diff --git a/content/documentation/admin/security/rbac.ru.md b/content/documentation/admin/security/rbac.ru.md index 345693e2..cd429050 100644 --- a/content/documentation/admin/security/rbac.ru.md +++ b/content/documentation/admin/security/rbac.ru.md @@ -171,7 +171,7 @@ AI-агенты и навыки: Правила маппинга главной: - `create:home-mapping-sets` — создание наборов маппинга главной. -- `update:home-mapping-sets` — изменение наборов маппинга главной, выбор набора по умолчанию, включение и выключение главной. Подробнее — [в документации по правилам маппинга](../home/mapping/). +- `update:home-mapping-sets` — изменение наборов маппинга главной, выбор набора по умолчанию и настройка сопоставлений со страницы ресурса. Подробнее — [в документации по правилам маппинга](../home/mapping/). - `delete:home-mapping-sets` — удаление наборов маппинга главной. Шаблоны микросервисов: @@ -309,6 +309,8 @@ AI-агенты и навыки: `update:workspace` разрешает запуск, обновление и открытие IDE, `cancel:workspace` — остановку. Повтор операции дополнительно проверяет право на её вид. Создание рабочего пространства всегда требует глобального `create:workspaces` и права использования выбранного шаблона. +Свои рабочие пространства доступны на главной без `view:ai-page`. Это разрешение требуется для входа в раздел «AI» с его настройками и общей таблицей пространств. + Прикрепление к чату и выполнение заданий процесса требуют пространства самого пользователя. Для процесса также необходима привязка к его сущности. Публиковать порты, менять их уровень доступа и отменять публикацию может владелец с правом обновления рабочего пространства. Для приложений «Только владелец» действует такое же ограничение на открытие. Приложения «Пользователи DDP» доступны любому вошедшему незаблокированному пользователю, «Публично» — без входа; права на карточку рабочего пространства для открытия этих ссылок не требуются. Допустимый уровень публикации портов [ограничивается шаблоном](../../workspaces/apps/#уровни-доступа). diff --git a/content/documentation/admin/templates/updates.ru.md b/content/documentation/admin/templates/updates.ru.md index dcce00f1..4ebf4d9b 100644 --- a/content/documentation/admin/templates/updates.ru.md +++ b/content/documentation/admin/templates/updates.ru.md @@ -13,6 +13,7 @@ description: Как DDP обновляет репозитории микросе - подключён и синхронизирован [реестр шаблонов](registry/); - в правилах маппинга главной для шаблона привязан процесс действия «Обновить микросервис из шаблона»: «Микросервисы» → «[Действия по шаблонам](../home/mapping/#действия-по-шаблонам)». Набор данных «Реестр шаблонов микросервисов» создаёт процесс «Обновить микросервис из шаблона», который можно привязать к любому шаблону; +- в ресурсе микросервисов включён «Реестр шаблонов» на вкладке «Возможности DDP» формы «Редактировать ресурс», а параметры репозитория [сопоставлены ролям главной](../home/mapping/#микросервисы); - микросервис создан из шаблона: в репозитории есть lock-файл `.ddp/template.lock.yaml`, а у сущности микросервиса заполнены параметры привязки к шаблону. ## Привязка микросервиса к шаблону @@ -33,20 +34,31 @@ values: Lock-файл содержит значения параметров, переданные при создании, без значений по умолчанию из схемы. По lock-файлу портал определяет текущую версию шаблона в репозитории и значения параметров для отрисовки новой версии. Не удаляйте и не изменяйте lock-файл вручную: без него репозиторий обновить нельзя. -В сущность микросервиса записываются параметры привязки. В таблице указаны параметры каноничной модели каталога и роли маппинга, через которые портал их находит: +В сущность микросервиса записываются управляемые параметры привязки. При включении «Реестр шаблонов» на вкладке «Возможности DDP» ресурс получает следующие параметры: -| Параметр | Название | Роль маппинга | Значение | -| --- | --- | --- | --- | -| `template_id` | «Идентификатор шаблона» | `microservice_binding_template_id` | Идентификатор шаблона | -| `template_version` | «Версия шаблона» | `microservice_binding_template_version` | Текущая версия шаблона в репозитории | -| `template_source` | «Источник шаблона» | `microservice_binding_template_source` | Название реестра, из которого получен шаблон | -| `template_update_policy` | «Политика обновления шаблона» | `microservice_binding_template_update_policy` | «Вручную» (`manual`) или «Ревью автоматически» (`review-auto`) | -| `template_upgrade_strategy` | «Стратегия обновления шаблона» | `microservice_binding_template_upgrade_strategy` | Стратегия обновления для этого микросервиса | -| `template_upgrade_overwrite` | «Перезаписываемые пути обновления» | `microservice_binding_template_upgrade_overwrite` | Список перезаписываемых путей для этого микросервиса | -| `template_upgrade_add_if_missing` | «Добавляемые пути обновления» | `microservice_binding_template_upgrade_add_if_missing` | Список добавляемых путей для этого микросервиса | -| `default_branch` | — | `microservice_default_branch` | Ветка, в которую создаётся запрос на слияние с обновлением | -| `vcs_provider` | — | `microservice_vcs_provider` | Провайдер системы контроля версий | -| `vcs_external_service_uuid` | «Внешний сервис VCS» | `microservice_vcs_external_service_uuid` | Внешний сервис GitLab, в котором находится репозиторий | +| Параметр | Название | Значение | +| --- | --- | --- | +| `ddp_template_id` | «Идентификатор шаблона» | Идентификатор шаблона | +| `ddp_template_version` | «Версия шаблона» | Текущая версия шаблона в репозитории | +| `ddp_template_source` | «Источник шаблона» | Название реестра, из которого получен шаблон | +| `ddp_template_update_policy` | «Политика обновления шаблона» | «Вручную» (`manual`) или «Ревью автоматически» (`review-auto`) | +| `ddp_template_upgrade_strategy` | «Стратегия обновления шаблона» | Стратегия обновления для этого микросервиса | +| `ddp_template_upgrade_overwrite` | «Перезаписываемые пути обновления» | Список перезаписываемых путей для этого микросервиса | +| `ddp_template_upgrade_add_if_missing` | «Добавляемые пути обновления» | Список добавляемых путей для этого микросервиса | + +Портал читает эти параметры по фиксированным идентификаторам. Назначать им роли маппинга не требуется. Их схему защищает DDP: удалить параметр, изменить его идентификатор или тип либо сделать его редактируемым нельзя. Выключение возможности сохраняет добавленные параметры. + +Параметры репозитория остаются частью вашей модели каталога. Сопоставьте их следующим ролям главной: + +| Роль | Каноничный параметр | Значение | +| --- | --- | --- | +| `microservice_repository` | `repository` | HTTPS-адрес репозитория | +| `microservice_repository_id` | `vcs_repository_id` | Идентификатор репозитория в системе контроля версий | +| `microservice_default_branch` | `default_branch` | Ветка для запроса на слияние с обновлением | +| `microservice_vcs_provider` | `vcs_provider` | Провайдер системы контроля версий | +| `microservice_vcs_external_service_uuid` | `vcs_external_service_uuid` | Внешний сервис для операций с репозиторием | + +Назначьте роли явно в [настройках маппинга ресурса](../home/mapping/#настройка-со-страницы-ресурса). При незаданной роли портал считает соответствующее значение незаполненным. Микросервис привязан к паре «шаблон и реестр»: обновления предлагаются только из версий шаблона того же реестра. diff --git a/content/documentation/admin/workspaces/_index.ru.md b/content/documentation/admin/workspaces/_index.ru.md index 8a54578a..2e380591 100644 --- a/content/documentation/admin/workspaces/_index.ru.md +++ b/content/documentation/admin/workspaces/_index.ru.md @@ -1,5 +1,5 @@ --- title: Рабочие пространства -description: Настройка рабочих пространств, их шаблонов и синхронизации из GitLab. +description: Настройка рабочих пространств, шаблонов, запуска в sandbox и синхронизации из GitLab. weight: 76 --- diff --git a/content/documentation/admin/workspaces/overview.ru.md b/content/documentation/admin/workspaces/overview.ru.md index de6c98c2..1fed69fd 100644 --- a/content/documentation/admin/workspaces/overview.ru.md +++ b/content/documentation/admin/workspaces/overview.ru.md @@ -18,6 +18,8 @@ weight: 10 1. Если используются закрытые хранилища образов, подготовьте Secrets для скачивания образов [в соответствующих неймспейсах](network-storage/#образы-из-закрытого-хранилища). 1. Для шаблона с репозиторием создайте подключение Git и заполните реквизиты. Пользователям потребуется [AI-провайдер](../../user/ai-assistant/#подключение-ai-провайдера). +Для запуска рабочего пространства в sandbox на Kata Containers или gVisor [настройте RuntimeClass в шаблоне](sandbox/). + При установке модулем `development-platform` Jobs операций OpenTofu выполняются в неймспейсе модуля. Под, том и Ingress рабочего пространства создаются в кластере и неймспейсе, выбранных в шаблоне. Эти места могут различаться. ## Лимиты установки diff --git a/content/documentation/admin/workspaces/sandbox.ru.md b/content/documentation/admin/workspaces/sandbox.ru.md new file mode 100644 index 00000000..93e98246 --- /dev/null +++ b/content/documentation/admin/workspaces/sandbox.ru.md @@ -0,0 +1,133 @@ +--- +title: Запуск в sandbox с Kata или gVisor +description: Настройка RuntimeClass в шаблоне рабочего пространства, выбор Kata Containers или gVisor и проверка запуска в Kubernetes. +weight: 45 +--- + +Рабочее пространство можно запускать в изолированной среде Kata Containers или gVisor. Для этого укажите RuntimeClass в OpenTofu-шаблоне рабочего пространства. Менять код DDP и пересобирать его образы не требуется. + +RuntimeClass применяется ко всему поду: агенту OpenCode, IDE, веб-терминалу, шлюзу `gate` и контейнеру `bootstrap`. В штатном шаблоне они используют общую сеть и постоянный том. + +## Подготовка кластера + +В целевом кластере Kubernetes должны быть настроены Kata Containers или gVisor и соответствующий RuntimeClass. Установка среды выполнения зависит от конфигурации кластера: [инструкция Kata Containers](https://github.com/kata-containers/kata-containers/tree/main/tools/packaging/kata-deploy), [инструкция gVisor](https://gvisor.dev/docs/user_guide/quick_start/kubernetes/). + +Проверьте доступные классы с правами администратора целевого кластера: + +```shell +d8 k --context=workspace-cluster get runtimeclass +``` + +Замените `workspace-cluster` на контекст целевого кластера. Выберите название из `metadata.name` RuntimeClass, например `kata-qemu` или `gvisor`. Название класса и его `handler` могут различаться; в шаблоне указывается название класса. + +Если среда выполнения доступна только на части узлов, настройте `scheduling.nodeSelector` и при необходимости `scheduling.tolerations` в RuntimeClass. Без этих ограничений Kubernetes считает, что класс поддерживается всеми узлами. Дополнительные затраты CPU и памяти задаются в `overhead`. Порядок настройки описан [в документации RuntimeClass](https://kubernetes.io/docs/concepts/containers/runtime-class/). + +Подготовьте также [подключение Kubernetes, сеть и постоянный том](overview/). Проверьте, что выбранная среда выполнения поддерживает используемое хранилище и сетевые подключения рабочего пространства. + +## Указание среды выполнения в шаблоне + +Для запуска на определённом RuntimeClass измените черновик [шаблона рабочего пространства](templates/): + +1. Откройте «AI» → «Рабочие пространства» → «Шаблоны рабочих пространств» и выберите шаблон. +1. На вкладке «Файлы» откройте `main.tf`. +1. Найдите `resource "kubernetes_stateful_set_v1" "runtime"` и добавьте в его блок `spec` → `template` → `spec` поле: + + ```hcl + runtime_class_name = "kata-qemu" + ``` + +1. Замените `kata-qemu` на название выбранного класса. Например, для класса gVisor с названием `gvisor` укажите `runtime_class_name = "gvisor"`. +1. Сохраните черновик и [проверьте запуск](#проверка-запуска). +1. После проверки опубликуйте и активируйте новую версию шаблона. + +Поле находится на уровне пода, рядом с `automount_service_account_token` и `security_context`. Добавлять его в отдельный контейнер или в `ddp_runtime` не требуется. Штатный провайдер Kubernetes поддерживает `runtime_class_name`. + +Для существующего рабочего пространства остановите его, выполните [обновление версии шаблона](../../user/workspaces/#обновление-шаблона) и запустите снова. Публикация версии сама по себе существующие пространства не обновляет. + +## Автоматический выбор доступного класса + +Если один шаблон должен выбирать Kata или gVisor по наличию RuntimeClass, запросите список классов из целевого кластера. Учётной записи [подключения Kubernetes шаблона](overview/#выбор-учётных-данных) потребуется право `list` на `runtimeclasses` в API-группе `node.k8s.io` на уровне кластера. При отсутствии права запрос завершится ошибкой доступа. + +Добавьте в `main.tf` запрос и блок локальных значений: + +```hcl +data "kubernetes_resources" "sandbox_runtime_classes" { + api_version = "node.k8s.io/v1" + kind = "RuntimeClass" +} + +locals { + sandbox_runtime_priority = ["kata-qemu", "kata", "gvisor"] + available_runtime_classes = [ + for runtime_class in data.kubernetes_resources.sandbox_runtime_classes.objects : + runtime_class.metadata.name + ] + matching_sandbox_classes = [ + for name in local.sandbox_runtime_priority : name + if contains(local.available_runtime_classes, name) + ] + sandbox_runtime_class = length(local.matching_sandbox_classes) > 0 ? local.matching_sandbox_classes[0] : null +} +``` + +В `sandbox_runtime_priority` укажите названия классов вашей установки в порядке выбора. Пример выбирает первый существующий класс: сначала `kata-qemu`, затем `kata`, затем `gvisor`. Наличие RuntimeClass проверяет регистрацию класса, но не работоспособность его обработчика на узлах. + +В блоке `spec` → `template` → `spec` StatefulSet используйте выбранное значение вместо фиксированной строки: + +```hcl +runtime_class_name = local.sandbox_runtime_class +``` + +Чтобы отсутствие подходящего класса останавливало применение шаблона, добавьте проверку в существующий блок `lifecycle` этого StatefulSet. Сохраните его настройку `ignore_changes`: + +```hcl +lifecycle { + ignore_changes = [spec[0].replicas] + + precondition { + condition = local.sandbox_runtime_class != null + error_message = "No configured sandbox RuntimeClass is available in the target cluster." + } +} +``` + +При пустом списке совпадений операция завершится указанной ошибкой. Этот пример требует sandbox и не запускает рабочее пространство на среде выполнения кластера по умолчанию. + +Выбор выполняется при создании или обновлении рабочего пространства, когда применяется OpenTofu-шаблон. Обычные остановка и запуск меняют число реплик StatefulSet и используют уже сохранённый класс. Для повторного выбора выполните обновление рабочего пространства. + +## Проверка запуска + +Создайте новое рабочее пространство из черновика, доступного редактору шаблона. Затем проверьте результат: + +1. Дождитесь успешной операции создания и статуса «Работает». +1. Проверьте класс фактически созданного пода: + + ```shell + d8 k --context=workspace-cluster -n workspace-team get pod ddp-ws-0a26ad26-0 -o jsonpath='{.spec.runtimeClassName}{"\n"}' + ``` + + Замените контекст, неймспейс и название пода на значения рабочего пространства. Название пода доступно в его диагностике. Команда должна вывести выбранный класс, например `kata-qemu` или `gvisor`. + +1. Проверьте, что под готов, а в его событиях нет ошибок запуска среды выполнения. Значение `runtimeClassName` само по себе показывает только запрошенный класс. +1. Откройте IDE и веб-терминал, выполните задание агента в чате и проверьте публикацию HTTP-приложения, если она используется. +1. Создайте файл в рабочей директории, остановите и снова запустите рабочее пространство. Проверьте, что файл сохранился и класс пода остался выбранным. + +Работу приложений и инструментов проверяйте на выбранной среде выполнения: поддержка системных вызовов, устройств и операций с файлами зависит от Kata или gVisor и их конфигурации. + +## Устранение ошибок + +При ошибке откройте [диагностику рабочего пространства](../../user/workspaces/#диагностика), логи операции и события пода: + +| Симптом | Что проверить | +| --- | --- | +| Ошибка доступа при чтении RuntimeClass | Право `list` у учётной записи целевого Kubernetes-подключения; применяется только к автоматическому выбору | +| `No configured sandbox RuntimeClass is available in the target cluster.` | Названия в `sandbox_runtime_priority` и наличие соответствующих RuntimeClass | +| Под не создаётся или не запускается после выбора класса | Существование RuntimeClass, настройку его `handler` на узлах и события StatefulSet и пода | +| Под остаётся в состоянии Pending | Ограничения размещения RuntimeClass, taints узлов, доступные CPU и память с учётом `overhead`, подключение постоянного тома | +| Контейнер запускается, но инструмент завершается ошибкой | Логи контейнера и совместимость инструмента с выбранной средой выполнения | + +## Границы настройки + +Шаблон задаёт среду выполнения пода рабочего пространства. Job операции OpenTofu запускается отдельно; его среда выполнения определяется настройками кластера, в котором выполняются Jobs операций. + +RuntimeClass выбирает среду выполнения контейнеров. Для ограничения сетевых соединений настройте NetworkPolicy отдельно; доступ к объектам портала по-прежнему регулируется [ролевой моделью DDP](../security/rbac/#рабочие-пространства-и-шаблоны). diff --git a/content/documentation/admin/workspaces/templates.ru.md b/content/documentation/admin/workspaces/templates.ru.md index c8533890..8a1a3e81 100644 --- a/content/documentation/admin/workspaces/templates.ru.md +++ b/content/documentation/admin/workspaces/templates.ru.md @@ -15,7 +15,7 @@ weight: 20 1. На вкладке «Подключение» выберите «Подключение Kubernetes» и «Namespace». При необходимости выберите сервисную учётную запись. 1. Для работы с проектом включите «Инициализировать репозиторием», выберите «Подключение Git», задайте HTTPS URL и ветку. Если проект выбирает пользователь, включите «Разрешить переопределять при создании». Для пространства без Git оставьте инициализацию выключенной. 1. Сохраните шаблон и откройте вкладку «Файлы». -1. В `main.tf` задайте `local.ide_domain`, например `example-workspaces.com`, и проверьте [параметры Ingress, TLS, образов и хранения](network-storage/). Используйте отдельный домен от DDP и Dex. +1. В `main.tf` задайте `local.ide_domain`, например `example-workspaces.com`, и проверьте [параметры Ingress, TLS, образов и хранения](network-storage/). Используйте отдельный домен от DDP и Dex. Для запуска пода на Kata Containers или gVisor [укажите RuntimeClass](sandbox/). 1. В настройках шаблона в блоке «Приложения» задайте «Потолок уровня для публикации портов». Состав приложений и количество адресов настраиваются [в файлах шаблона](apps/). 1. Нажмите «Сохранить», затем «Опубликовать v1». 1. На вкладке «Версии» нажмите «Активировать v1». diff --git a/content/documentation/release-notes/v1.8.0.ru.md b/content/documentation/release-notes/v1.8.0.ru.md index 86a588d0..2a1541b6 100644 --- a/content/documentation/release-notes/v1.8.0.ru.md +++ b/content/documentation/release-notes/v1.8.0.ru.md @@ -13,6 +13,7 @@ description: Рабочие пространства с IDE, AI-агентом При обновлении учитывайте изменения проверок и доступа: - Для использования 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. @@ -20,7 +21,7 @@ description: Рабочие пространства с IDE, AI-агентом Добавлены возможности работы с проектами и AI: -- [Рабочие пространства](../user/workspaces/) создаются из шаблона, открываются в IDE и выполняют задания из чата. +- Добавлены [рабочие пространства](../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 и новые инструменты работы с каталогом. Коллекция может включать отдельные инструменты, серверы и группы портала целиком. @@ -29,6 +30,7 @@ description: Рабочие пространства с IDE, AI-агентом ## Улучшения +- Главная страница доступна всем пользователям по умолчанию. Настройка скрытия главной страницы удалена. - Обновлена [страница сущности](../user/catalog/#страница-сущности); в списке доступны фильтры по статусу и команде. - Для задач, AI-шагов и параллельных шлюзов процессов настраивается [тайм-аут](../admin/processes/overview/#задача). - Лимит [чатов AI-ассистента](../user/ai-assistant/#чаты) увеличен с 20 до 50 на пользователя. diff --git a/content/documentation/user/home/microservices.ru.md b/content/documentation/user/home/microservices.ru.md index 6120ef4f..399f4f64 100644 --- a/content/documentation/user/home/microservices.ru.md +++ b/content/documentation/user/home/microservices.ru.md @@ -106,7 +106,6 @@ description: Создание микросервиса из шаблона на | Поле | Содержимое | | --- | --- | | «Репозиторий» | Ссылка на репозиторий | -| «Последняя поставка» | Ветка, коммит, сообщение и автор последнего коммита. Если данные ещё не получены, — «Ещё не синхронизировано» | | «Шаблон» | Идентификатор шаблона, из которого создан микросервис, или «Нет» | | «Версия» | Текущая версия шаблона | | «Владелец», «Команда владелец» | Владелец и команда-владелец сущности | @@ -114,7 +113,7 @@ description: Создание микросервиса из шаблона на | «Окружения» | Окружения, кластеры и версии образа на каждом окружении | | «Общие ресурсы» | Общие ресурсы, подключённые к развёртываниям микросервиса | -Ниже отображаются показатели «Открытые MR» и «Последний пайплайн» со статусом и ссылкой на пайплайн. +Данные о пайплайнах и запросах на слияние доступны на соответствующих вкладках, если администратор настроил виджеты. ### Вкладки «Пайплайны» и «MRs» diff --git a/content/documentation/user/home/overview.ru.md b/content/documentation/user/home/overview.ru.md index acf32ad4..70b42bb6 100644 --- a/content/documentation/user/home/overview.ru.md +++ b/content/documentation/user/home/overview.ru.md @@ -4,23 +4,24 @@ weight: 10 description: Главная страница DDP — разделы и навигация, сообщения при отсутствии данных, запуск процессов и отслеживание их выполнения. --- -Главная — рабочее пространство разработчиков и владельцев систем. На главной собраны команды, системы и их интеграции, микросервисы, окружения, развёртывания и общие ресурсы. +Главная — страница разработчиков и владельцев систем. На главной собраны рабочие пространства с AI-агентом и IDE, команды, системы и их интеграции, микросервисы, окружения, развёртывания и общие ресурсы. С главной создаются микросервисы из шаблонов, микросервисы разворачиваются на окружения, заказываются ресурсы и создаются окружения. {{< alert level="warning" >}} Главная — функциональность на стадии Preview. Состав разделов и их поведение могут измениться в следующих выпусках без сохранения обратной совместимости. {{< /alert >}} -Главная открывается вкладкой «Главная» в верхней панели портала. Если вкладки нет, главная выключена администратором портала; при переходе по адресу страницы главной открывается каталог. +Главная открывается вкладкой «Главная» в верхней панели портала и доступна всем пользователям. Первым открывается раздел «Рабочие пространства». -Главная показывает данные каталога. Какие ресурсы каталога отображаются на главной и какие процессы запускаются её кнопками, задаёт администратор портала в [правилах маппинга](../../admin/home/mapping/). +Раздел «Рабочие пространства» показывает ваши рабочие пространства и работает без правил маппинга каталога. Остальные разделы показывают данные каталога. Какие ресурсы каталога отображаются на главной и какие процессы запускаются её кнопками, задаёт администратор портала в [правилах маппинга](../../admin/home/mapping/). ## Разделы -Разделы главной сгруппированы в боковом меню. Группа раскрывается нажатием на стрелку, нажатие на название группы открывает её первый раздел. При открытии главной открывается раздел «Команды». +Разделы главной сгруппированы в боковом меню. Группа раскрывается нажатием на стрелку, нажатие на название группы открывает её первый раздел. При открытии главной открывается раздел «Рабочие пространства». | Группа | Раздел | Назначение | | --- | --- | --- | +| «AI-инструменты» | [«Рабочие пространства»](../workspaces/) | Ваши рабочие пространства, создание из шаблона, IDE и чат агента | | «Организация» | [«Команды»](teams/) | Команды портала, их участники, системы и микросервисы | | «Архитектура» | [«Системы»](architecture/#системы) | Системы по доменам, их зависимости, микросервисы, общие ресурсы и окружения | | «Архитектура» | [«Интеграции»](architecture/#интеграции) | Интеграции между системами | diff --git a/content/documentation/user/home/teams.ru.md b/content/documentation/user/home/teams.ru.md index 34b4296e..564215d8 100644 --- a/content/documentation/user/home/teams.ru.md +++ b/content/documentation/user/home/teams.ru.md @@ -4,7 +4,7 @@ weight: 20 description: Раздел главной DDP «Команды» — показатели команд, карта команд и профиль команды с её системами и микросервисами. --- -Раздел «Команды» показывает команды портала, их участников и системы и микросервисы, которыми владеют команды. Раздел открывается при переходе на главную. +Раздел «Команды» показывает команды портала, их участников и системы и микросервисы, которыми владеют команды. Чтобы открыть раздел, перейдите в «Главная» → «Организация» → «Команды». Команды и их участники задаются в разделе «Администрирование». Подробнее — в разделе [«Команды и пользователи»](../teams-users/). Системы и микросервисы команды определяются по полю «Команда владелец» их сущностей в каталоге. diff --git a/content/documentation/user/interface.ru.md b/content/documentation/user/interface.ru.md index 2e0d7453..2277ecf3 100644 --- a/content/documentation/user/interface.ru.md +++ b/content/documentation/user/interface.ru.md @@ -6,7 +6,7 @@ weight: 20 Интерфейс Deckhouse Development Portal (DDP, портал) состоит из следующих разделов: -- «Главная» — страница разработчика: команды, системы, микросервисы, окружения, развёртывание и заказ ресурсов. Вкладка отображается, если главная включена администратором. Подробнее — в разделе [«Главная»](home/overview/). +- «Главная» — страница разработчика: рабочие пространства с AI-агентом и IDE, команды, системы, микросервисы, окружения, развёртывание и заказ ресурсов. Подробнее — в разделе [«Главная»](home/overview/). - «Каталог» — сервисный каталог для просмотра ресурсов, сущностей и связей, а также для запуска действий и сценариев. - «Самообслуживание» — раздел для настройки источников данных, действий, вебхуков, автоматизаций, сценариев, дашбордов и виджетов. Доступ к разделу может быть ограничен ролевой моделью. - «AI» — раздел рабочих пространств, навыков, агентов, AI-провайдеров, MCP-инструментов и статистики использования. Подробнее — в разделе [«Управление MCP»](mcp-management/). Доступ к разделу может быть ограничен ролевой моделью. @@ -30,7 +30,7 @@ weight: 20 В правой части верхней панели портала расположены кнопки: -- «AI-ассистент» — открывает окно [AI-ассистента](ai-assistant/#работа-с-ai-ассистентом); +- «AI-ассистент» — открывает окно [AI-ассистента](ai-assistant/#работа-с-ai-ассистентом). На странице рабочего пространства чат встроен в страницу, поэтому кнопка недоступна; - «Мои активности» — открывает панель с запусками ваших действий и процессов. Пока у вас выполняются процессы, значок кнопки заменяется индикатором, а на вкладке «Процессы» отображается число выполняющихся процессов. ## Глобальный поиск diff --git a/content/documentation/user/workspace-chat.ru.md b/content/documentation/user/workspace-chat.ru.md index 7ec523c2..25158fb7 100644 --- a/content/documentation/user/workspace-chat.ru.md +++ b/content/documentation/user/workspace-chat.ru.md @@ -4,18 +4,20 @@ description: Задания AI-агенту рабочего пространс weight: 56 --- -Прикреплённое [рабочее пространство](workspaces/) переводит чат AI-ассистента на агента OpenCode этого пространства. Агент получает доступ к рабочим файлам и терминалу. Выбранный для обычного чата агент из каталога в этом режиме не выполняет задачу. +Чат на странице [рабочего пространства](workspaces/) обращается к его агенту OpenCode. К тому же пространству можно прикрепить чат AI-ассистента; он также переключится на OpenCode. Агент получает доступ к рабочим файлам и терминалу. Выбранный для обычного чата агент из каталога в этом режиме не выполняет задачу. ## Начало работы Чтобы продолжить работу с проектом в чате: 1. Создайте и запустите рабочее пространство. -1. Откройте его карточку и нажмите «Открыть чат». Для существующего чата используйте кнопку «Прикрепить рабочее пространство» в AI-ассистенте. +1. В разделе «Главная» → «AI-инструменты» → «Рабочие пространства» нажмите «Открыть» в карточке. Чат расположен на странице пространства. Для существующего чата используйте кнопку «Прикрепить рабочее пространство» в AI-ассистенте. 1. Проверьте прикреплённое пространство и отправьте задачу. 1. Во время выполнения отвечайте на вопросы и запросы подтверждения агента. 1. Проверьте итоговый ответ и изменения файлов. +На странице пространства кнопка AI-ассистента в верхней панели недоступна: используйте встроенный чат. + Чат и IDE используют одну рабочую копию. Открывайте IDE для просмотра и редактирования файлов, запуска тестов и работы с Git. ## Подтверждения действий @@ -61,4 +63,4 @@ weight: 56 Сессия агента хранит историю работы в пространстве. При длинном диалоге нажмите «Сжать контекст»; операция отображается отдельным заданием со статусом «Сжатие контекста». -Расход токенов, длительность заданий и ожидание подтверждений доступны [в статистике AI](ai-statistics/). История отдельных заданий находится на вкладке «Задания» рабочего пространства. +Расход токенов, длительность заданий и ожидание подтверждений доступны [в статистике AI](ai-statistics/). История отдельных заданий находится на вкладке «Задания» карточки рабочего пространства в разделе «AI». diff --git a/content/documentation/user/workspaces.ru.md b/content/documentation/user/workspaces.ru.md index 46661ae5..8a0a977b 100644 --- a/content/documentation/user/workspaces.ru.md +++ b/content/documentation/user/workspaces.ru.md @@ -4,26 +4,42 @@ description: Создание рабочего пространства с IDE weight: 55 --- -Рабочее пространство — персональная IDE и AI-агент OpenCode в Kubernetes. Агент читает и изменяет файлы, выполняет команды и отвечает в прикреплённом чате. IDE и чат работают с одними файлами; после остановки данные сохраняются на постоянном томе. +Рабочее пространство — персональная IDE и AI-агент OpenCode в Kubernetes. Агент читает и изменяет файлы, выполняет команды и отвечает в чате рабочего пространства или AI-ассистента. IDE и чат работают с одними файлами; после остановки данные сохраняются на постоянном томе. Администратор подготавливает [шаблон рабочего пространства](../admin/workspaces/templates/), который задаёт кластер, репозиторий, инструменты и параметры запуска. Рабочее пространство можно создать с репозиторием или с пустой рабочей директорией, если это предусмотрено шаблоном. +## Ваши рабочие пространства + +Откройте «Главная» → «AI-инструменты» → «Рабочие пространства». Раздел показывает только ваши пространства и доступен без разрешения на вход в раздел «AI». + +Найдите пространство по названию или репозиторию и выберите фильтр состояния: «Все», «Работают», «Остановлены», «В процессе» или «Требуют внимания». Карточка показывает состояние, репозиторий и текущую операцию. Кнопка «Открыть» переходит на страницу с чатом агента; кнопка «IDE» открывает редактор. Над списком отображается использование настроенных лимитов. + +Если у вас есть доступ к разделу «AI», его таблица «Рабочие пространства» позволяет просматривать пространства в пределах выданных прав. Настройки шаблонов и источников также находятся в разделе «AI». + ## Создание рабочего пространства Перед созданием подключите [AI-провайдера](ai-assistant/#подключение-ai-провайдера). Если шаблон использует личные реквизиты, заполните в профиле [учётные данные](credentials/) для его подключений Kubernetes и Git. -Чтобы создать рабочее пространство: +Чтобы создать рабочее пространство с главной: -1. Откройте «AI» → «Рабочие пространства» и нажмите «Создать рабочее пространство». -1. На шаге «Шаблон» выберите шаблон. Для обычного запуска используйте активную опубликованную версию. -1. Укажите «Название». Если шаблон разрешает выбор репозитория, заполните «URL репозитория» и при необходимости «Ветка или тег». Пустая ветка означает основную ветку репозитория. URL должен использовать HTTPS и относиться к подключению Git шаблона. +1. Откройте «Главная» → «AI-инструменты» → «Рабочие пространства» и нажмите «Создать». +1. На шаге «Шаблон» выберите карточку шаблона и нажмите «Далее». Поиск отбирает шаблоны по названию и описанию. +1. На шаге «Параметры и запуск» укажите «Название» и проверьте версию шаблона. Для обычного запуска используйте активную опубликованную версию. +1. Если шаблон разрешает выбор репозитория, заполните «URL репозитория» и при необходимости «Ветка или тег». Пустая ветка означает основную ветку репозитория. URL должен использовать HTTPS и относиться к подключению Git шаблона. 1. При необходимости выберите «Ресурс сущности» и «Сущность каталога». Привязка задаётся при создании; она нужна, чтобы процессы сущности могли выполнять задания в этом рабочем пространстве. -1. На шаге «Параметры шаблона» заполните обязательные параметры и проверьте значения по умолчанию. -1. На шаге «Ассистент и срок» выберите «AI-провайдер» и «Срок работы», затем нажмите «Создать». -1. Дождитесь статуса «Работает». Подробности создания доступны на вкладке «Операции». +1. Заполните обязательные параметры шаблона, выберите «AI-провайдер» и «Срок работы». Проверьте итоговые параметры справа и нажмите «Создать». +1. Дождитесь статуса «Работает». После создания открывается страница пространства; во время операции она показывает лог, а после запуска — чат агента. Если доступных шаблонов нет, попросите администратора опубликовать и активировать версию шаблона и выдать доступ к нему. Создание также требует настроенных лимитов установки и разрешения `create:workspaces`. +## Страница рабочего пространства + +Страница открывается кнопкой «Открыть» в карточке. В центре расположен чат агента. Кнопки в заголовке открывают IDE и приложения, запускают и останавливают пространство. Обновление версии и удаление доступны в меню «Ещё». + +Кнопка «Подробнее» открывает боковую панель с вкладками «Операции», «Диагностика» и «Приложения и порты». Здесь можно проверить применение шаблона, состояние пода и публикации приложений. Чат остаётся на странице при открытии панели. + +Если пространство остановлено, запустите его для продолжения чата. При ошибке операции используйте «Показать лог» и «Повторить операцию» после устранения причины. Чат с агентом доступен только владельцу пространства. + ## Работа в IDE Откройте карточку работающего рабочего пространства и нажмите «Открыть IDE». Разрешите браузеру открыть новую вкладку. @@ -34,7 +50,7 @@ IDE открывается на отдельном HTTPS-домене. Вход ## Приложения рабочего пространства -На вкладке «Приложения» доступны приложения шаблона и опубликованные порты. В стартовом шаблоне приложение «Терминал» открывает командную строку в браузере с доступом к файлам рабочего пространства. Его может открыть только владелец с правом обновления пространства. +На странице пространства нажмите «Подробнее» → «Приложения и порты». В карточке раздела «AI» тот же список находится на вкладке «Приложения». Здесь доступны приложения шаблона и опубликованные порты. В стартовом шаблоне приложение «Терминал» открывает командную строку в браузере с доступом к файлам рабочего пространства. Его может открыть только владелец с правом обновления пространства. Чтобы открыть приложение, нажмите «Открыть» в его карточке. Индикатор «Работает» означает, что порт слушается в поде; готовность самого приложения проверьте после открытия. После запуска сервера нажмите «Обновить», чтобы перечитать состояние портов. @@ -43,7 +59,7 @@ IDE открывается на отдельном HTTPS-домене. Вход Для предпросмотра веб-приложения опубликуйте его порт: 1. Запустите HTTP-сервер в IDE, веб-терминале или через агента. Он должен быть доступен по `127.0.0.1` внутри пода. Публикация поддерживает HTTP и WebSocket. -1. Откройте вкладку «Приложения» и нажмите «Опубликовать порт». Можно также нажать «Опубликовать» у нужного порта в блоке «Порты, которые слушаются в поде». +1. Откройте «Подробнее» → «Приложения и порты» и нажмите «Опубликовать порт». Можно также нажать «Опубликовать» у нужного порта в блоке «Порты, которые слушаются в поде». 1. Заполните «Название», «Порт» и «Уровень доступа». Допустимые уровни ограничены шаблоном. 1. Подтвердите публикацию и откройте полученный адрес. При необходимости скопируйте его кнопкой «Скопировать адрес». @@ -71,7 +87,7 @@ IDE открывается на отдельном HTTPS-домене. Вход Чтобы агент изменил проект: -1. В карточке рабочего пространства нажмите «Открыть чат» или прикрепите пространство в AI-ассистенте кнопкой «Прикрепить рабочее пространство». +1. Нажмите «Открыть» в карточке пространства на главной. Для существующего чата AI-ассистента используйте «Прикрепить рабочее пространство». 1. Убедитесь, что чат показывает прикреплённое рабочее пространство. 1. Отправьте задачу с ожидаемым результатом, например: @@ -79,7 +95,7 @@ IDE открывается на отдельном HTTPS-домене. Вход Изучи проект, добавь проверку /healthz и тест для неё. Запусти связанные тесты и покажи изменённые файлы. Коммит не создавай. ``` -1. Проверьте ответ, выполненные команды и изменения файлов. История заданий доступна также на вкладке «Задания» карточки пространства. +1. Проверьте ответ, выполненные команды и изменения файлов. История заданий доступна также на вкладке «Задания» карточки пространства в разделе «AI». Одновременно в рабочем пространстве выполняется одно задание. Следующие сообщения ожидают в очереди. Остановка ответа прерывает текущее задание; само рабочее пространство продолжает работать. @@ -100,7 +116,7 @@ IDE открывается на отдельном HTTPS-домене. Вход Чтобы применить новую версию: 1. Остановите рабочее пространство. -1. Нажмите «Обновить версию». +1. Откройте меню «Ещё» → «Обновить версию». 1. Проверьте выбранную версию и параметры. Если активная опубликованная версия шаблона новее текущей, форма сразу предлагает её. Текущий черновик остаётся выбранным, если он доступен пользователю. При необходимости выберите другую доступную версию. Форма отмечает новые, удалённые и изменённые значения. 1. Подтвердите обновление и проверьте его результат на вкладке «Операции». Переход на другую версию доступен и без изменения значений параметров. 1. После успешного обновления запустите рабочее пространство. @@ -109,7 +125,7 @@ IDE открывается на отдельном HTTPS-домене. Вход ## Диагностика -Сначала откройте карточку пространства и найдите последнюю операцию с ошибкой. Используйте подходящую вкладку: +На странице пространства нажмите «Подробнее» и найдите последнюю операцию с ошибкой. В разделе «AI» откройте карточку пространства. Используйте подходящую вкладку: | Вкладка | Что проверить | | --- | --- | @@ -132,6 +148,6 @@ IDE открывается на отдельном HTTPS-домене. Вход ## Удаление -Перед удалением отправьте нужные изменения в Git или скопируйте файлы из IDE. Нажмите «Удалить» и подтвердите действие. +Перед удалением отправьте нужные изменения в Git или скопируйте файлы из IDE. На странице пространства откройте «Ещё» → «Удалить» и подтвердите действие. Удаление уничтожает объекты рабочего пространства в Kubernetes и постоянные данные. Остановка подходит для перерыва в работе, удаление — для окончательного освобождения ресурсов. From 70abca48591b6c827b4778911dc6a459adc796a5 Mon Sep 17 00:00:00 2001 From: Nikita Velgin Date: Fri, 30 Oct 2026 13:44:07 +0300 Subject: [PATCH 2/2] fixes --- content/documentation/admin/overview.ru.md | 26 +++++++++++++++ content/documentation/user/ai-assistant.ru.md | 6 ++-- .../user/home/microservices.ru.md | 4 +-- .../documentation/user/home/overview.ru.md | 18 ++-------- content/documentation/user/interface.ru.md | 19 +---------- .../documentation/user/workspace-chat.ru.md | 2 +- content/documentation/user/workspaces.ru.md | 33 +++++++++---------- 7 files changed, 52 insertions(+), 56 deletions(-) diff --git a/content/documentation/admin/overview.ru.md b/content/documentation/admin/overview.ru.md index 0af7f1ef..9659cbae 100644 --- a/content/documentation/admin/overview.ru.md +++ b/content/documentation/admin/overview.ru.md @@ -12,3 +12,29 @@ weight: 10 - [Создание шаблона](workspaces/templates/): проект OpenTofu, параметры, публикация и активация. - [Файлы и скрипты](workspaces/files/) и [образы, Ingress и хранение](workspaces/network-storage/): примеры изменения стартового шаблона. - [AI-агенты](ai-agents/overview/) и [навыки](ai-agents/skills/): инструменты и инструкции агентов. + +## Разделы настройки + +Настройка механизмов портала выполняется в разделах верхней панели: + +| Раздел | Назначение | +| --- | --- | +| «Самообслуживание» | Источники данных, действия, вебхуки, автоматизации, сценарии, дашборды и виджеты | +| «AI» | Агенты, MCP, шаблоны рабочих пространств, навыки и статистика использования | +| «Администрирование» | Команды, пользователи, политики доступа, учётные данные и справочники | + +Для входа в эти разделы требуются соответствующие [разрешения](security/rbac/). + +## Раздел AI + +Раздел «AI» открывается на каталоге агентов. Настройки и журналы сгруппированы в боковом меню: + +| Группа | Пункты меню | +| --- | --- | +| «Агенты» | «Каталог», «Источники агентов», «Шаблоны провайдеров» | +| «MCP» | «Каталог», «MCP-серверы», «MCP-коллекции», «MCP-инструменты» | +| «Рабочие пространства» | «Рабочие пространства», «Шаблоны рабочих пространств», «Источники шаблонов» | +| «Навыки» | «Навыки», «Источники навыков» | +| «Использование» | «Аудит», «Статистика» | + +Каталог агентов показывает источник языковой модели: «Модель DDP» означает работу через AI-провайдера запускающего пользователя, «Модель агента» — собственное подключение внешнего агента к модели. Платформенный агент всегда использует модель DDP. diff --git a/content/documentation/user/ai-assistant.ru.md b/content/documentation/user/ai-assistant.ru.md index 1ed6d254..5e321041 100644 --- a/content/documentation/user/ai-assistant.ru.md +++ b/content/documentation/user/ai-assistant.ru.md @@ -8,7 +8,7 @@ AI-ассистент — чат, встроенный в Deckhouse Development На вопросы в AI-ассистенте отвечает [AI-агент](../admin/ai-agents/overview/). По умолчанию выбран платформенный агент, который разворачивается вместе с порталом. Агент обращается к языковой модели через AI-провайдера пользователя. -Для работы с AI-ассистентом требуется доступ хотя бы к одному включённому агенту: глобальное `use:ai-agents` или объектное `use:ai-agent`. Владение даёт права при включённом `owner-is-admin`. +Для работы с AI-ассистентом выберите доступного агента. Если список агентов пуст, обратитесь к администратору портала. ## Подключение AI-провайдера @@ -182,8 +182,8 @@ Authorization: Bearer {{ .token }} | --- | --- | | «Для вашей учётной записи не настроен AI-провайдер. Добавьте его в настройках профиля.» | У пользователя нет AI-провайдера. Подключите провайдера, как описано в разделе [«Подключение AI-провайдера»](#подключение-ai-провайдера) | | «Выберите AI-провайдера» | Для выбранного агента нужен провайдер. Выберите провайдера в поле «Провайдер» | -| «Недостаточно прав для запуска этого AI-агента» | Нет глобального `use:ai-agents` или объектного `use:ai-agent` на выбранного агента; проверьте роль и доступ к агенту | +| «Недостаточно прав для запуска этого AI-агента» | Выберите другого доступного агента или обратитесь к администратору портала | | «LLM-провайдер отклонил запрос. Проверьте API-ключи в настройках профиля.» | Провайдер не принял токен. Проверьте токен и заголовки провайдера | | «Превышен лимит запросов к LLM-провайдеру. Попробуйте позже.» | Провайдер ограничил число запросов | -Ошибки вызова внешних агентов описаны в разделе [«Внешние агенты»](../admin/ai-agents/external-agents/#устранение-неполадок). +При ошибке вызова внешнего агента передайте администратору название агента и сообщение об ошибке. diff --git a/content/documentation/user/home/microservices.ru.md b/content/documentation/user/home/microservices.ru.md index 399f4f64..cea6d359 100644 --- a/content/documentation/user/home/microservices.ru.md +++ b/content/documentation/user/home/microservices.ru.md @@ -11,7 +11,7 @@ description: Создание микросервиса из шаблона на Мастер создания микросервиса открывается в разделе «Создать микросервис» или кнопкой «Создать микросервис» в разделе «Микросервисы». Мастер состоит из трёх шагов: «Шаблон», «Сервис» и «Параметры». -Для создания микросервиса требуется разрешение `read:template-packs`. Без него отображается сообщение «Недостаточно прав для просмотра галереи шаблонов.». +Если отображается сообщение «Недостаточно прав для просмотра галереи шаблонов.», обратитесь к администратору портала. ### Шаг «Шаблон» @@ -151,4 +151,4 @@ URL строится по Ingress-ресурсам окружения: хост - обновление уже выполняется — «Процесс обновления шаблона уже выполняется для этого сервиса.»; - для шаблона не настроен процесс обновления — «Для шаблона {template} не задан процесс обновления. Задайте его в правилах маппинга главной, в действиях по шаблонам.». -Если для микросервиса включено автоматическое обновление, портал сам открывает merge request после выхода новой версии шаблона. Настройка автоматического обновления описана в разделе [«Обновление из шаблона»](../../admin/templates/updates/#автоматическое-обновление) руководства администратора. +Если для микросервиса включено автоматическое обновление, портал сам открывает merge request после выхода новой версии шаблона. Проверьте изменения и примите запрос в GitLab. diff --git a/content/documentation/user/home/overview.ru.md b/content/documentation/user/home/overview.ru.md index 70b42bb6..6c9b3142 100644 --- a/content/documentation/user/home/overview.ru.md +++ b/content/documentation/user/home/overview.ru.md @@ -13,7 +13,7 @@ description: Главная страница DDP — разделы и нави Главная открывается вкладкой «Главная» в верхней панели портала и доступна всем пользователям. Первым открывается раздел «Рабочие пространства». -Раздел «Рабочие пространства» показывает ваши рабочие пространства и работает без правил маппинга каталога. Остальные разделы показывают данные каталога. Какие ресурсы каталога отображаются на главной и какие процессы запускаются её кнопками, задаёт администратор портала в [правилах маппинга](../../admin/home/mapping/). +Раздел «Рабочие пространства» показывает ваши рабочие пространства. В остальных разделах собраны данные каталога: команды, системы, микросервисы и окружения. ## Разделы @@ -43,11 +43,11 @@ description: Главная страница DDP — разделы и нави | Сообщение | Причина | | --- | --- | -| «Настройте правила маппинга или примените набор данных «Каноничная архитектура»» | Ресурс для раздела не настроен в правилах маппинга, не удалось загрузить сущности или у вас нет прав на просмотр сущностей этого ресурса | +| «Настройте правила маппинга или примените набор данных «Каноничная архитектура»» | Данные раздела не настроены или недоступны. Обратитесь к администратору портала | | «Сущностей пока нет. Создайте их в каталоге или синхронизируйте через datasource.» | Ресурс настроен, но в нём нет сущностей | | «Раздел пока недоступен» | Раздел находится в разработке, или для вкладки не настроен виджет | -Если сообщение о правилах маппинга отображается только у вас, запросите у администратора портала доступ к сущностям ресурса. +Если ожидаемые данные не отображаются, сообщите администратору, какой раздел вы открыли и какое сообщение видите. ## Запуск процессов @@ -86,15 +86,3 @@ description: Главная страница DDP — разделы и нави Итог выполнения процесса — успех или ошибка — отображается в панели «Мои активности» на вкладке «Процессы». Панель открывается значком часов в верхней панели портала; пока у вас выполняются процессы, значок заменяется индикатором. После завершения процесса раздел загружает данные заново. Если объект создаётся синхронизацией источника данных, он появляется на главной после следующей синхронизации. - -## Первоначальная настройка - -Пользователи с разрешением `apply:seeds` видят в верхней части главной баннер «Платформа готова к настройке». Кнопка «Запустить» открывает мастер первоначальной настройки, кнопка «Скрыть» скрывает баннер для всех пользователей. - -Мастер описан в разделе [«Первоначальная настройка»](../../admin/home/setup/) руководства администратора. - -## Настройка маппинга с главной - -Пользователи с разрешением `update:home-mapping-sets` видят в нижней части бокового меню переключатель «Настроить маппинг». Когда переключатель включён, рядом с разделами появляется значок настройки правил маппинга раздела. - -Порядок настройки описан в разделе [«Правила маппинга»](../../admin/home/mapping/#настройка-маппинга-с-главной). diff --git a/content/documentation/user/interface.ru.md b/content/documentation/user/interface.ru.md index 2277ecf3..25a64bb1 100644 --- a/content/documentation/user/interface.ru.md +++ b/content/documentation/user/interface.ru.md @@ -4,27 +4,10 @@ description: Разделы DDP, верхняя панель и поиск су weight: 20 --- -Интерфейс Deckhouse Development Portal (DDP, портал) состоит из следующих разделов: +Интерфейс Deckhouse Development Portal (DDP, портал) объединяет разделы для работы с проектами: - «Главная» — страница разработчика: рабочие пространства с AI-агентом и IDE, команды, системы, микросервисы, окружения, развёртывание и заказ ресурсов. Подробнее — в разделе [«Главная»](home/overview/). - «Каталог» — сервисный каталог для просмотра ресурсов, сущностей и связей, а также для запуска действий и сценариев. -- «Самообслуживание» — раздел для настройки источников данных, действий, вебхуков, автоматизаций, сценариев, дашбордов и виджетов. Доступ к разделу может быть ограничен ролевой моделью. -- «AI» — раздел рабочих пространств, навыков, агентов, AI-провайдеров, MCP-инструментов и статистики использования. Подробнее — в разделе [«Управление MCP»](mcp-management/). Доступ к разделу может быть ограничен ролевой моделью. -- «Администрирование» — раздел для управления командами, пользователями, политиками доступа и учётными данными. Доступ к разделу может быть ограничен ролевой моделью. - -## Раздел AI - -Раздел «AI» открывается на каталоге агентов. Настройки и журналы сгруппированы в боковом меню: - -| Группа | Пункты меню | -| --- | --- | -| «Агенты» | «Каталог», «Источники агентов», «Шаблоны провайдеров» | -| «MCP» | «Каталог», «MCP-серверы», «MCP-коллекции», «MCP-инструменты» | -| «Рабочие пространства» | «Рабочие пространства», «Шаблоны рабочих пространств», «Источники шаблонов» | -| «Навыки» | «Навыки», «Источники навыков» | -| «Использование» | «Аудит», «Статистика» | - -Каталог агентов показывает источник языковой модели: «Модель DDP» означает работу через AI-провайдера запускающего пользователя, «Модель агента» — собственное подключение внешнего агента к модели. Платформенный агент всегда использует модель DDP. ## Верхняя панель diff --git a/content/documentation/user/workspace-chat.ru.md b/content/documentation/user/workspace-chat.ru.md index 25158fb7..ff859786 100644 --- a/content/documentation/user/workspace-chat.ru.md +++ b/content/documentation/user/workspace-chat.ru.md @@ -63,4 +63,4 @@ weight: 56 Сессия агента хранит историю работы в пространстве. При длинном диалоге нажмите «Сжать контекст»; операция отображается отдельным заданием со статусом «Сжатие контекста». -Расход токенов, длительность заданий и ожидание подтверждений доступны [в статистике AI](ai-statistics/). История отдельных заданий находится на вкладке «Задания» карточки рабочего пространства в разделе «AI». +Расход токенов, длительность заданий и ожидание подтверждений доступны [в статистике AI](ai-statistics/). Ответы агента, выполненные команды и запросы подтверждения сохраняются в истории чата. diff --git a/content/documentation/user/workspaces.ru.md b/content/documentation/user/workspaces.ru.md index 8a0a977b..9469e01b 100644 --- a/content/documentation/user/workspaces.ru.md +++ b/content/documentation/user/workspaces.ru.md @@ -6,16 +6,14 @@ weight: 55 Рабочее пространство — персональная IDE и AI-агент OpenCode в Kubernetes. Агент читает и изменяет файлы, выполняет команды и отвечает в чате рабочего пространства или AI-ассистента. IDE и чат работают с одними файлами; после остановки данные сохраняются на постоянном томе. -Администратор подготавливает [шаблон рабочего пространства](../admin/workspaces/templates/), который задаёт кластер, репозиторий, инструменты и параметры запуска. Рабочее пространство можно создать с репозиторием или с пустой рабочей директорией, если это предусмотрено шаблоном. +Рабочее пространство создаётся из шаблона, который задаёт репозиторий, инструменты и параметры запуска. Рабочее пространство можно создать с репозиторием или с пустой рабочей директорией, если это предусмотрено шаблоном. ## Ваши рабочие пространства -Откройте «Главная» → «AI-инструменты» → «Рабочие пространства». Раздел показывает только ваши пространства и доступен без разрешения на вход в раздел «AI». +Откройте «Главная» → «AI-инструменты» → «Рабочие пространства». Раздел показывает ваши рабочие пространства. Найдите пространство по названию или репозиторию и выберите фильтр состояния: «Все», «Работают», «Остановлены», «В процессе» или «Требуют внимания». Карточка показывает состояние, репозиторий и текущую операцию. Кнопка «Открыть» переходит на страницу с чатом агента; кнопка «IDE» открывает редактор. Над списком отображается использование настроенных лимитов. -Если у вас есть доступ к разделу «AI», его таблица «Рабочие пространства» позволяет просматривать пространства в пределах выданных прав. Настройки шаблонов и источников также находятся в разделе «AI». - ## Создание рабочего пространства Перед созданием подключите [AI-провайдера](ai-assistant/#подключение-ai-провайдера). Если шаблон использует личные реквизиты, заполните в профиле [учётные данные](credentials/) для его подключений Kubernetes и Git. @@ -30,7 +28,7 @@ weight: 55 1. Заполните обязательные параметры шаблона, выберите «AI-провайдер» и «Срок работы». Проверьте итоговые параметры справа и нажмите «Создать». 1. Дождитесь статуса «Работает». После создания открывается страница пространства; во время операции она показывает лог, а после запуска — чат агента. -Если доступных шаблонов нет, попросите администратора опубликовать и активировать версию шаблона и выдать доступ к нему. Создание также требует настроенных лимитов установки и разрешения `create:workspaces`. +Если шаблонов нет или кнопка создания недоступна, обратитесь к администратору портала. ## Страница рабочего пространства @@ -50,7 +48,7 @@ IDE открывается на отдельном HTTPS-домене. Вход ## Приложения рабочего пространства -На странице пространства нажмите «Подробнее» → «Приложения и порты». В карточке раздела «AI» тот же список находится на вкладке «Приложения». Здесь доступны приложения шаблона и опубликованные порты. В стартовом шаблоне приложение «Терминал» открывает командную строку в браузере с доступом к файлам рабочего пространства. Его может открыть только владелец с правом обновления пространства. +На странице пространства нажмите «Подробнее» → «Приложения и порты». Здесь доступны приложения шаблона и опубликованные порты. В стартовом шаблоне приложение «Терминал» открывает командную строку в браузере с доступом к файлам рабочего пространства. Терминал предназначен для владельца рабочего пространства. Чтобы открыть приложение, нажмите «Открыть» в его карточке. Индикатор «Работает» означает, что порт слушается в поде; готовность самого приложения проверьте после открытия. После запуска сервера нажмите «Обновить», чтобы перечитать состояние портов. @@ -63,7 +61,7 @@ IDE открывается на отдельном HTTPS-домене. Вход 1. Заполните «Название», «Порт» и «Уровень доступа». Допустимые уровни ограничены шаблоном. 1. Подтвердите публикацию и откройте полученный адрес. При необходимости скопируйте его кнопкой «Скопировать адрес». -Публикация доступна владельцу с правом `update:workspaces` или `update:workspace`. Она создаёт маршрут и не запускает приложение. Для сервера с проверкой заголовка `Host` разрешите внешний хост опубликованного порта. +Публиковать порты может владелец рабочего пространства. Публикация создаёт маршрут; сервер приложения запустите самостоятельно. Для сервера с проверкой заголовка `Host` разрешите внешний хост опубликованного порта. Адрес имеет вид `https://p1-ddp-ws-<суффикс>.<домен-рабочих-пространств>`. Количество свободных адресов задаёт шаблон; в стартовом шаблоне их восемь. Если свободных адресов нет, отмените ненужную публикацию. Порт, уже занятый приложением шаблона, повторно не публикуется. @@ -73,7 +71,7 @@ IDE открывается на отдельном HTTPS-домене. Вход | Уровень | Кто может открыть | | --- | --- | -| «Только владелец» | Владелец с правом обновления рабочего пространства | +| «Только владелец» | Владелец рабочего пространства | | «Пользователи DDP» | Любой вошедший в портал пользователь, который не заблокирован | | «Публично» | Любой посетитель без входа в портал | @@ -95,7 +93,7 @@ IDE открывается на отдельном HTTPS-домене. Вход Изучи проект, добавь проверку /healthz и тест для неё. Запусти связанные тесты и покажи изменённые файлы. Коммит не создавай. ``` -1. Проверьте ответ, выполненные команды и изменения файлов. История заданий доступна также на вкладке «Задания» карточки пространства в разделе «AI». +1. Проверьте ответ, выполненные команды и изменения файлов. Одновременно в рабочем пространстве выполняется одно задание. Следующие сообщения ожидают в очереди. Остановка ответа прерывает текущее задание; само рабочее пространство продолжает работать. @@ -121,30 +119,31 @@ IDE открывается на отдельном HTTPS-домене. Вход 1. Подтвердите обновление и проверьте его результат на вкладке «Операции». Переход на другую версию доступен и без изменения значений параметров. 1. После успешного обновления запустите рабочее пространство. -Данные постоянных томов сохраняются. Изменение шаблона, которое удаляет или заменяет существующий постоянный том, отклоняется. Файлы, которыми управляет шаблон, при следующем запуске обновляются по [политике доставки файлов](../admin/workspaces/files/). +Данные постоянных томов сохраняются. Изменение шаблона, которое удаляет или заменяет существующий постоянный том, отклоняется. Файлы, которыми управляет шаблон, могут перезаписываться при следующем запуске. Перед обновлением сохраните нужные изменения в Git. ## Диагностика -На странице пространства нажмите «Подробнее» и найдите последнюю операцию с ошибкой. В разделе «AI» откройте карточку пространства. Используйте подходящую вкладку: +На странице пространства нажмите «Подробнее» и найдите последнюю операцию с ошибкой. Используйте подходящую вкладку: | Вкладка | Что проверить | | --- | --- | | «Операции» | Вывод OpenTofu при создании, запуске, обновлении или удалении | | «Диагностика» | Состояние StatefulSet, пода, контейнеров и постоянных томов, события Kubernetes, текущие и предыдущие логи контейнеров | -| «Задания» | Статус задания, вызовы инструментов и ошибки агента | + +Ошибки выполнения задания смотрите в чате агента. Типовые причины и действия: | Симптом | Действие | | --- | --- | | Не удаётся клонировать репозиторий | Проверьте URL и токен Git той учётной записи, которую использует шаблон | -| Под не скачивает образ | Попросите администратора проверить `image_pull_secrets` шаблона и Secrets в целевом неймспейсе | -| Постоянный том не готов | Проверьте с администратором класс хранения и доступный объём | -| Ошибка контейнера `bootstrap` | Прочитайте его лог; проверьте файлы и скрипты шаблона | -| IDE не открывается при работающем поде | Проверьте с администратором DNS, TLS и Ingress отдельного домена IDE | +| Под не скачивает образ | Передайте администратору сообщение об ошибке из диагностики | +| Постоянный том не готов | Передайте администратору сообщение об ошибке подключения хранилища | +| Ошибка контейнера `bootstrap` | Прочитайте его лог. Проверьте указанный репозиторий и учётные данные; ошибки шаблона передайте администратору | +| IDE не открывается при работающем поде | Повторно нажмите «Открыть IDE». Если ошибка сохраняется, передайте администратору адрес и сообщение браузера | | Достигнут лимит запущенных пространств | Остановите ненужное пространство или попросите администратора изменить лимит | -После устранения причины используйте «Повторить» у неуспешной операции. Для повторения требуются права на соответствующую операцию. +После устранения причины нажмите «Повторить операцию». ## Удаление