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

Подготовка

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

  1. Внешние сервисы GitLab и Kubernetes. Backend и worker должны иметь доступ к ним.
  2. Неймспейс рабочих пространств, домен IDE, DNS и TLS.
  3. Сервисную учётную запись DDP с токеном Kubernetes для запуска рабочих пространств. Этот токен используется в пространствах всех пользователей AI PDLC.
  4. Ресурс приложений в маппинге главной с ролью «Микросервис». Назначьте его параметрам роли «Репозиторий микросервиса» и «Ветка по умолчанию микросервиса» и заполните значения у приложений.
  5. Ресурс с ролью главной «Окружение» для связи с окружением выпуска.
  6. Роль пользователей с глобальными разрешениями 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» на странице приложения помогает проверить настройки. Приложения без репозитория не появляются в списке.

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

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

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

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

Доступ

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

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

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

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