Создание папок Git и управление ими

На этой странице описывается, как создавать папки Git в Azure Databricks и выполнять общие операции с Git, включая клонирование, создание ветки, фиксацию и отправку.

В этом руководстве рассматриваются следующие операции Git:

Клонирование репозитория

При клонировании удаленного репозитория Databricks создает папку Git в рабочей области, которая содержит содержимое репозитория и отслеживает изменения. Вы можете создавать папки Git с помощью пользовательского интерфейса Azure Databricks или веб-терминала.

Клонирование из пользовательского интерфейса

1. На боковой панели выберите "Рабочая область " и перейдите к папке, в которой нужно создать клон репозитория Git.

2. Щелкните "Создать>папку Git".

3. В диалоговом окне "Создание папки Git" укажите следующие сведения:

   Поле	Description
   URL-адрес репозитория Git	URL-адрес репозитория Git, который требуется клонировать, в формате https://example.com/organization/project.git.
   Поставщик Git	Поставщик Git для репозитория, который требуется клонировать.
   Имя папки Git	Имя папки в рабочей области, содержащей содержимое клонированного репозитория.
   Разреженный режим выборки	Следует ли использовать разреженную выборку, которая клонирует только часть каталогов репозитория с использованием схемы в виде конуса. Это полезно, если репозиторий превышает ограничения размера.

4. Щелкните "Создать папку Git". Содержимое удаленного репозитория клонируется в рабочую область, и вы можете начать работу с поддерживаемыми операциями Git. Когда рабочая область соответствует требованиям, папка Git автоматически создается с доступом к Git CLI. См. статью "Когда папка Git получает доступ к Git CLI?".

Клонирование из веб-терминала

Вы также можете создавать папки Git с доступом CLI непосредственно из веб-терминала:

1. Доступ к веб-терминалу. См. статью «Запуск команд оболочки в веб-терминале Azure Databricks».

2. Перейдите к родительскому каталогу в /Workspace:

   cd /Workspace/Users/<your-email>/<project>
   

3. Клонируйте репозиторий:

   git clone <remote-url>
   

   Команда git clone использует учетные данные Git, настроенные в рабочей области. См. статью "Подключение поставщика Git к Databricks".

4. Обновите браузер, чтобы увидеть новую папку в браузере файлов рабочей области.

Использование команд интерфейса командной строки Git

Папки Git с доступом к Git CLI позволяют выполнять стандартные команды Git на бессерверных вычислениях, из записной книжки, веб-терминала или Genie Code. Вы можете:

• Выполните любую команду Git, включая git stash, git push --forceи git rebase -i.
• Интеграция линтинга и сканирования кода с хуками предварительной фиксации.
• Работа с репозиториями, превышающими 2 ГБ памяти и 4 ГБ дисков стандартных папок Git.
• Используйте подмодулы Git и хранилище больших файлов (LFS).
• Подготовьте несколько коммитов локально перед отправкой в удаленный репозиторий.

Требования к вычислительным ресурсам Git CLI

Необходимые вычисления зависят от того, как вы используете папку Git с поддержкой CLI:

Сведения о включении бессерверных вычислений см. в разделе "Подключение к бессерверным вычислениям".

Если поставщик Git требует подключения к частной сети, см. статью "Настройка сетевого подключения".

Когда папка Git получает доступ к Git CLI?

Когда вы создаёте папку Git из пользовательского интерфейса, Azure Databricks автоматически включает доступ к Git CLI, если ваша рабочая область соответствует требованиям. Если ваша рабочая область не поддерживает эту возможность, Azure Databricks вместо этого создает стандартную папку Git, и вы по-прежнему можете выполнять операции Git в интерфейсе папок Git.

Папка Git, созданная из пользовательского интерфейса, получает доступ к интерфейсу командной строки Git, если все из следующих значений имеют значение true:

• Предварительная версия Git CLI включена в вашей рабочей области. Администраторы рабочей области управляют этим с помощью страницы "Предварительные версии ". См. статью "Управление предварительными версиями Azure Databricks".
• Бессерверные вычисления доступны в рабочей области. См. раздел "Подключение к бессерверным вычислениям".
• Azure Databricks может подключаться к вашему поставщику Git с помощью бессерверных вычислительных ресурсов. Azure Databricks проверяет подключение перед клонированием репозитория. Если поставщик Git требует подключения к частной сети, см. статью "Настройка сетевого подключения".
• Во время общедоступной предварительной версии репозитории ограничены 10 000 файлами. Репозитории, превышающие это ограничение, вместо этого клонируются как стандартные папки Git.

