# Как использовать настройки «Custom Branch» в окружении dbt?

В окружениях dbt можно изменить настройки git, чтобы использовать в репозиториях проектов dbt другую ветку вместо ветки по умолчанию. После такого изменения dbt запускается на пользовательской ветке. Если для окружения задана пользовательская ветка, dbt выполняет модели, используя эту ветку. Влияние этой настройки немного различается для окружений разработки и развертывания.

Чтобы указать пользовательскую ветку:

1. Отредактируйте существующую среду или создайте новую
2. Выберите **Запускать только на пользовательской ветке** в разделе Общие настройки
3. Укажите **имя ветки или тег**

## Разработка

В среде разработки основная ветка (обычно с именем `main`) защищена в подключённых репозиториях. Вы можете напрямую редактировать, форматировать файлы или проверять их линтером, а также выполнять команды dbt в защищённой ветке git по умолчанию. Поскольку Studio IDE не позволяет создавать коммиты в защищённой ветке, вы можете сохранить эти изменения коммитом в новой ветке, когда будете готовы.

Указание **пользовательской ветки (Custom branch)** переопределяет поведение по умолчанию. Эта ветка становится защищённой, и вы можете создавать на её основе новые ветки для разработки. Вы можете напрямую редактировать, форматировать файлы или проверять их линтером, а также выполнять команды dbt в пользовательской ветке, но не можете создавать в ней коммиты. dbt предлагает сохранить эти изменения коммитом в новой ветке.

Только одна ветка может быть защищенной. Если вы указываете пользовательскую ветку, основная ветка больше не защищена. Если вы хотите защитить основную ветку и предотвратить любые коммиты в нее, вам нужно настроить правила защиты веток в настройках вашего git-провайдера. Это гарантирует, что ваша основная ветка останется защищенной и в нее не будут вноситься новые коммиты.

Например, если вы хотите использовать ветку `develop` подключенного репозитория:

1. Перейдите в нужную среду и нажмите **Settings** > **Edit**, чтобы отредактировать среду.
2. В разделе **General settings** выберите **Only run on a custom branch**.
3. Введите **develop** в качестве имени вашей пользовательской ветки.
4. Нажмите **Save**.

[![Настройка пользовательской базовой ветки репозитория](/img/docs/dbt-platform/platform-configuring-dbt-platform/dev-environment-custom-branch.png?v=2 "Настройка пользовательской базовой ветки репозитория")](#)Настройка пользовательской базовой ветки репозитория

## Развертывание

При запуске заданий в среде развертывания dbt клонирует ваш проект из подключенного репозитория перед выполнением ваших моделей. По умолчанию dbt использует ветку по умолчанию вашего репозитория (обычно это ветка `main`). Чтобы указать другую версию вашего проекта для выполнения dbt во время выполнения заданий в конкретной среде, вы можете отредактировать настройку Custom Branch, как показано в предыдущих шагах.
