환경 설정(미리 보기)

이 문서는 Microsoft Fabric 워크로드 개발 키트를 사용하여 워크로드를 빌드하려는 개발자를 대상으로 합니다. 이 문서에서는 워크로드 빌드를 시작할 수 있도록 개발 환경을 설정하는 프로세스를 안내합니다.

필수 조건

워크로드 개발을 시작하기 전에 다음 단계가 필요합니다.

Git

프로젝트의 변경 내용을 관리하고 추적하는 데 사용하는 분산 버전 제어 시스템입니다.

npm(노드 패키지 관리자)

프로젝트에서 사용하는 패키지를 관리하고 공유하는 데 사용되는 Node.js 대한 기본 패키지 관리자입니다.

Node.JS

웹 브라우저 외부에서 JavaScript 코드를 실행하는 오픈 소스 플랫폼 간 JavaScript 런타임 환경입니다. 이를 사용하여 서버 쪽 JavaScript 코드를 실행합니다.

Webpack

최신 JavaScript 애플리케이션을 위한 정적 모듈 번들러입니다. 브라우저에서 사용할 JavaScript 파일을 번들로 묶는 데 도움이 됩니다.

Webpack CLI

Webpack에 대한 명령줄 인터페이스입니다. 이를 통해 명령줄에서 Webpack을 사용할 수 있습니다.

DevGateway

로컬 모드에서는 로컬로 호스트되는 워크로드 백 엔드가 테넌트와 통신할 수 있도록 허용하기만 하면 됩니다. 워크로드는 개발자의 컴퓨터에서 작동합니다. 패브릭에서 워크로드로의 워크로드 API 호출은 DevGateway 명령줄 유틸리티에서 관리하는 Azure Relay 채널의 워크로드 쪽과 함께 Azure Relay를 통해 전달됩니다. 워크로드 제어 API 호출은 Azure Relay 채널이 필요하지 않고 워크로드에서 Fabric으로 직접 이루어집니다. 또한 DevGateway 유틸리티는 특정 용량 컨텍스트 내에서 Fabric을 사용하여 워크로드의 로컬(개발) 인스턴스 등록을 관리하여 해당 용량에 할당된 모든 작업 영역에서 워크로드에 액세스할 수 있도록 합니다.

참고 항목

DevGateway 유틸리티를 종료하면 워크로드 인스턴스 등록이 자동으로 제거됩니다.

환경 생성

아래 단계에 따라 환경을 만듭니다.

워크로드 환경 인증

패브릭 테넌트에 대한 워크로드 액세스를 설정하려면 워크로드 애플리케이션에 대한 Microsoft Entra ID를 구성해야 합니다. Microsoft Entra ID는 애플리케이션의 데이터 평면 API에 대한 보안 액세스 및 작업을 보장하기 위해 필요합니다.

주요 단계는 다음과 같습니다.

1. 데이터 평면 API에 대한 범위 추가: 이러한 범위는 데이터 평면 API에 의해 노출되는 작업 그룹을 나타냅니다. 백 엔드 샘플에는 워크로드 항목 및 Lakehouse 파일에 대한 읽기 및 쓰기 작업을 포함하는 네 가지 예제 범위가 제공됩니다.

2. 패브릭 클라이언트 애플리케이션 사전 인증: 패브릭 클라이언트 애플리케이션은 정의한 범위에 대해 미리 인증되어야 합니다. 이렇게 하면 워크로드 항목 및 Lakehouse 파일에 필요한 작업을 수행할 수 있습니다.

3. 애플리케이션에 대한 비밀 생성: 이 비밀은 애플리케이션을 보호하는 데 사용되며 백 엔드 샘플을 구성할 때 사용됩니다.

4. 선택적 클레임 'idtyp' 추가: 이 클레임은 액세스 토큰에 추가되며 ID 용도로 사용됩니다.

이러한 단계는 워크로드를 설정할 때 필요합니다. 이러한 단계를 수행하는 방법에 대한 자세한 가이드는 인증 설정을 참조하세요.

웹앱(클라우드 모드에만 해당)

클라우드 모드(로컬 컴퓨터 모드와 함께) 워크로드 배포를 수행하려면 프런트 엔드(FE) 및 BE(백 엔드)에 대해 웹앱 do기본 설정해야 합니다. 최대 세그먼트가 하나 더 있는 리소스 ID의 하위 기본이어야 합니다. 회신 URL 호스트는 기본 FE 호스트와 동일해야 합니다기본. 자세한 내용은 상용구 백 엔드 웹앱 만들기 및 배포를 참조 하세요.

패브릭 개발 테넌트 설정

워크로드 SDK 샘플을 실행하고 워크로드를 빌드하는 컨텍스트에서는 전용 개발 테넌트를 사용하는 것이 좋습니다. 이 방법은 격리된 환경을 보장하여 실수로 중단되거나 프로덕션 시스템을 수정할 위험을 최소화합니다. 또한 잠재적 노출 또는 손상으로부터 프로덕션 데이터를 보호하는 추가 보안 계층을 제공합니다. 이 권장 사항을 준수하는 것은 업계 모범 사례에 부합하며 강력하고 안정적이며 안전한 개발 수명 주기에 기여합니다.

테넌트 설정 및 개발 설정

1. 패브릭 관리자의 권한은 개발을 시작하고 로컬 머신과 패브릭 용량에 연결할 수 있어야 합니다. 용량 관리자 권한이 있는 개발자만 워크로드를 연결하고 용량에 등록할 수 있습니다. 프런트 엔드 개발에는 용량 관리자 권한이 필요하지 않습니다.

   사용자가 개발을 시작할 수 있도록 하려면 용량 관리자에 포함하면 추가 워크로드 테넌트 설정을 개발할 수 있습니다.

   

2. 이전 단계에서 사용자에게 권한이 부여된 후 각 사용자는 패브릭 개발자 모드에서 개발 설정 영역에 대한 개발 모드를 사용하도록 설정할 수 있습니다.

   

관련 콘텐츠

• 빠른 시작 가이드
• 인증 개요