Databricks Git 폴더에서 Git 작업 실행

이 문서에서는 복제, 분기, 커밋 및 푸시를 포함하여 Git 폴더를 사용하여 Databricks 작업 영역에서 일반적인 Git 작업을 수행하는 방법을 설명합니다.

원격 Git 리포지토리에 연결된 리포지토리 복제

Databricks UI 또는 웹 터미널을 사용하여 Git 폴더를 만들 수 있습니다.

UI에서 복제

1. 사이드바에서 작업 영역을 선택한 다음 Git 리포지토리 복제를 만들 폴더로 찾습니다.

2. Git 폴더>를 클릭합니다.

   

3. Git 폴더 만들기 대화 상자에서 다음 정보를 제공합니다.

   분야	Description
   Git 리포지토리 URL	복제하려는 Git 리포지토리의 URL(형식) https://example.com/organization/project.git
   Git 공급자	복제하려는 리포지토리에 대한 Git 공급자입니다. 옵션에는 GitHub, GitHub Enterprise, GitLab 및 Azure DevOps(Azure Repos)가 포함됩니다.
   Git 폴더 이름	복제된 리포지토리의 내용을 포함할 작업 영역의 폴더 이름
   스파스 체크 아웃	리포지토리 디렉터리의 하위 집합만 복제되고 원뿔 패턴을 사용하여 지정된 스파스 체크 아웃을 사용할지 여부입니다. 리포지토리가 Databricks의 지원 한도인 보다 큰 경우, 이는 유용합니다.
   Git CLI 사용(베타)	Databricks 터미널에서 직접 표준 Git 명령을 실행할 수 있습니다. 이렇게 하면 커밋 전 후크, Git 하위 모듈 및 LFS(큰 파일 스토리지)와 같은 고급 작업에 액세스할 수 있습니다. Git CLI 명령 사용(베타)을 참조하세요.

4. Git 폴더 만들기를 클릭합니다. 원격 리포지토리 내용은 Databricks 리포지토리에 복제되며 작업 영역을 통해 지원되는 Git 작업을 사용하여 작업을 시작할 수 있습니다.

웹 터미널에서 클론하기

웹 터미널에서 직접 CLI 액세스 권한으로 Git 폴더를 만들 수도 있습니다.

1. 웹 터미널에 액세스합니다. Azure Databricks 웹 터미널에서 셸 명령 실행을 참조하세요.

2. /Workspace에서 부모 디렉터리로 이동하십시오.

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

   참고 항목

   Git CLI 액세스를 사용하여 Git 폴더를 /Repos 또는 기존 Git 폴더 내에서 생성할 수 없습니다.

3. 리포지토리 복제:

   git clone <remote-url>
   

   이 git clone 명령은 작업 영역에 구성된 Git 자격 증명을 사용합니다. Git 자격 증명 구성 을 참조하고 & 원격 리포지토리를 Azure Databricks에 연결하세요.

4. 작업 영역 파일 브라우저에서 새 폴더를 보려면 브라우저를 새로 고칩니다.

Git CLI 명령 사용(베타)

Git CLI 액세스 권한이 있는 Git 폴더를 사용하면 Databricks 터미널에서 직접 표준 Git 명령을 실행할 수 있습니다. 당신은 할 수 있어요:

• Git 명령어는 git stash, git pull --force, git rebase -i를 포함하여 모두 실행할 수 있습니다.
• 사전 커밋 후크와 Linting 및 코드 검사를 통합합니다.
• 표준 Git 폴더의 2GB 메모리 및 4GB 디스크 제한을 초과하는 리포지토리를 사용합니다.
• Git 하위 모듈 및 LFS(큰 파일 스토리지)를 사용합니다.
• 원격 리포지토리로 푸시하기 전에 여러 커밋을 로컬로 스테이징합니다.

Git CLI 액세스를 사용하려면 작업 영역에 환경 버전 4 이상으로 서버리스 컴퓨팅 을 사용하도록 설정해야 합니다.

