Подключить проект
Укажите, с каким кодом работать. Затем настройте окружение проекта и выберите процесс выполнения задач — самостоятельно или с помощью агента.
Быстрая настройка с агентом
Создайте чат с рабочей папкой вашего проекта и отправьте промпт ниже. Агент изучит репозитории, предложит настройки и задаст вопросы о том, чего нельзя определить по коду. Пути и команды вручную заполнять в этом руководстве не нужно.
Рекомендации по проверкам и приёмке собраны в отдельном разделе.
Помоги подключить этот проект к конвейерам GrigDesk.
Изучи репозитории и инструкции текущей установленной версии GrigDesk: подключение нового проекта, контракт профиля и штатный образец pipeline-sample. Определи фактические каталоги профилей и опубликованных маршрутов этой установки.
Прочитай рекомендации для профилей и маршрутов: /ru/docs/projects/recommendations/. Учти их при настройке проверок окружения, инструкций ревью и аудита, доказательств приёмки и возвратов. В итоговом отчёте укажи, как они применены к этому проекту и что ещё не проверено.
По коду выясни стек, рабочие репозитории, команды сборки и профильных тестов, правила продукта и способ проверить результат. Спроси только недостающие сведения. Предложи режим окружения, исполнителей и модели, точки приёмки и способ сдачи.
Подготовь локальный профиль на основе штатного образца, если он подходит. Свяжи его с репозиториями и настрой нужные маршруты. Существующие настройки сохрани. Проверь конфигурацию и маршруты до публикации, затем проверь готовность хоста без отправки заданий модели. Пробный запуск реальной задачи согласуй отдельно.
В конце покажи, что настроено, какие проверки прошли и что требуется от меня для запуска первой задачи. Секреты и ключи оставь вне репозитория проекта.Ниже — за что отвечает каждая часть настройки. Поля и файлы разобраны отдельно в справочнике профиля.
Проект — где находится ваш код
Проект объединяет название и рабочие репозитории. Он помогает выбирать код в чатах, файловом редакторе и задачах. Один проект может включать, например, backend и frontend в разных репозиториях.
В разделе «Проекты» создайте запись, добавьте существующие каталоги на машине сервера и выберите основной репозиторий. Регистрация сохраняет пути; исходные файлы остаются на своих местах.
Для чата с кодом уже можно использовать проект. Для конвейеров потребуется профиль.
Подробнее о проектах и репозиториях
Профиль — как работать с проектом
Профиль объясняет GrigDesk, как подготовить рабочую копию, выполнить проверки, открыть стенд и передать работу исполнителям. Например, в нём задаются команды тестов backend и сборки frontend.
Профиль также определяет доступные маршруты и правила их выбора. Он может использовать отдельное окружение задачи (isolated) или существующую рабочую копию и готовый стенд (shared).
Для командных этапов профиль объявляет разрешённые команды редактору. Настройка нового проекта через агента включает эту связку; готовый маршрут сам по себе не добавляет команды вашего стека.
Настроить профиль: файлы, окружение, исполнители и команды
Маршрут — как задача придёт к результату
Маршрут задаёт последовательность работы: например, планирование, реализация, проверка и приёмка человеком. Для ошибки и новой функции можно выбрать разные маршруты одного профиля.
В профиле могут лежать исходники маршрутов и инструкции. Опубликованные версии хранятся в отдельном каталоге; запуск использует выбранную закреплённую версию. Поэтому профиль и маршрут настраиваются связанно, но отвечают за разные вещи.
Создать маршрут · Настроить этапы и инструкции
Как понять, что всё готово
- В проекте указаны доступные репозитории на выбранной машине.
- Профиль проверен: рабочее окружение, исполнитель и проектные команды готовы.
- Нужный маршрут опубликован и доступен для выбора.
Проверки конфигурации и окружения описаны в справочнике профиля. После них возьмите небольшую задачу с понятным результатом и пройдите первый запуск.