Microsoft Fabric 확장성 도구 키트 유효성 검사기는 Microsoft Fabric 워크로드에 대한 포괄적인 유효성 검사 도구입니다. 퍼블리셔는 공식 인증을 위해 제출하기 전에 Microsoft Fabric 요구 사항에 대해 워크로드의 유효성을 검사하는 데 도움이 됩니다.
이 도구는 패브릭 워크로드를 개발하는 외부 파트너 및 고객을 위한 공개 유효성 검사 도구 입니다.
개요
유효성 검사 도구를 사용하면 워크로드 작성자가 Microsoft Fabric 워크로드의 자체 유효성을 검사할 수 있습니다. 개발 프로세스 초기에 잠재적인 문제를 식별할 수 있도록 설계되어 공식 유효성 검사 프로세스가 성공할 가능성이 높아질 수 있습니다.
중요합니다
성공적인 자체 유효성 검사는 공식 유효성 검사를 통과하기 위한 보장은 아니지만 일반적인 문제를 조기에 catch하여 성공 가능성을 크게 높입니다.
필수 조건
- Node.js (버전 14 이상)
- 패브릭 워크로드 허브에 대한 액세스 권한이 있는 Microsoft Fabric 계정
- Chrome/Chromium 브라우저 (자동화된 매니페스트 다운로드용)
- Microsoft Fabric 확장성 도구 키트를 사용하여 빌드된 워크로드 패키지
- 게시된 워크로드 - 유효성 검사를 시작하기 전에 워크로드를 테넌트에 게시해야 합니다.
팁 (조언)
게시에 사용되는 테넌트보다 유효성 검사에 다른 테넌트를 사용합니다. 이를 통해 최종 사용자가 볼 수 있는 것을 경험하고 보다 현실적인 유효성 검사 환경을 제공할 수 있습니다.
시작하기
1. 워크로드 구성
먼저 공식 시작 키트를 사용하여 워크로드를 만듭니다.
- 패브릭 확장성 도구 키트(시작 키트)를 복제합니다.
- 도구 키트 설명서에 따라 워크로드를 빌드합니다.
2. 종속성 설치
유효성 검사기 디렉터리로 이동하여 종속성을 설치합니다.
cd fabric-extensibility-toolkit-validator/validator
npm install
3. 기본 유효성 검사
워크로드에 대한 전체 유효성 검사를 실행합니다.
기본 유효성 검사 명령
node index.js --workload-name "YourPublisher.YourWorkload" --workload-stage "Preview"
실제 워크로드가 있는 예제
node index.js --workload-name "Contoso.DataProcessor" --workload-stage "Preview"
GA 단계 워크로드의 경우
node index.js --workload-name "Contoso.DataProcessor" --workload-stage "GA"
비고
유효성 검사를 실행하기 전에 브라우저에서 Microsoft Fabric에 로그인했는지 확인하고 워크로드가 대상 테넌트에서 게시되고 액세스할 수 있는지 확인합니다.
명령줄 옵션
| Option | Description | 예시 |
|---|---|---|
--workload-name |
전체 워크로드 이름(Publisher.Product) | "Contoso.DataProcessor" |
--workload-stage |
유효성 검사 단계 |
"Preview" 또는 "GA" |
--help |
도움말 정보 표시 | (플래그만 해당) |
유효성 검사 프로세스
유효성 검사기는 여러 단계를 통해 실행됩니다.
- 매니페스트 다운로드 - 패브릭 워크로드 허브에서 워크로드 매니페스트를 자동으로 다운로드합니다.
- 테스트 검색 - 워크로드 유형에 따라 적용 가능한 테스트 사례를 식별합니다.
- 테스트 실행 - 구성된 유효성 검사기를 사용하여 유효성 검사 테스트를 실행합니다(자동화 및 수동 모두).
- 보고서 생성 - 여러 형식으로 포괄적인 보고서를 만듭니다.
출력 구조
유효성 검사 후에는 디렉터리에서 Results 결과를 찾을 수 있습니다.
Results/
├── YourPublisher.YourWorkload/
│ └── Preview/
│ └── [ValidationID]/
│ ├── YourPublisher.YourWorkload_Metadata.json
│ ├── YourPublisher.YourWorkload_Manifest.json
│ ├── YourPublisher.YourWorkload_Workload_Tests.json
│ ├── YourPublisher.YourWorkload.Item_Item_Tests.json
│ └── Reports/
│ ├── ValidationReport.md
│ ├── ValidationReport.html
│ └── ValidationReport.pdf
유효성 검사기
이 도구는 특수화된 유효성 검사기 집합을 사용하여 워크로드의 다양한 측면을 확인합니다. 일부 유효성 검사기는 자동화되지만 다른 유효성 검사기는 수동 상호 작용이 필요합니다.
Troubleshooting
브라우저 문제
- Chrome/Chromium이 설치되어 있고 액세스할 수 있는지 확인합니다.
- 브라우저에서 Microsoft Fabric에 로그인했는지 확인합니다.
- 패브릭 서비스에 대한 네트워크 연결을 확인합니다.
매니페스트 다운로드 문제
- 워크로드 이름이 정확히 일치하는지 확인합니다(대/소문자 구분).
- 패브릭 워크로드 허브에서 워크로드가 배포되고 액세스할 수 있는지 확인합니다.
- 인증 및 사용 권한을 확인합니다.
테스트 실행 문제
- 결과 디렉터리에서 유효성 검사 로그를 검토합니다.
- 에서 개별 테스트 사례 설명서를 확인합니다
validator/validators/. - 필요한 모든 워크로드 자산에 액세스할 수 있는지 확인합니다.
관련 콘텐츠
- Microsoft Fabric 확장성 도구 키트 - 패브릭 워크로드를 빌드하기 위한 공식 시작 키트