Git CLI 액세스를 사용하여 Git 폴더 만들기

CLI 액세스 권한이 있는 Git 폴더를 만들려면 다음을 수행합니다.

• 웹 터미널을 사용하는 경우 복제하는 모든 리포지토리에 자동으로 Git CLI 액세스 권한이 있습니다.
• UI를 사용하는 경우 Git 폴더를 만들 때 Git CLI 미리 보기를 사용하도록 설정해야 합니다.

CLI 액세스 권한이 있는 Git 폴더를 만든 후 웹 터미널에서 표준 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 CLI 제한 사항

CLI 액세스 권한이 있는 Git 폴더에는 다음과 같은 제한 사항이 있습니다.

• 원격 URL 허용 목록을 사용하는 작업 영역은 Git CLI 기능을 사용할 수 없습니다.
• Git CLI 명령은 Notebook 출력 커밋을 차단하는 관리자 설정을 무시합니다.
• CLI 액세스 권한이 있는 Git 폴더에는 Repos API가 지원되지 않습니다.
• 기존 Git 폴더에는 Git CLI 액세스를 사용하도록 설정할 수 없습니다.

Git CLI 작업 문제 해결

• 터미널은 모든 작업에서 자격 증명을 묻는 메시지를 표시합니다. Git CLI 기능은 작업 영역에서 사용하도록 설정되지 않습니다. 미리 보기가 사용하도록 설정되어 있는지 확인하려면 작업 영역 관리자에게 문의하세요.
• CLI 액세스를 사용하도록 설정할 수 없음: 원격 URL 허용 목록이 있는 작업 영역은 Git CLI 기능을 사용할 수 없습니다. 작업 영역 관리자에게 문의하여 작업 영역의 네트워크 구성을 검토합니다.
• 권한 오류로 Git 작업이 실패합니다. 부모 폴더에 대한 권한이 있고 작업 영역 Git 자격 증명이 유효한지 확인 CAN MANAGE 합니다. Git 자격 증명 구성 을 참조하고 & 원격 리포지토리를 Azure Databricks에 연결하세요.

모범 사례: Git 폴더에서 공동 작업

Databricks Git 폴더는 작업 영역에 포함된 Git 클라이언트로 작동하므로 Git 기반 소스 제어 및 버전 관리를 통해 공동 작업할 수 있습니다. 효과적인 팀 공동 작업을 위해:

• 각 팀 구성원은 자체 개발 분기에서 작업하는 원격 Git 리포지토리에 매핑된 고유한 Git 폴더를 가지고 있습니다.
• 한 명의 사용자만 각 Git 폴더에서 Git 작업을 수행합니다. 동일한 폴더에서 Git 작업을 수행하는 여러 사용자가 한 명의 사용자가 의도치 않게 모든 사용자를 위해 분기를 전환하는 것과 같은 분기 관리 문제를 일으킬 수 있습니다.

공동 작업자와 Git 폴더 구성을 공유하려면 다음을 수행합니다.

1. 복사 링크를 클릭하여 Databricks 작업 영역 맨 위에 있는 배너에 Git 폴더를 만듭니 다.
2. 공동 작업자에게 URL을 보냅니다.
3. 공동 작업자가 URL을 열면 Git 폴더 구성으로 미리 채워진 Git 폴더 만들기 대화 상자가 표시됩니다.
4. Git 폴더 만들기를 클릭하여 현재 작업 폴더 아래에 있는 자신의 작업 영역에 리포지토리를 복제합니다.

다른 사용자로부터 Git 폴더를 복사하려면 다음을 수행합니다.

1. 공유 작업 영역에서 다른 사용자의 Git 폴더를 엽니다.
2. 맨 위에 있는 배너에서 Git 폴더 만들기 를 클릭합니다. Git 리포지토리 구성이 미리 채워져 있는 Git 폴더 만들기 대화 상자가 열립니다.
3. Git 폴더 만들기를 클릭하여 리포지토리를 사용자 고유의 작업 영역에 복제합니다.

