이 가이드를 사용하여 확장성 도구 키트를 사용하여 Microsoft Fabric 워크로드 빌드를 시작합니다. 환경을 설정하고, GitHub Codespaces 또는 로컬에서 Starter-Kit 실행하고, 빌드하고 게시하는 데 필요한 기본 사항을 알아봅니다.
당신이 구축한 것
Fabric 내에서 Starter-Kit 를 실행하고, 매니페스트를 탐색하고, API 사용을 호스트하고, 작은 UI를 변경하고, 워크로드가 만드는 항목이 네이티브 패브릭 아티팩트처럼 동작하는 방식을 이해합니다.
필수 조건
- 항목을 만들 수 있는 패브릭 테넌트 및 작업 영역에 대한 액세스
- GitHub 계정(Codespaces에 필요)
- 로컬로 개발하는 경우: 최근 Node.js LTS 및 패키지 관리자(정확한 도구에 대한 추가 정보 참조)
- Microsoft Entra 애플리케이션을 만들기 위한 액세스
- 선택 사항: Azure에서 웹앱을 호스트하려는 경우 Azure 구독
팁 (조언)
로컬 개발은 기본적으로 Windows, macOS 및 Linux에서 지원됩니다. 설치 스크립트를 실행하거나 개발 서버를 시작하기 전에 Starter-Kit의 필수 구성 요소를 검토하고 충족합니다.
비고
Starter-Kit를 사용해 보기 위해 테넌트에 아무것도 배포할 필요가 없습니다. 개발 중에 DevGateway를 사용하여 패브릭 호스트를 에뮬레이트합니다.
중요합니다
패브릭 작업 영역에 액세스할 수 있고 테넌트가 개발자 기능을 허용하는지 확인합니다. 테스트하기 전에 패브릭 개발자 모드를 사용하도록 설정합니다.
경로 선택
빠르게 시작하려면 다음 옵션 중 하나를 선택하여 코드에 액세스합니다.
옵션 1: GitHub Codespaces에서 시작
- Starter-Kit 리포지토리를 GitHub 계정에 포크합니다.
- 포크에 GitHub Codespace를 만들어 클라우드 기반 개발 환경을 시작합니다.
GitHub Codespaces에 대한 자세한 내용은 GitHub Codespaces 설명서를 참조하세요.
옵션 2: 로컬로 복제 및 실행
- Starter-Kit 리포지토리를 GitHub 계정에 포크합니다.
- 로컬 컴퓨터에 포크를 복제합니다.
git clone https://github.com/<your-account>/fabric-extensibility-toolkit.git
cd fabric-extensibility-toolkit
- 로컬 개발에 필요한 필수 구성 요소를 설치합니다.
필수 도구:
- Node.js LTS: 다운로드 Node.js
- PowerShell 7 (macOS/Linux의 pwsh): PowerShell 설치
- .NET SDK (macOS의 경우 x64 빌드 사용): .NET 다운로드
- VS Code 또는 유사한 편집기: VS Code 다운로드
- Azure CLI (Microsoft Entra 앱 만들기에만 사용): Azure CLI 설치
AI 지원 개발
이 리포지토리는 AI 쌍 프로그래밍 도구에서 잘 작동합니다. 로컬로 개발하든 GitHub Codespaces에서 개발하든 GitHub Copilot 또는 기타 AI 도우미를 사용하여 React 구성 요소 편집, 경로 업데이트 또는 테스트 스캐폴딩 생성과 같은 작업을 가속화할 수 있습니다.
팁 (조언)
Starter-Kit 리포지토리는 AI를 사용할 수 있으며, 사용자의 요구에 맞게 Hello World 항목을 조정하는 방법을 안내하는 GitHub Copilot 지침을 포함합니다. 다른 AI 도구(예: Anthropic Claude)는 동일한 지침을 따를 수 있지만 리포지토리의 지침 파일 또는 문서를 읽도록 구성해야 합니다.
- AI를 사용하여 항목 편집기/보기 구성 요소를 초안으로 작성한 다음 Starter-Kit에 사용되는 호스트 API 패턴에 맞게 조정합니다.
- AI에 워크로드 매니페스트를 요약하고 최소한의 권한 집합을 제안하도록 요청합니다.
- Codespaces에서 Copilot는 브라우저 또는 VS Code 데스크톱에서 사용할 수 있습니다. 변경 내용을 즉시 볼 수 있도록 개발 서버를 계속 실행합니다.
팁 (조언)
다른 사용자가 빌드하는 항목을 확인하려면 확장성 샘플을 열고 환경에 배포합니다. 거기서 시작하는 데 도움이 되는 다양한 항목 유형을 찾을 수 있습니다.
모범 사례
- 리포지토리 포크: Starter-Kit 리포지토리를 포크하고 포크를 프로젝트의 기반으로 사용합니다.
- 동기화 유지: 업스트림과 동기화된 포크를 유지하여 개선 사항을 선택합니다.
- 프로젝트 구조 일관성 유지: Starter-Kit의 프로젝트 구조 및 조직 패턴을 유지하여 향후 업데이트와의 호환성을 보장하고 코드 명확성을 유지합니다.
- 정기적인 Starter-Kit 통합: 버그 수정, 새로운 기능 및 보안 업데이트를 활용하기 위해 Starter-Kit 코드 변경 내용을 프로젝트에 정기적으로 통합합니다. 정기적으로(매월 또는 분기별) 업스트림 변경 내용을 검토하고 병합하는 프로세스를 설정합니다.
- 초기 매니페스트 유효성 검사: 워크로드 매니페스트의 유효성을 조기에 검사하고 최소 권한 권한을 따릅니다.
- 개발 컨테이너 사용: 일관되고 삭제 가능한 환경에 개발 컨테이너 또는 Codespace를 사용합니다.
- 제공된 스크립트 사용: 제공된 스크립트(설치, StartDevServer, StartDevGateway)를 사용하여 설정 및 매일 워크플로를 자동화합니다.
다음 단계
코드(Codespaces 또는 로컬)에 액세스할 수 있으면 다음의 단계별 지침에 대한 자세한 설치 가이드 를 계속 진행합니다.
- 설치 스크립트 실행
- 개발 환경 시작
- 패브릭 개발자 기능을 활성화합니다
- 첫 번째 HelloWorld 항목 테스트
- 코딩 시작
- AI 지원 개발 팁
- 일반적인 문제 해결
추가 리소스
- 아키텍처 및 호스트, 앱 및 패브릭 서비스가 상호 작용하는 방법 알아보기
- 스키마 및 모범 사례에 대한 매니페스트 개요 읽기
- 워크로드 매니페스트 구조 및 구성 이해
- 로컬 테스트를 위해 DevGateway 를 사용하여 개발
- 준비가 되면 워크로드를 광범위하게 공유하기 위해 워크로드를 게시하십시오