Notebook 원본 제어 및 배포
이 문서에서는 Microsoft Fabric의 Notebook에 대해 Git 통합 및 배포 파이프라인이 작동하는 방법을 설명합니다. 리포지토리에 대한 연결을 설정하고, Notebook을 관리하고, 다양한 환경에 배포하는 방법을 알아봅니다.
Notebook Git 통합
패브릭 Notebook은 Azure DevOps와 소스 제어를 위한 Git 통합을 제공합니다. Git 통합을 사용하면 Notebook을 백업 및 버전 지정하고, 필요에 따라 이전 단계로 되돌리고, Git 분기를 사용하여 공동 작업하거나 단독으로 작업하고, Fabric 내에서 전자 필기장 콘텐츠 수명 주기를 완전히 관리할 수 있습니다.
연결 설정
작업 영역 설정에서 리포지토리에 대한 연결을 쉽게 설정하여 변경 내용을 커밋하고 동기화할 수 있습니다. 연결을 설정하려면 Git 통합 시작을 참조하세요. 연결되면 Notebook을 포함한 항목이 소스 제어판에 표시됩니다.
Notebook 인스턴스를 Git 리포지토리에 성공적으로 커밋하면 리포지토리에 Notebook 폴더 구조가 표시됩니다.
이제 끌어오기 요청 만들기와 같은 향후 작업을 실행할 수 있습니다.
Git의 Notebook 표현
다음 이미지는 리포지토리에 있는 각 Notebook 항목의 파일 구조 예제입니다.
Notebook 항목을 Git 리포지토리에 커밋하면 Notebook 코드가 표준 .ipynb 파일 대신 소스 코드 형식으로 변환됩니다. 예를 들어 PySpark Notebook은 notebook-content.py 파일로 변환됩니다. 이 방법을 사용하면 기본 제공 diff 기능을 사용하여 코드 검토를 더 쉽게 수행할 수 있습니다.
항목 콘텐츠 원본 파일에서 메타데이터(기본 레이크하우스 및 연결된 환경 포함), markdown 셀 및 코드 셀이 유지되고 구별됩니다. 이 방법은 패브릭 작업 영역으로 다시 동기화할 때 정확한 복구를 지원합니다.
Git에 동기화할 때 Notebook 셀 출력은 포함되지 않습니다.
참고 항목
- 현재 Notebook 리소스의 파일은 리포지토리에 커밋되지 않습니다. 이러한 파일 커밋은 향후 릴리스에서 지원됩니다.
- 연결된 환경은 리포지토리에서 패브릭 작업 영역으로 동기화할 때 Notebook에 유지됩니다. 현재 작업 영역 간 참조 환경은 지원되지 않습니다. Notebook을 실행하려면 새 환경 또는 작업 영역 기본 설정에 수동으로 연결해야 합니다.
- 기본 레이크하우스 ID는 리포지토리에서 패브릭 작업 영역으로 동기화할 때 Notebook에 유지됩니다. 기본 레이크하우스를 사용하여 Notebook을 커밋하는 경우 새로 만든 레이크하우스 항목을 수동으로 참조해야 합니다. 자세한 내용은 Lakehouse Git 통합을 참조하세요.
배포 파이프라인의 Notebook
배포 파이프라인을 사용하여 개발, 테스트 및 프로덕션과 같은 다양한 환경에 Notebook 코드를 배포할 수도 있습니다. 이 기능을 사용하면 개발 프로세스를 간소화하고 품질과 일관성을 보장하며 간단한 로우 코드 작업으로 수동 오류를 줄일 수 있습니다. 배포 규칙을 사용하여 Notebook이 배포될 때의 동작을 사용자 지정할 수도 있습니다(예: Notebook의 기본 레이크하우스 변경).
배포 파이프라인을 사용하여 Notebook 배포를 완료하려면 다음 단계를 사용합니다.
새 배포 파이프라인을 만들거나 기존 배포 파이프라인을 엽니다. (자세한 내용은 를 참조하세요 .배포 파이프라인을 시작합니다.)
배포 목표에 따라 여러 단계에 작업 영역을 할당합니다.
다음 예제와 같이 여러 단계 간에 전자 필기장을 포함한 항목을 선택하고 보고 비교합니다.
배포를 선택하여 개발, 테스트 및 프로덕션 단계에서 Notebook을 배포합니다.
(선택 사항) 배포 규칙을 선택하여 배포 프로세스에 대한 배포 규칙을 만들 수 있습니다. 배포 규칙 항목은 배포 프로세스의 대상 단계에 있습니다.
패브릭은 배포 규칙을 사용하여 배포할 때 각 Notebook 인스턴스에 대한 기본 레이크하우스 매개 변수화를 지원합니다. 세 가지 옵션을 사용하여 대상 기본 레이크하우스를 지정할 수 있습니다. 원본 레이크하우스, N/A(기본 레이크하우스 없음) 및 기타 레이크하우스와 동일합니다.
이 규칙을 설정하여 보안 데이터 격리를 달성할 수 있습니다. Notebook의 기본 레이크하우스는 배포 중에 대상으로 지정한 레이크하우스로 바뀝니다.
참고 항목
대상 환경에서 다른 레이크하우스를 채택하도록 선택하는 경우 Lakehouse ID 는 반드시 있어야 합니다. 레이크하우스 URL 링크에서 레이크하우스의 ID를 찾을 수 있습니다.
배포 기록에서 배포 상태를 모니터링합니다.