Git 대화 상자에 액세스

Notebook 또는 Databricks Git 폴더 브라우저에서 Git 대화 상자에 액세스할 수 있습니다.

• Notebook에서 현재 Git 분기를 식별하는 Notebook의 이름 옆에 있는 단추를 클릭합니다.

  

• Databricks Git 폴더 브라우저에서 리포지토리 이름 오른쪽에 있는 단추를 클릭합니다. 리포지토리 이름을 마우스 오른쪽 단추로 클릭하고 메뉴에서 Git... 선택할 수도 있습니다.

  

Git 작업을 수행할 수 있는 전체 화면 대화 상자가 표시됩니다.

1. 현재 작업 분기입니다. 여기에서 다른 분기를 선택할 수 있습니다. 다른 사용자가 이 Git 폴더에 액세스할 수 있는 경우 분기를 변경하면 동일한 작업 영역을 공유하는 경우 분기도 변경됩니다. 이 문제를 방지하려면 권장 모범 사례를 참조하세요.
2. 새 분기를 만드는 단추입니다.
3. 현재 브랜치에 체크인된 파일 및 하위 폴더 목록입니다.
4. Git 공급자로 이동하고 현재 분기 기록을 표시하는 단추입니다.
5. 원격 Git 리포지토리에서 콘텐츠를 끌어오는 단추입니다.
6. 커밋 메시지와 변경 내용에 대한 선택적 확장 설명을 추가하는 텍스트 상자입니다.
7. 작업 분기에 작업을 커밋하고 업데이트된 분기를 원격 Git 리포지토리로 푸시하는 단추입니다.

을 클릭합니다. 오른쪽 위에 있는 아이콘을 클릭하여 하드 리셋, 병합, 리베이스와 같은 추가 Git 분기 작업을 선택할 수 있습니다.

작업 영역 Git 폴더에서 Git 작업을 수행하기 위한 홈입니다. 사용자 인터페이스에 표시되는 Git 작업으로 제한됩니다.

새 분기 만들기

Git 대화 상자에서 기존 분기를 기반으로 새 분기를 만들 수 있습니다.

다른 분기로 전환

Git 대화 상자에서 분기 드롭다운을 사용하여 다른 분기로 전환(체크 아웃)할 수 있습니다.

커밋되지 않은 변경 내용이 새 분기의 코드와 충돌하지 않는 경우 현재 분기의 커밋되지 않은 변경 내용이 새 분기에서 커밋되지 않은 변경 내용으로 표시됩니다. 커밋되지 않은 변경 내용을 수행하지 않으려는 경우 분기 전환 전후의 변경 내용을 취소합니다.

분기의 로컬 버전은 원격 분기가 삭제된 후 최대 30일 동안 연결된 Git 폴더에 있을 수 있습니다. Git 폴더에서 로컬 분기를 완전히 제거하려면 리포지토리를 삭제합니다.

원격 Git 리포지토리에 변경 내용 커밋 및 푸시

새 Notebook 또는 파일을 추가하거나 기존 Notebook 또는 파일을 변경한 경우 Git 폴더 UI에서 변경 내용을 강조 표시합니다.

변경에 필요한 커밋 메시지 추가하고 커밋 및 푸시를 클릭하여 이러한 변경 내용을 원격 Git 리포지토리에 푸시합니다.

기본 분기(예: main 분기)에 커밋할 수 있는 권한이 없는 경우 새 분기를 만들고 Git 공급자의 인터페이스를 사용하여 PR(끌어오기 요청)을 만들어 기본 분기에 병합합니다.

원격 Git 리포지토리에서 변경 내용 끌어오기

원격 Git 리포지토리에서 변경 내용을 가져오려면 Git 작업 대화 상자에서 끌어오기를 클릭합니다. Notebook 및 기타 파일은 원격 Git 리포지토리의 최신 버전으로 자동으로 업데이트됩니다. 원격 리포지토리에서 가져온 변경 내용이 Databricks의 로컬 변경 내용과 충돌하는 경우 병합 충돌 해결해야 합니다.