Репозитории Git, которые вы клонируете из веб-терминала, всегда доступны через Git CLI.

Создание папки Git с доступом к Git CLI

Чтобы создать папку Git с доступом к CLI, выполните приведенные действия.

• Если вы используете UI, Azure Databricks автоматически создает папку Git с доступом к Git CLI, если ваша рабочая область поддерживает эту возможность. См. статью "Когда папка Git получает доступ к Git CLI?". Если ваша рабочая область не поддерживается, Azure Databricks вместо этого создает стандартную папку Git.
• Если вы используете веб-терминал, любой репозиторий, клонированный, автоматически имеет доступ к интерфейсу командной строки Git.

После создания папки Git с доступом к CLI выполните любую стандартную команду Git из веб-терминала. Чтобы открыть веб-терминал, см. статью "Запуск веб-терминала".

cd /Workspace/Users/<your-email>/<project>/my-repo

# Interactive rebase
git rebase -i main

# Stash uncommitted changes
git stash

# Work with submodules
git submodule update --init --recursive

Ограничения интерфейса командной строки Git

Папки Git с доступом CLI имеют следующие ограничения:

• Списки разрешённых URL-адресов Git распространяются на операции Git, которые вы выполняете в пользовательском интерфейсе Azure Databricks, но не применяются к командам Git, которые вы запускаете напрямую через Git CLI.
• Папки Git с доступом к Git CLI не возвращаются методом List Repos API.

Устранение неполадок с операциями интерфейса командной строки Git

• Операции Git отключены в пользовательском интерфейсе рабочей области: бессерверные вычисления не включены в рабочей области. Вы по-прежнему можете запускать команды Git из веб-терминала. Сведения о включении бессерверных вычислений см. в разделе "Подключение к бессерверным вычислениям".
• Терминал предложит выбрать учетные данные: операции интерфейса командной строки Git используют сохраненные учетные данные рабочей области Git автоматически. Azure Databricks определяет поставщика Git по удалённому URL-адресу и использует учётные данные по умолчанию для этого поставщика. Если Azure Databricks не может определить, какие учетные данные использовать, вам будет предложено выбрать их. Чтобы избежать запроса, установите для переменной среды DB_GIT_CREDENTIAL_NAME имя учетных данных, которые вы хотите использовать. Azure Databricks запоминает учетные данные, используемые для репозитория, и повторно использует его.
• Операции Git завершаются ошибкой разрешений: Убедитесь, что у вас есть CAN MANAGE права на родительскую папку и ваши учетные данные рабочей области Git действительны. См. статью "Подключение поставщика Git к Databricks".

Доступ к диалоговому окне Git

Откройте диалоговое окно Git из записной книжки или из обозревателя папок Git Azure Databricks.

• В записной книжке нажмите кнопку, расположенную рядом с именем записной книжки, которая определяет текущую ветвь Git.

  

• В браузере папок Git Azure Databricks щелкните Git рядом с именем репозитория.

Откроется полноэкранное диалоговое окно, в котором можно выполнять операции Git.

1. Текущая рабочая ветвь. Вы можете выбрать другие ветви здесь. Если у других пользователей есть доступ к этому репозиторию Git, смена ветки также изменит ветку для них, если они работают в той же рабочей области. Ознакомьтесь с рекомендуемой рекомендацией, чтобы избежать этой проблемы.
2. Создайте новую ветвь.
3. Файлы и вложенные папки, добавленные в вашу текущую ветку.
4. Показать историю текущей ветки.
5. Извлечение содержимого из удаленного репозитория Git.
6. Добавьте сообщение фиксации и необязательное расширенное описание изменений.
7. Коммитьте изменения в рабочую ветвь и отправьте обновленную ветвь в удаленный репозиторий Git.

Щелкните , чтобы выбрать из дополнительных операций ветви Git, таких как жесткий сброс, слияние или перебазирование.

создать новую ветвь.

Чтобы создать новую ветвь, выполните приведенные действия.

1. Откройте диалоговое окно Git.
2. Щелкните Создать ветвь.
3. Введите имя новой ветви и выберите базовую ветвь.
4. Нажмите кнопку "Создать".

Переход на другую ветвь

Чтобы переключиться на другую ветку, используйте выпадающий список веток в диалоговом окне Git:

Незафиксированные изменения в текущей ветви переносятся и отображаются как незафиксированные изменения в новой ветви, если незафиксированные изменения не конфликтуют с кодом в новой ветви. Отмените изменения до или после смены ветви, если вы не планируете переносить незафиксированные изменения.

Локальная версия ветви может оставаться в связанной папке Git до 30 дней после удаления удаленной ветви. Чтобы полностью удалить локальную ветвь в папке Git, удалите репозиторий.

Фиксация и отправка изменений

При добавлении новых блокнотов или файлов, или внесении изменений в существующие блокноты или файлы, интерфейс папки Git выделяет изменения.

Добавьте необходимое сообщение фиксации для изменений и нажмите кнопку "Зафиксировать и отправить" , чтобы отправить изменения в удаленный репозиторий Git.

Если у вас нет разрешения на внесение изменений в ветвь по умолчанию, создайте новую ветвь и используйте интерфейс вашего поставщика Git, чтобы создать pull-запрос и произвести слияние с ветвью по умолчанию.

Автор в папке Git при работе в роли

При использовании RBACвы принимаете роль для доступа к данным, охватывающим эту роль. Чтобы создать код, который считывает эти данные, необходимо принять роль, чтобы доступ к данным вступил в силу, а затем зафиксировать изменения. Вы можете выполнить коммит либо под своей учетной записью, либо от имени роли. Выбор определяет, как ваш провайдер Git будет связывать коммиты с автором, с учётом того, сколько настройки требует рабочий процесс. Оба зависят от учетных данных Git для роли.

Зафиксировать от имени пользователя

В этом случае вы выполняете коммиты, используя свои личные учётные данные Git, поэтому ваш Git-провайдер связывает коммиты с вами. Вы принимаете эту роль только для того, чтобы вносить изменения в данные, к которым у этой роли есть доступ, а затем снова переключаетесь на свою пользовательскую учётную запись, чтобы зафиксировать изменения. Поскольку вы создаёте коммиты, выступая в этой роли, а выполняете коммит от имени своей пользовательской учётной записи, папка Git должна быть доступна из-под обеих учётных записей. Настройте это одним из двух способов, которые различаются тем, кто владеет папкой и в каком направлении вы предоставляете к ней доступ.

Вариант 1. Клонирование в домашней папке и предоставление общего доступа к ней с ролью

1. Под своей учетной записью пользователя (не переключаясь на роль) клонируйте репозиторий в папку Git в вашем домашнем каталоге (/Workspace/Users/<your-username>/...). См. раздел "Клонирование репозитория". Клон использует свои личные учетные данные Git, а вы владеете папкой. Роль не требует собственных учетных данных Git для этого параметра.
2. Предоставьте роли доступ к папке (Может запускать или Может редактировать, если роли нужно редактировать файлы), чтобы вы могли работать в ней, действуя от имени этой роли.
3. Предположим роль, а затем внесите изменения в папку. Доступ этой роли к данным активен.
4. Снова войдите как пользователь, затем выполните коммит и отправьте изменения. Коммит использует ваши личные git_username и git_email.

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

Вариант 2: Клонировать в домашнюю папку роли и предоставить доступ вашей учетной записи пользователя

1. Примите роль и клонируйте репозиторий в каталог Git в домашнем каталоге роли. Для клонирования используются учетные данные Git, связанные с ролью, которые должны иметь как минимум права на чтение.
2. Действуя в этой роли, предоставьте учетной записи пользователя доступ к папке (Может редактировать).
3. Внесите изменения при выполнении роли. Доступ этой роли к данным активен.
4. Вернитесь к своей учетной записи. Поскольку вы предоставили своему пользователю доступ, вы можете получить доступ к папке, поэтому зафиксируйте изменения и отправьте их, используя свои личные учётные данные. Коммит использует ваши личные git_username и git_email.

Так как роль открывает вашей пользовательской учётной записи доступ к папке, эта возможность не работает, если роль находится в списке блокировки элементов управления общим доступом к ресурсам рабочей области. Используйте вариант 1 для этих ролей.

Фиксация в качестве роли

В этом подходе вы клонируете, создаёте и коммитите всё, выступая в этой роли. Это самый простой сценарий работы: вам не нужно ни предоставлять общий доступ к папке, ни переключать учётные записи, чтобы выполнить коммит. Для этого необходимо, чтобы учетные данные Git для этой роли имели права на запись, поскольку интерфейс рабочей области выполняет коммит и push за одно действие.

