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

Filter by extension

Filter by extension

Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
71 changes: 71 additions & 0 deletions content/documentation/admin/ai-pdlc.ru.md
Original file line number Diff line number Diff line change
@@ -0,0 +1,71 @@
---
title: Настройка AI PDLC
weight: 73
description: Подключение приложений каталога к AI PDLC, настройка набора данных, согласующих и автоматического развёртывания выпусков.
---

AI PDLC связывает приложение каталога, рабочее пространство с агентом и процесс изменения. Пользователь ставит задачу, согласует спецификацию, проверяет MR в GitLab и отслеживает выпуск. Порядок работы описан в руководстве [«Приложения и изменения»](../user/home/applications/).

## Подготовка

Перед применением набора данных подготовьте:

1. Внешние сервисы GitLab и Kubernetes. Backend и worker должны иметь доступ к ним.
1. Неймспейс рабочих пространств, [домен IDE, DNS и TLS](workspaces/overview/).
1. Сервисную учётную запись DDP с токеном Kubernetes для запуска рабочих пространств. Этот токен используется в пространствах всех пользователей AI PDLC.
1. Ресурс приложений в [маппинге главной](home/mapping/) с ролью «Микросервис». Назначьте его параметрам роли «Репозиторий микросервиса» и «Ветка по умолчанию микросервиса» и заполните значения у приложений.
1. Ресурс с ролью главной «Окружение» для связи с окружением выпуска.
1. Роль пользователей с глобальными разрешениями `read:entities`, `create:workspaces`, `use:ai-agents`, `use:workspace-templates` и `create:pdlc-changes`. Назначьте роль участникам.

У каждого пользователя должны быть собственные токен GitLab и AI-провайдер в профиле. Личный токен Kubernetes пользователю AI PDLC не требуется.

## Применение набора

В разделе «Администрирование» → «Наборы данных» найдите «AI PDLC», нажмите «Применить» и заполните параметры:

| Параметр | Что указать |
| --- | --- |
| «Подключение GitLab» | Внешний сервис с репозиториями приложений |
| «Подключение Kubernetes» | Внешний сервис кластера рабочих пространств |
| «Namespace рабочих пространств» | Подготовленный неймспейс |
| «Домен IDE» | Домен с DNS и TLS для поддоменов рабочих пространств |
| «Учётная запись Kubernetes» | Сервисная учётная запись с токеном Kubernetes |
| «Роль пользователей PDLC» | Роль с перечисленными выше глобальными разрешениями |
| «Ресурс приложений» | Ресурс с настроенной ролью репозитория в маппинге главной |
| «Рабочих пространств на пользователя» | Лимит одновременно запущенных пространств одного пользователя |
| «Рабочих пространств всего» | Общий лимит запущенных пространств |
| «Срок работы рабочего пространства, часы» | Срок от 1 до 720 часов |

Набор проверяет разрешения выбранной роли, но не выдаёт их. При ошибке добавьте недостающие разрешения и повторите применение.

Набор создаёт шаблон рабочего пространства «AI PDLC», навыки `pdlc-spec` и `pdlc-implement`, процесс «AI PDLC: изменение приложения» с действиями и включает возможность «AI PDLC» на выбранном ресурсе.

## Настройка приложения

В карточке сущности приложения заполните репозиторий и ветку по умолчанию. Включённая возможность AI PDLC добавляет параметр «Согласующие спецификаций» и связь «Окружение выпуска».

Укажите пользователей в «Согласующие спецификаций», если спецификацию должен проверять кто-то кроме автора. При пустом списке согласует автор изменения; при нескольких пользователях достаточно ответа одного.

В секции связей выберите одно «Окружение выпуска». Несколько окружений дают неоднозначный выбор и не запускают автоматическое развёртывание.

Для развёртывания настройте слот «Развернуть микросервис на окружение» в маппинге главной: процесс шаблона приложения либо единственный процесс для приложения без шаблона. DDP передаёт этому процессу приложение и выбранное окружение. Успешное завершение процесса переводит выпуск в «Развёрнут».

Блок «Готовность к AI PDLC» на странице приложения помогает проверить настройки. Приложения без репозитория не появляются в списке.

## Создание приложений из шаблонов

Для кнопки «Новое приложение» дополнительно настройте [реестр шаблонов](templates/registry/) и процесс слота «Создать микросервис» для каждого используемого шаблона. Процесс должен зарегистрировать созданную сущность в ресурсе приложений.

Пользователям требуются `read:template-packs` и `control:processes` глобально или для ресурса систем. Набор AI PDLC эти разрешения не проверяет. Процесс развёртывания назначьте отдельно: без него создание приложения работает, но выпуски не развёртываются.

Выбранное при создании окружение DDP записывает связью после регистрации приложения. Если у ресурса нет нужной связи, пользователь получает сообщение и может задать её в карточке приложения.

## Доступ