분기 병합

Git 작업 대화 상자의 오른쪽 위에 있는 에서 Git Kebab menu icon.병합 작업을 선택하여 액세스합니다.

Databricks Git 폴더의 병합 함수는 .를 사용하여 git merge한 분기를 다른 분기로 병합합니다. 병합 작업은 한 분기에서 다른 분기로 커밋 기록을 결합하는 방법입니다. 유일한 차이점은 이를 달성하기 위해 사용하는 전략입니다. Git 초보자의 경우 분기로 강제 푸시 필요가 없으므로 커밋 기록을 다시 작성하지 않으므로 병합(재베이스를 통해)을 사용하는 것이 좋습니다.

• 병합 충돌이 있는 경우 Git 폴더 UI에서 해결합니다.
• 충돌이 없으면 git push를 사용하여 병합은 원격 Git 리포지토리에 푸시됩니다.

Rebase 다른 분기의 분기

에서 Git Kebab menu icon.Rebase 작업에 액세스합니다. Git 작업 대화 상자의 오른쪽 위에 있는 kebab 메뉴입니다.

재배정은 분기의 커밋 기록을 변경합니다. 마찬가지로 git merge한 git rebase 분기의 변경 내용을 다른 분기로 통합합니다. 다시베이스는 다음을 수행합니다.

1. 현재 분기의 커밋을 임시 영역에 저장합니다.
2. 현재 분기를 선택한 분기로 다시 설정합니다.
3. 이전에 현재 분기에 저장된 각 개별 커밋을 다시 적용하여 두 분기의 변경 내용을 결합하는 선형 기록을 만듭니다.

일반적인 워크플로는 주 분기에서 기능 분기 다시 지정하는 것입니다.

다른 분기의 분기를 다시 지정하려면 다음을 수행합니다.

1. Git 폴더 UI의 브랜치 메뉴에서 리베이스할 브랜치를 선택합니다.

2. 다시베이스를 케밥 메뉴에서 선택합니다.

   

3. 다시 기반으로 할 분기를 선택합니다.

   다시베이스 작업은 여기에서 선택한 분기의 변경 내용을 현재 분기로 통합합니다.

Databricks Git 폴더는 원격 Git 리포지토리를 업데이트하기 위해 git commit 및 git push --force을 실행합니다.

병합 충돌 해결

병합 충돌은 2명 이상의 Git 사용자가 파일의 동일한 줄에 대한 변경 내용을 공통 분기로 병합하려고 시도하고 Git에서 적용할 "올바른" 변경 내용을 선택할 수 없는 경우에 발생합니다. 사용자가 다른 분기의 변경 내용을 커밋되지 않은 변경 내용이 있는 분기로 끌어오거나 병합하려고 할 때 병합 충돌이 발생할 수도 있습니다.

끌어오기, 다시 기반 또는 병합과 같은 작업으로 인해 병합 충돌이 발생하는 경우 Git 폴더 UI에는 충돌이 있는 파일 목록과 충돌을 해결하기 위한 옵션이 표시됩니다.

다음과 같은 두 가지 기본 옵션이 있습니다.

• Git 폴더 UI를 사용하여 충돌을 해결합니다.
• Git 작업을 중단하고 충돌하는 파일의 변경 내용을 수동으로 삭제한 다음 Git 작업을 다시 시도합니다.

Git 폴더 UI를 사용하여 병합 충돌 해결하는 경우 편집기에서 충돌을 수동으로 해결하거나 들어오는 변경 내용이나 현재 변경 내용을 모두 유지하는 중에서 선택해야 합니다.

모든 최신 상태로 유지 또는 들어오는 변경 내용 수행

