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