Приложения, их выпуски и показатели доступны пользователям, которые могут читать соответствующую сущность. Для изменений действуют отдельные [разрешения AI PDLC](security/rbac/#изменения-ai-pdlc). Адресат решения получает доступ к изменению и спецификации, но не к рабочему пространству автора.

## Повторное применение и удаление

Повторное применение заменяет лимиты рабочих пространств и срок работы значениями из формы, включая ранее изменённые вручную. При выборе другого ресурса процесс изменения переносится на него, а возможность AI PDLC на прежнем ресурсе остаётся включённой, пока её не отключат в форме ресурса.

Удаление набора архивирует шаблон и навыки, удаляет процесс изменения с действиями и выключает возможность AI PDLC на ресурсах. Параметр согласующих, связь окружения с их значениями, выпуски, рабочие пространства, лимиты и срок работы сохраняются. Удаляйте ненужные рабочие пространства [отдельно](../user/workspaces/#удаление).
18 changes: 11 additions & 7 deletions content/documentation/admin/datasets.ru.md
Original file line number Diff line number Diff line change
Expand Up @@ -58,12 +58,16 @@ weight: 74
### Первоначальная настройка

Кнопка «Первоначальная настройка» открывает мастер, который применяет наборы данных «Каноничной архитектуры» для главной одним запуском: модель каталога, правила маппинга, подключения к Kubernetes, Vault и GitLab, источники данных, процессы и виджеты.
Мастер и наборы данных, которые он применяет, описаны в разделе [«Первоначальная настройка»](../home/setup/).
Мастер и наборы данных, которые он применяет, описаны в разделе [«Первоначальная настройка»](home/setup/).

Переключатель «Показывать баннер первоначальной настройки» возвращает на главную баннер «Платформа готова к настройке», скрытый кнопкой «Скрыть».

## Доступные наборы данных

### AI PDLC

Набор «AI PDLC» подготавливает рабочее пространство приложения с навыками спецификации и реализации, процесс изменения, согласующих и связь с окружением выпуска. Требования, параметры и поведение повторного применения описаны в руководстве [«Настройка AI PDLC»](ai-pdlc/).

### GitLab

Набор данных предназначен для подключения к API GitLab.
Expand All @@ -82,7 +86,7 @@ weight: 74

После применения заполните в профиле пользователя учётные данные «GitLab токен» и «GitLab username».

Группы и виджеты GitLab для главной создают наборы данных «GitLab: группы» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](../home/setup/#наборы-данных-мастера).
Группы и виджеты GitLab для главной создают наборы данных «GitLab: группы» и «GitLab: виджеты». Они описаны в разделе [«Первоначальная настройка»](home/setup/#наборы-данных-мастера).

### Kubernetes

Expand Down Expand Up @@ -112,7 +116,7 @@ weight: 74

Настройка:

Набор данных настраивает подключение к API Vault через внешний сервис с авторизацией по заголовку `X-Vault-Token`. Подробнее о формате авторизации — в разделе [«Внешние сервисы»](../external-services/#vault).
Набор данных настраивает подключение к API Vault через внешний сервис с авторизацией по заголовку `X-Vault-Token`. Подробнее о формате авторизации — в разделе [«Внешние сервисы»](external-services/#vault).

{{< alert level="info" >}}
После применения укажите в профиле суперадминистратора токен Vault в учётных данных «Vault токен».
Expand All @@ -132,7 +136,7 @@ weight: 74
1. Заполните учётные данные «Vault токен».
1. Подключите внешний сервис «Vault» к действиям, виджетам или источникам данных, которые обращаются к API Vault.

После этого запросы через внешний сервис будут использовать токен из учётных данных пользователя. Например, внешний сервис можно подключить к виджету [«Секреты Vault»](../widgets/generic/vault/) для просмотра секретов в KV v2.
После этого запросы через внешний сервис будут использовать токен из учётных данных пользователя. Например, внешний сервис можно подключить к виджету [«Секреты Vault»](widgets/generic/vault/) для просмотра секретов в KV v2.

### Deckhouse managed PostgreSQL

Expand All @@ -142,7 +146,7 @@ weight: 74

Настройка:

Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold).
Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold).

{{< alert level="info" >}}
Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных».
Expand All @@ -169,7 +173,7 @@ weight: 74

Настройка:

Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold).
Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold).

{{< alert level="info" >}}
Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных».
Expand All @@ -196,7 +200,7 @@ weight: 74

Настройка:

Перед применением настройте внешние сервисы [Kubernetes](../external-services/#kubernetes) и [Vault](../external-services/#vault) (или Stronghold).
Перед применением настройте внешние сервисы [Kubernetes](external-services/#kubernetes) и [Vault](external-services/#vault) (или Stronghold).

{{< alert level="info" >}}
Подробное описание компонентов набора данных доступно по кнопке «Описание» на карточке в разделе «Наборы данных».
Expand Down
Original file line number Diff line number Diff line change
Expand Up @@ -26,7 +26,6 @@ description: Настройка правил маппинга главной DDP
| Роль | Объект каталога |
| --- | --- |
| `system` | Ресурс «Продукты» |
| `system_domain` | Параметр `domain` ресурса «Продукты» |
| `system_lifecycle` | Параметр `status` ресурса «Продукты» |
| `microservice` | Ресурс «Сервисы» |
| `microservice_language` | Параметр `lang` ресурса «Сервисы» |
Expand Down
Loading
Loading