현재 또는 들어오는 변경 내용을 모두 유지하려는 알고 있는 경우 전자 필기장 창의 파일 이름 오른쪽에 있는 케밥을 클릭하고 모든 현재 변경 내용을 유지하거나 들어오는 모든 변경 내용을선택합니다. 동일한 레이블이 있는 단추를 클릭하여 변경 내용을 커밋하고 충돌을 해결합니다.

수동으로 충돌 해결

수동 충돌 해결을 사용하면 병합에서 수락해야 하는 충돌하는 줄을 결정할 수 있습니다. 병합 충돌 경우 충돌 파일의 내용을 직접 편집하여 충돌을 해결합니다.

충돌을 해결하려면 유지하려는 코드 줄을 선택하고 Git 병합 충돌 표식을 포함하여 다른 모든 항목을 삭제합니다. 완료되면 확인됨으로 표시를 선택합니다.

병합 충돌 해결할 때 잘못된 선택을 한 경우 중단 단추를 클릭하여 프로세스를 중단하고 모든 항목을 실행 취소합니다. 모든 충돌이 해결되면 병합 계속 또는 다시베이스 계속 옵션을 클릭하여 충돌을 해결하고 작업을 완료합니다.

Git reset

Databricks Git 폴더에서 Azure Databricks UI 내에서 Git reset 을 수행할 수 있습니다. Databricks Git 폴더의 Git 재설정은 git reset --hard와 git push --force이 결합된 것과 동일합니다.

Git 재설정은 분기 내용과 기록을 다른 분기의 최신 상태로 바꿉니다. 편집 내용이 업스트림 분기와 충돌하는 경우 이를 사용할 수 있으며 업스트림 분기로 다시 설정할 때 편집 내용이 손실되는 것은 상관없습니다. git reset –hard에 대한 자세한 정보.

원격 업스트림 브랜치로 재설정

git reset 이 시나리오에서는 다음을 수행합니다.

• 선택한 분기(예: feature_a)를 다른 분기(예: main)로 다시 설정합니다.
• 또한 업스트림(원격) 분기 feature_a 기본으로 다시 설정합니다.

분기를 원격 분기로 다시 설정하려면 다음을 수행합니다.

1. Git 폴더 UI에서 브랜치 메뉴를 선택하여 재설정할 브랜치를 선택합니다.

   

2. 케밥 메뉴에서 재설정을 선택합니다.

   Git 재설정 작업을 케밥 메뉴에서 수행합니다.

3. 초기화할 브랜치를 선택합니다.

   

스파스 체크 아웃 모드 구성

스파스 체크 아웃은 Databricks에서 원격 리포지토리 디렉터리의 하위 집합만 복제하고 작업할 수 있는 클라이언트 쪽 설정입니다. 이는 리포지토리의 크기가 Databricks 지원 제한을 초과하는 경우에 특히 유용합니다.

새 리포지토리를 추가(복제)할 때 스파스 체크 아웃 모드를 사용할 수 있습니다.

1. Git 폴더 추가 대화 상자에서 고급을 엽니다.

2. 스파스 체크아웃 모드를 선택합니다.

   

3. 원뿔 패턴 상자에서 원하는 원뿔 체크 아웃 패턴을 지정합니다. 여러 개의 패턴을 줄 바꿈으로 구분합니다.

현재는 Azure Databricks의 리포지토리에 대한 스파스 체크 아웃을 사용하지 않도록 설정할 수 없습니다.

원뿔 패턴의 작동 방식

스파스 체크 아웃 모드에서 원뿔 패턴이 작동하는 방식을 이해하려면 원격 리포지토리 구조를 나타내는 다음 다이어그램을 참조하세요.

스파스 체크 아웃 모드선택하지만 원뿔 패턴을 지정하지 않으면 기본 원뿔 패턴이 적용됩니다. 여기에는 루트의 파일만 포함되고 하위 디렉터리가 없으므로 다음과 같이 리포지토리 구조가 생성됩니다.

