Fabric API를 사용하여 배포 파이프라인 자동화
Microsoft Fabric 배포 파이프라인 도구를 사용하여 팀은 Fabric 콘텐츠에 대해 효율적이고 재사용이 가능한 릴리스 프로세스를 빌드할 수 있습니다.
Important
이 기능은 프리뷰로 제공됩니다.
배포 파이프라인 Fabric REST API를 사용하여 조직의 자동화 프로세스에 통합할 수 있습니다. API를 사용하여 수행할 수 있는 작업에 대한 몇 가지 예는 다음과 같습니다.
Azure DevOps 또는 GitHub Actions와 같은 익숙한 DevOps 도구에 Fabric을 통합합니다.
특정 시간에 자동으로 수행되도록 파이프라인 배포를 예약합니다.
동시에 여러 파이프라인을 배포합니다.
파이프라인 배포에 따라 계단식으로 진행합니다. 파이프라인 간에 연결된 콘텐츠가 있는 경우 일부 파이프라인이 다른 파이프라인보다 먼저 배포되도록 할 수 있습니다.
필수 조건
배포 파이프라인 API를 사용하려면 다음 필수 구성 요소가 필요합니다.
- 배포 파이프라인을 사용하는 데 필요한 것과 동일한 필수 구성 요소입니다.
- Fabric 서비스에 대한 Microsoft Entra 토큰. API 호출의 인증 헤더에서 해당 토큰을 사용합니다. 토큰을 가져오는 방법에 대한 자세한 내용은 Fabric API 빠른 시작을 참조하세요.
PowerShell 없이 REST API를 사용할 수 있지만 이 문서의 스크립트에서는 PowerShell을 사용합니다. 스크립트를 실행하려면 다음 프로그램을 설치해야 합니다.
배포 파이프라인 API 함수
배포 파이프라인 Fabric REST API를 사용하여 다음 함수를 수행할 수 있습니다.
배포 파이프라인 가져오기: 지정된 배포 파이프라인에 대한 정보를 반환합니다.
배포 파이프라인 나열: 사용자가 액세스할 수 있는 배포 파이프라인 목록을 반환합니다.
배포 파이프라인 단계 나열: ID, 표시 이름, 설명 및 스테이지가 공용인지 여부를 포함하여 지정된 배포의 단계를 반환합니다.
배포 파이프라인 단계 항목 나열: 지정된 배포 파이프라인의 지정된 단계에 할당된 작업 영역에서 지원되는 항목을 반환합니다.
스테이지 콘텐츠 배포: 지정된 배포 파이프라인의 지정된 단계에서 항목을 배포합니다.
이 API를 사용하여 모든 항목을 배포하거나 배포할 특정 항목을 선택합니다. 특정 항목을 선택하지 않으면 모든 항목이 배포됩니다.
배포할 관련 단계 ID를 찾으려면 배포 파이프라인 단계 목록 API를 사용합니다.
이 API는 장기 실행 작업 API와 통합되어 배포 상태를 모니터링합니다.
- 작업 상태를 가져와서 장기 실행- 가져오기 작업 상태 API로 작업이 완료되었는지 확인합니다.
- 배포가 완료된 후 24시간 동안 확장된 배포 정보는 작업 결과 가져오기 API에서 사용할 수 있습니다.
다른 Fabric REST API 호출을 사용하여 관련 작업을 완료할 수도 있습니다.
PowerShell 예제
다음 PowerShell 스크립트를 사용하여 여러 자동화 프로세스를 수행하는 방법을 이해할 수 있습니다. PowerShell 샘플의 텍스트를 보거나 복사하려면 이 섹션의 링크를 사용합니다.
-
다음 정보를 제공합니다.
- 파이프라인 이름
- 원본 스테이지 이름
- 대상 스테이지 이름
- 배포 정보(선택 사항)
-
다음 정보를 제공합니다.
- 파이프라인 이름
- 원본 스테이지 이름
- 대상 스테이지 이름
- 배포할 항목(항목 표시 이름 및 항목 유형)
- 배포 정보(선택 사항)
고려 사항 및 제한 사항
배포 파이프라인 API를 사용하는 경우 다음 제한 사항을 고려합니다.
배포 파이프라인에 적용되는 모든 제한 사항은 API를 사용하는 경우 적용됩니다. 자세한 내용은 배포 파이프라인 모범 사례를 참조하세요.
데이터 흐름은 현재 지원되지 않습니다. 데이터 흐름을 사용하는 고객은 Power BI API를 사용할 수 있습니다.
서비스 주체는 Power BI 항목에 대해서만 지원됩니다.
Power BI API에서 사용할 수 있는 모든 배포 옵션은 Fabric에서 사용할 수 없습니다. Fabric의 배포 준비된 콘텐츠 API에서는 다음 API를 사용할 수 없습니다.
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
이러한 API 중 하나가 필요한 경우 Power BI API를 사용하여 배포합니다. 그러나 이러한 API는 Power BI 항목에 대해서만 작동합니다.