이 문서에서는 패브릭 확장성 도구 키트 유효성 검사기를 사용하여 게시 요청 양식을 제출하기 전에 워크로드가 모든 게시 요구 사항을 충족하는지 확인하는 방법을 설명합니다. 유효성 검사기는 개발 프로세스 초기에 규정 준수 문제를 식별하여 검토 시간을 줄이고 승인 성공률을 개선하는 데 도움이 됩니다.
개요
패브릭 확장성 도구 키트 유효성 검사기는 파트너가 Microsoft Fabric 게시 요구 사항에 대해 워크로드의 유효성을 검사할 수 있도록 설계된 명령줄 도구입니다. 이 도구는 자동화된 테스트와 수동 안내 테스트를 결합하여 포괄적인 유효성 검사 범위를 제공합니다.
유효성 검사 유형
유효성 검사기는 다음 두 가지 유형의 유효성 검사를 제공합니다.
- 자동화된 테스트: 워크로드에서 규정 준수 문제를 자동으로 검사하는 프로그래밍 방식 검사
- 수동 단계별 테스트: 사용자 확인이 필요한 유효성 검사 작업에 대한 단계별 지침
필수 조건
유효성 검사 도구를 사용하기 전에 다음이 있는지 확인합니다.
- 유효성 검사를 위해 준비된 완료된 워크로드
- 패브릭 확장성 도구 키트 유효성 검사기 리포지토리에 대한 액세스
- 개발 머신에서 명령줄 인터페이스 액세스
- 워크로드가 올바르게 구성되고 배포 가능
유효성 검사기 액세스
패브릭 확장성 도구 키트 유효성 검사기는 GitHub를 통해 사용할 수 있습니다.
🔗 리포지토리: https://github.com/microsoft/fabric-extensibility-toolkit-validator
자세한 설치 및 사용 지침은 Microsoft Fabric 확장성 도구 키트 유효성 검사기를 참조하세요.
리포지토리를 방문하여 다음을 수행합니다.
- 최신 버전의 유효성 검사기 다운로드
- 사용 가능한 명령줄 매개 변수 검토
- 도구 사용에 대한 액세스 설명서
- 시스템 요구 사항 및 설정 지침 확인
유효성 검사기 사용
명령줄 인터페이스
유효성 검사기는 워크로드에 대해 실행하는 명령줄 도구로 작동합니다. 특정 매개 변수 및 사용 지침은 유효성 검사기 리포지토리에서 사용할 수 있습니다.
다음 내용은 리포지토리 설명서를 참조하세요.
- 전체 매개 변수 참조
- 명령줄 구문
- 구성 옵션
- 출력 형식 세부 정보
유효성 검사 워크플로
유효성 검사기를 사용할 때 다음 일반 워크플로를 따릅니다.
- 워크로드 준비: 워크로드가 빌드되어 테스트할 준비가 되었는지 확인
- 자동화된 테스트 실행: 유효성 검사기의 자동화된 준수 검사 실행
- 수동 테스트 완료: 수동 확인 작업에 대한 안내 지침을 따릅니다.
- 결과 검토: 유효성 검사 보고서 분석 및 문제 식별
- 주요 발견 사항들: 유효성 검사기에서 식별한 준수 격차 수정
- 유효성 다시 검사: 유효성 검사기를 다시 실행하여 모든 문제가 해결되었는지 확인합니다.
- 게시를 위해 제출: 유효성 검사가 통과되면 게시 요청을 계속 진행합니다.
유효성 검사 범위
유효성 검사기는 워크로드를 다음과 같이 확인합니다.
- 워크로드에 대한 게시 요구 사항: 인프라, 보안 및 규정 준수 표준
- 항목에 대한 게시 요구 사항: 사용자 환경 및 기능 요구 사항
- 매니페스트 준수: 적절한 구성 및 필수 속성
- 플랫폼 통합: 패브릭 플랫폼 기능의 올바른 구현
결과 해석
자동화된 테스트 결과
유효성 검사기는 다음을 포함하여 자동화된 테스트 결과에 대한 자세한 보고서를 제공합니다.
- 통과/실패 상태: 테스트 결과의 명확한 표시
- 문제 설명: 규정 준수 격차에 대한 구체적인 설명
- 수정 지침: 식별된 문제 해결을 위한 제안
- 심각도 수준: 다양한 유형의 문제를 해결하기 위한 우선 순위 표시기
수동 테스트 지침
수동 유효성 검사 작업의 경우 도구는 다음을 제공합니다.
- 단계별 지침: 수동 확인 프로세스에 대한 명확한 지침
- 확인 기준: 확인할 특정 표준
- 설명서 요구 사항: 규정 준수를 입증하는 데 필요한 증거
- 모범 사례: 최적의 구현을 위한 권장 사항
모범 사례
사전 유효성 검사 준비
- 전체 개발: 유효성 검사 전에 워크로드가 기능 완성인지 확인
- 철저히 테스트: 유효성 검사기를 실행하기 전에 자체 테스트 수행
- 요구 사항 검토: 미리 게시 요구 사항 숙지
- 설명서 준비: 필요한 모든 설명서가 준비되고 액세스할 수 있는지 확인
유효성 검사 실행
- 정기적으로 실행: 개발 전반에 걸쳐 유효성 검사기를 사용합니다.
- 즉시 문제 해결: 식별된 문제를 가능한 한 빨리 해결
- 문서 변경 내용: 유효성 검사 피드백에 따라 수정된 내용 추적
- 수정 사항 확인: 확인을 위해 변경한 후 유효성 검사를 다시 실행합니다.
Troubleshooting
일반적인 문제
- 도구 설치 문제: 설치 지침은 리포지토리 설명서를 참조하세요.
- 권한 문제: 유효성 검사기를 실행할 적절한 액세스 권한이 있는지 확인합니다.
- 구성 오류: 워크로드 구성이 예상 형식과 일치하는지 확인
- 환경 문제: 개발 환경이 도구 요구 사항을 충족하는지 확인
도움말 보기
- 리포지토리 설명서: 유효성 검사기 리포지토리에서 자세한 지침을 확인합니다.
- 문제 보고: 리포지토리의 문제 추적기를 사용하여 문제를 보고하거나 질문
- 커뮤니티 지원: 유효성 검사기를 사용하여 다른 개발자와 참여
- Microsoft 지원: 추가 지원을 받으려면 Microsoft 파트너 담당자에게 문의하세요.
관련 내용
- 게시 요구 사항 - 일반 요구 사항 개요
- 테넌트 간 게시 요구 사항
- 워크로드에 대한 게시 요구 사항 - 워크로드별 표준
- 항목에 대한 게시 요구 사항 - 항목별 요구 사항
- 게시 개요 - 상위 수준의 게시 프로세스
- 매니페스트 개요 - 워크로드 매니페스트 구성