1. Возьмите на себя роль.
2. Клонируйте репозиторий в папку Git. Поскольку вы действуете от имени этой роли, при клонировании используются учётные данные Git этой роли.
3. Внесите изменения, а затем зафиксируйте и отправьте их. Коммит использует git_username и git_email роли.

Взвесите эти последствия перед выбором этого подхода:

• Атрибуция задаётся на уровне роли. Коммиты в вашем Git-провайдере показывают Git-идентификатор роли, а не идентификатор конкретного автора. В журналах аудита Azure Databricks фиксируются и identity_metadata.run_as (роль), и identity_metadata.run_by (вы) для коммитов, выполненных через пользовательский интерфейс рабочей области. Это не относится к необработанным фиксациям Git, выполняемым из интерфейса командной строки Git в веб-терминале, который Azure Databricks не атрибутирует отдельному пользователю.
• Учетные данные Git для этой роли являются общими и имеют доступ на запись. Все, кто берёт на себя эту роль, используют одни и те же учётные данные для выполнения push, поэтому скомпрометированный или неправомерно использованный токен позволяет выполнять push, удалять ветки и создавать коммиты от имени этой роли. Из-за этого Azure Databricks рекомендует групповые учетные данные Git с доступом только для чтения и подход коммита от имени вашего пользователя. Используйте учетные данные с правом записи только если готовы пойти на эти компромиссы. См. разрешения токена. Ограничьте область действия учетных данных только теми репозиториями, которые нужны этой роли.

Изменения в запросе

Чтобы извлечь изменения из удаленного репозитория Git, нажмите кнопку Pull в диалоговом окне операций Git. Записные книжки и другие файлы автоматически обновляются до последней версии в удаленном репозитории Git. Если изменения, полученные из удаленного репозитория, конфликтуют с локальными изменениями в Azure Databricks, устраните конфликты слияния.

Совместная работа в папках Git

Папки Azure Databricks Git ведут себя как встроенные клиенты Git в вашей рабочей области, позволяя сотрудничать с использованием системы контроля версий на базе Git. Для эффективной совместной работы команды:

• Каждый участник группы имеет собственную папку Git, сопоставленную с удаленным репозиторием Git, где он работает в своей собственной ветви разработки.
• Только один пользователь выполняет операции Git в каждой папке Git. Несколько пользователей, выполняющих операции Git в одной папке, могут привести к проблемам управления ветками, например когда один пользователь непреднамеренно переключает ветку для всех.

Чтобы предоставить общий доступ к конфигурации папки Git совместно с коллегой:

1. Нажмите Поделиться.
2. Щелкните "Копировать ссылку", чтобы создать папку Git.
3. Отправьте URL-адрес вашему сотруднику.
4. Когда ваш сотрудник открывает URL-адрес, он увидит диалоговое окно, предварительно заполненное конфигурацией папки Git.
5. Они щелкают Create Git folder для клонирования репозитория в текущую папку в пределах своей рабочей области.

Слияние ветвей

Функция слияния в папках Azure Databricks Git использует git merge, чтобы объединить историю коммитов из одной ветви в другую. Для начинающих Git Databricks рекомендует использовать слияние вместо ребейза, так как это не требует принудительной отправки и не перезаписывает историю коммитов.

Чтобы объединить одну ветвь в другую, щелкните и выберите "Объединить".

• Если возникает конфликт слияния, устраните его в интерфейсе Git.
• Если конфликт отсутствует, слияние отправляется в удаленный репозиторий Git с помощью git push.

Разрешение конфликтов слияния

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

Чтобы устранить конфликт слияния, используйте интерфейс пользователя папок Git, который отображает конфликтующие файлы и варианты разрешения.

• Вручную измените файл, чтобы выбрать, какие изменения следует сохранить.
• Выберите "Сохранить все текущие изменения" или "Принять все входящие изменения ", чтобы полностью принять одну версию.
• Отмените операцию и отмените конфликтующие изменения, чтобы повторить попытку.

Разрешение конфликтов вручную

Разрешение конфликтов вручную позволяет определить, какие конфликтующие строки следует принимать. Измените содержимое файла непосредственно, чтобы устранить конфликты.

Чтобы устранить конфликт, выберите строки кода, которые необходимо сохранить и удалить все остальное, включая маркеры конфликтов слияния Git. По завершении нажмите кнопку "Пометить как разрешено".

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

Перебазировать ветвь

