다음을 통해 공유

매니페스트 다운로드

  • 아티클

개요

Fabric의 워크로드 정의에는 WorkloadManifest.xml 및 Item.xml 파일이 필요합니다. 설정을 위한 기본 워크로드 및 워크로드 항목 구성 설정을 보유하고 있으며, 워크로드 설정 및 관리에 대한 가이드 역할을 합니다. 이를 통해 Fabric에 원활하게 통합하기 위한 필수 워크로드 세부 정보를 정의, 공유 및 기록하는 데 도움을 줍니다.

샘플 리포지토리에서 .nupkg 파일이 빌드 프로세스 중에 src/Packages/manifest 폴더에 있는 XML 파일에서 생성됩니다. 이 패키지된 파일에는 워크로드에 필요한 모든 정보가 보관됩니다. workload-dev-mode.json 파일에는 새로 만든 .nupkg 파일을 가리키는 ManifestPackageFilePath 필드가 있습니다.

업로드 및 등록 프로세스

  1. 사용자 인증: 개발 중에 샘플을 실행하면 인증이 업로드 및 등록 프로세스를 시작합니다. 이렇게 하면 워크로드가 ID와 올바르게 연결됩니다.
  2. 매니페스트 구문 분석: 업로드된 매니페스트는 구문 분석을 거쳐 구조와 콘텐츠의 유효성을 검사합니다. 이 단계를 수행하면 매니페스트의 형식이 올바르게 지정되고 추가 처리에 사용할 준비가 됩니다.
  3. 워크로드 등록: 구문 분석이 성공하면 워크로드가 Fabric에 등록됩니다. 워크로드 ID와 같은 필수 구성 세부 정보는 Fabric 데이터베이스에 저장되어 효과적인 워크로드 관리를 지원합니다.

워크로드 매니페스트 - 주요 매니페스트 구성 요소

WorkloadDefinition.xsd에 의해 구조가 정의되는 매니페스트는 이름, 애플리케이션 및 엔드포인트와 같은 워크로드의 핵심 특성을 간략하게 설명합니다.

SchemaVersion 특성

Fabric의 WorkloadDefinition.xsd 게시된 버전을 나타냅니다.

WorkloadName 특성

워크로드의 고유 식별자. 'Org' 접두사를 workloadName에 대해 사용해야 합니다. 그러면 이름은 '.' 구분 기호를 포함한 두 단어로 구성됩니다(예: 'Org.MyWorkload'). 다른 접두사는 유효하지 않으며 이 경우 업로드 오류가 발생합니다. 개발 연결, 테스트 업로드와 같은 시나리오에 적용됩니다.

Version 요소

매니페스트의 버전은 SemVer을 준수해야 합니다.

CloudServiceConfiguration 요소

워크로드의 서비스 구성으로 현재 하나의 구성만 지원됩니다.

Microsoft Entra ID[AAD(Azure Active Directory)] 애플리케이션 구성

<AADApp> 섹션에서는 인증 및 권한 부여 프로세스를 위해 Microsoft Entra ID[AAD(Azure Active Directory)] 애플리케이션을 설정합니다. AppId 는애플리케이션의 고유 식별자를 나타내고, RedirectUri는 Microsoft Entra ID가 인증 응답을 보낼 URI를 지정하며, ResourceId는 애플리케이션이 액세스하는 리소스의 고유 식별자를 가리킵니다. ResourceId, AppId, RedirectUri의 의미에 대한 자세한 컨텍스트는 인증 설명서를 참조할 수 있습니다.

<AADApp>
    <AppId>YourApplicationId</AppId>
    <RedirectUri>YourRedirectUri</RedirectUri>
    <ResourceId>YourResourceId</ResourceId>
</AADApp>

인증 프로세스의 컨텍스트에서 AppId, ResourceId, RedirectUri의 심층적인 이해와 그 중요성에 대한 자세한 내용은 인증 설명서를 참조하세요.

ServiceEndpoint 요소