스파스 체크 아웃 원뿔 패턴을 parent/child/grandchild로 설정하면 grandchild 디렉터리의 모든 콘텐츠가 재귀적으로 포함됩니다. /parent, /parent/child 및 루트 디렉터리의 파일도 즉시 포함됩니다. 다음 다이어그램에서 디렉터리 구조를 참조하세요.

줄 바꿈으로 구분된 여러 패턴을 추가할 수 있습니다.

스파스 체크 아웃 설정 수정

리포지토리가 만들어지면 설정 > 고급 > 원뿔 패턴에서 스파스 체크 아웃 원뿔 패턴을 편집할 수 있습니다.

다음 작동을 확인합니다.

• 커밋되지 않은 변경 내용이 없는 경우 원뿔 패턴에서 폴더를 제거하면 Databricks에서 폴더가 제거됩니다.

• 스파스 체크 아웃 원뿔 패턴을 편집하여 폴더를 추가하면 추가로 끌어오지 않아도 Databricks에 폴더가 추가됩니다.

• 해당 폴더에 커밋되지 않은 변경 내용이 있는 경우 스파스 체크 아웃 패턴을 변경하여 폴더를 제거할 수 없습니다.

  예를 들어 사용자가 폴더의 파일을 편집하고 변경 내용을 커밋하지 않습니다. 그런 다음, 이 폴더를 포함하지 않도록 스파스 체크 아웃 패턴을 변경하려고 합니다. 이 경우 패턴이 허용되지만 실제 폴더는 삭제되지 않습니다. 패턴을 되돌려 해당 폴더를 포함하고, 변경 내용을 커밋한 다음, 새 패턴을 다시 적용해야 합니다.

스파스 체크 아웃을 사용하여 변경 및 푸시

기존 파일을 편집하고 Git 폴더에서 커밋하고 푸시할 수 있습니다. 파일의 새 폴더를 만들 때 해당 리포지토리에 대해 지정한 원뿔 패턴에 포함합니다.

원뿔 패턴 외부에 새 폴더를 포함하면 커밋 및 푸시 작업 중에 오류가 발생합니다. 이 문제를 해결하려면 커밋 및 푸시하려는 새 폴더를 포함하도록 원뿔 패턴을 편집합니다.

리포지토리 구성 파일의 패턴

커밋 출력 구성 파일은 gitignore 패턴과 유사한 패턴을 사용하고 다음을 수행합니다 .

• 긍정 패턴을 사용하면 일치하는 Notebook의 출력을 포함할 수 있습니다.
• 부정 패턴은 일치하는 Notebook의 출력을 포함하지 않습니다.
• 패턴은 모든 Notebook에 대해 순서대로 평가됩니다.
• .ipynb Notebook으로 확인되지 않는 경로 또는 유효하지 않은 경로는 무시됩니다.

양수 패턴: Notebook 경로 folder/innerfolder/notebook.ipynb의 출력을 포함하려면 다음 패턴을 사용합니다.

**/*
folder/**
folder/innerfolder/note*

음수 패턴: Notebook에 대한 출력을 제외하려면 양수 패턴이 일치하지 않는지 확인하거나 구성 파일의 올바른 위치에 음수 패턴을 추가합니다. 부정(제외) 패턴은 !로 시작합니다.

!folder/innerfolder/*.ipynb
!folder/**/*.ipynb
!**/notebook.ipynb

스파스 체크 아웃 제한

스파스 체크 아웃은 현재 크기가 4GB보다 큰 Azure DevOps 리포지토리에서 작동하지 않습니다.

리포지토리를 추가하고 나중에 원격으로 연결

Git 폴더를 프로그래밍 방식으로 관리하고 사용하려면 Git 폴더 REST API를 사용합니다.

Git 폴더 삭제

작업 영역에서 Git 폴더를 제거하려면 다음을 수행합니다.

1. Git 폴더를 마우스 오른쪽 단추로 클릭하고 휴지통으로 이동을 선택합니다.
2. 확인할 Git 폴더 이름을 입력합니다.
3. 확인을 클릭하고 휴지통으로 이동합니다.