Функция перебазирования в папках Git Azure Databricks используется git rebase для интеграции изменений из одной ветви в другую, переигрывая ваши коммиты на целевой ветви, создавая линейную историю.

Чтобы перебазировать ветвь на другую ветвь, щелкните значок меню Kebab и выберите "Перебазировать", а затем выберите целевую ветвь.

• После повторной базы папки Git запускаются git commit и git push --force обновляют удаленный репозиторий.
• Ребейз переписывает историю коммитов, что может привести к проблемам с версионированием для участников, работающих в том же репозитории.

Сбросить ветку

Выполните сброс Git из пользовательского интерфейса папок Git. Эта операция эквивалентна сочетанию git reset --hard с git push --force.

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

Сброс в удаленную ветвь

В git reset этом сценарии:

• Вы переключаете выбранную ветвь (например, feature_a) на другую ветвь (например, main).
• Вы также сбрасываете ветвь вышестоящей (удаленной) feature_a на main.

Чтобы сбросить ветвь в удаленную ветвь:

1. В пользовательском интерфейсе папок Git из меню ветви выберите ветвь, которую вы хотите сбросить.

2. Выберите "Сброс" в

   

3. Выберите ветвь для сброса и нажмите кнопку "Выполнить сброс Git".

Настройка режима разреженной выборки

Разреженная проверка — это клиентская настройка, позволяющая клонировать и работать только с подмножеством каталогов удаленного репозитория в Azure Databricks. Это особенно полезно, если размер репозитория превышает поддерживаемые ограничения Azure Databricks.

Включите режим разреженной выборки при клонировании нового репозитория. Вы не можете отключить режим разреженной проверки после его включения.

1. В диалоговом окне "Создание папки Git " включите режим разреженного извлечения.

   

2. В поле "Шаблоны конуса" укажите нужные шаблоны контроля конуса, которые вам понадобятся. Разделение нескольких шаблонов по разрывам строк.

Как работают шаблоны конуса

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

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

Установка разреженного шаблона выбора parent/child/grandchild рекурсивно включает в себя все содержимое каталога grandchild. Файлы непосредственно в /parent, /parent/child и корневом каталоге также включены. См. структуру каталога на следующей схеме:

Настройка параметров разреженной выборки

После создания репозитория измените шаблон разреженной выборки из Settings>Advanced>Cone patterns.

Обратите внимание на следующее поведение:

• При удалении папки из шаблона «конусный паттерн» она удаляется из Azure Databricks, если отсутствуют незавершенные изменения.

• Добавление папки путем редактирования разреженного шаблона конуса добавляет его в Azure Databricks без необходимости дополнительного извлечения.

• Не удается изменить разреженные шаблоны извлечения, чтобы удалить папку при наличии незафиксированных изменений в этой папке.

  Например, если вы редактируете файл в папке и не фиксируете изменения, попробуйте изменить разреженный шаблон извлечения, чтобы исключить эту папку, шаблон принимается, но папка не удаляется. Необходимо вернуть шаблон, чтобы включить эту папку, зафиксировать изменения, а затем повторно применить новый шаблон.

Изменения с разреженной выборкой

Измените существующие файлы и зафиксируйте их и отправьте их из папки Git. При создании новых папок файлов включите их в шаблон конуса, указанный для этого репозитория.

Включение новой папки за пределами шаблона конуса приводит к ошибке во время операции фиксации и отправки. Чтобы исправить это, измените шаблон конуса так, чтобы включить новую папку, которую вы пытаетесь добавить и отправить.

Ограничения разреженного извлечения

• Разреженная загрузка не работает для репозиториев Azure DevOps размером более 4 ГБ.
• Вы не можете отключить разреженное извлечение для репозитория, который был создан с включенным разреженным извлечением.

Программное управление папками Git

Сведения об управлении папками Git с помощью API см. в справочнике по API Repos.

Удаление папки Git

Чтобы удалить папку Git из рабочей области, выполните следующие действия.

1. Щелкните правой кнопкой мыши папку Git и выберите "Переместить в корзину".
2. Нажмите кнопку "Подтвердить" и перейдите в корзину.

Дальнейшие шаги

• Настройте проверку подлинности для подключения Azure Databricks к поставщику Git. См. статью "Подключение поставщика Git к Databricks".
• Узнайте о ограничениях размера и других ограничениях для папок Git. См. раздел Azure Databricks ограничения папок Git и ссылки.
• Настройте параметры уровня рабочей области для интеграции с Git. См. статью "Настройка интеграции Git для папок Git".