특정 논리적 엔드포인트의 구성(예: 항목 CRUD 및 작업 API에 대한 구현을 포함하는 백 엔드 엔드포인트)을 나타냅니다.

  • 워크로드의 백 엔드 엔드포인트에 대한 구성에는 워크로드의 백 엔드 URL이 언급됩니다.
<ServiceEndpoint>
    <Name>Workload</Name>
    <Url>YourWorkloadBackendUrl</Url>
    <IsEndpointResolutionService>...
    <EndpointResolutionContext>...
</ServiceEndpoint>
  • <IsEndpointResolutionService> 및 EndpointResolutionContext는 엔드포인트가 워크로드 API를 구현하는지 아니면 엔드포인트 확인만 구현하는지에 따라 설정됩니다. 확인 컨텍스트 및 응답에 대한 자세한 내용은 엔드포인트 확인을 참조하세요.

참고 항목

프런트 엔드에 대한 엔드포인트 확인은 지원되지 않습니다.

항목 매니페스트 - 주요 매니페스트 구성 요소

ItemDefinition.xsd에서 구조가 정의되는 매니페스트는 이름 및 작업 정의와 같은 워크로드 항목의 핵심 특성을 간략하게 설명합니다.

SchemaVersion 특성

Fabric의 ItemDefinition.xsd 게시된 버전을 나타냅니다.

TypeName 특성

항목의 고유 식별자.

작업 스케줄러 구성

<JobScheduler> 섹션에는 작업 예약, 추적 및 관리의 동작 및 설정을 정의하는 다양한 요소가 포함됩니다.

  • <OnDemandJobDeduplicateOptions> 및 <ScheduledJobDeduplicateOptions>: 주문형 및 예약된 항목 작업에 대한 중복 제거 옵션을 각각 정의합니다. 옵션에는 None(중복 제거 없음), PerItem(동일한 항목 및 작업 유형에 대해 하나의 작업 실행), PerUser(동일한 사용자 및 항목에 대해 하나의 작업 실행)가 포함됩니다.
  • <ItemJobTypes>: 여러 항목 작업 유형에 대한 구성을 포함합니다.
  • <ItemJobType>: 특정 작업 유형을 설명합니다.
  • <Name>: 작업 유형의 이름. 항목의 이름을 접두사로 사용해야 합니다.

예를 들어 <ItemJobTypes> 섹션 내에 정의된 세 가지 특정 작업을 포함하는 샘플 워크로드를 살펴봅니다.

<JobScheduler>
    <OnDemandJobDeduplicateOptions>PerItem</OnDemandJobDeduplicateOptions>
    <ScheduledJobDeduplicateOptions>PerItem</ScheduledJobDeduplicateOptions>
    <ItemJobTypes>
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.ScheduledJob" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsText" />
    <ItemJobType Name="Org.WorkloadSample.SampleWorkloadItem.CalculateAsParquet" />
    </ItemJobTypes>
</JobScheduler>
  • CalculateAsText 작업: 이 작업 유형은 텍스트 기반 계산을 처리합니다. 이때 Operand1 및 Operand2를 사용하고 선택한 작업을 수행하며 레이크하우스에 결과를 저장합니다.
  • CalculateAsParquet 작업: 특히 Parquet 데이터 작업에 맞게 조정된 이 작업 유형은 Parquet 데이터 형식에 따라 Operand1 및 Operand2를 사용하고 선택한 작업을 수행하며 레이크하우스에 결과를 저장합니다. 작업 및 관련 구성에 대한 자세한 내용은 모니터링 허브 가이드를 참조하세요.

요약하면 워크로드 및 항목 매니페스트는 Fabric에 사용자 지정 워크로드를 추가하기 위한 기본 문서 역할을 합니다. 인증 프로세스는 업로드, 구문 분석 및 등록과 같은 간단한 작업 시퀀스를 트리거하여 Azure 에코시스템 내에서 적절한 구성 및 효율적인 워크로드 관리를 보장합니다.