Microsoft Fabric의 API for GraphQL에서 Git 통합 및 배포 파이프라인이 작동하는 방법을 알아봅니다. 이 문서는 리포지토리에 대한 연결을 설정하고, GraphQL용 API를 관리하고, 다양한 환경에 배포하는 방법을 이해하는 데 도움이 됩니다.
비고
GraphQL 원본 제어 및 배포용 API는 현재 미리 보기로 제공됩니다.
필수 조건
- Fabric에서 GraphQL에 대한 API가 있어야 합니다. 자세한 내용은 Fabric에서 GraphQL용 API 만들기 및 데이터추가를 참조하세요.
개요
패브릭은 CI/CD(지속적인 통합 및 지속적인 배포) 및 두 가지 주요 구성 요소인 Git 통합 (CI) 및 CD( 배포 파이프라인 )를 통한 개발 수명 주기 관리를 위한 강력한 도구를 제공합니다. 작업 영역은 Git 동기화 및 배포 단계 모두에 대한 중앙 구성 요소 역할을 합니다.
Git 통합(CI): 작업 영역 항목(예: 코드, 구성, API)을 버전 제어 리포지토리와 동기화하여 Git을 통해 버전 제어 및 변경 내용 추적을 사용하도록 설정합니다.
CD(배포 파이프라인) : 연결된 작업 영역을 사용하여 단계(예: 개발, 테스트, 프로덕션)를 만들 수 있습니다. 각 단계에서 지원되는 항목은 후속 단계로 자동으로 복제되고, 작업 공간에서의 변경 사항은 릴리스 파이프라인에서 배포를 트리거합니다. 파이프라인을 구성하여 환경 간에 변경 내용이 테스트되고 효율적으로 배포되도록 할 수 있습니다.
Fabric은 일반적인 시나리오에 맞게 조정된 다양한 CI/CD 워크플로를 지원합니다. 자세한 내용은 Fabric의 CI/CD 워크플로 옵션을 참조하세요.
비고
배포하는 동안 메타데이터만 복사됩니다. 데이터가 복사되지 않습니다.
작업 영역의 항목은 연결된 Git 리포지토리에 IaC(Infrastructure as Code)로 저장됩니다. 리포지토리의 코드 변경은 파이프라인에서 배포를 트리거할 수 있습니다. 이 방법을 사용하면 테스트 및 프로덕션 릴리스를 위해 여러 단계에서 코드 변경 내용을 자동으로 복제할 수 있습니다.
데이터 원본 인증 방법
이 섹션에서는 데이터 원본을 GraphQL용 API에 연결하고 GraphQL용 API와 개발 파이프라인의 연결된 데이터 원본 간의 자동 바인딩에 미치는 영향을 이해하는 인증 방법에 대해 알아봅니다. 배포 파이프라인 프로세스의 자동 바인딩에 대해 자세히 알아볼 수 있습니다.
데이터 원본을 GraphQL용 API에 연결하는 데 사용할 수 있는 두 가지 옵션이 있습니다.
SSO(Single Sign-On 인증)를 사용하여 Fabric 데이터 원본에 연결
저장된 자격 증명을 사용하여 Fabric OR 외부 데이터 원본에 연결
첫 번째 옵션인 SSO(Single Sign-On)를 사용하면 Fabric 내의 데이터 원본에 연결할 수 있습니다. 이 경우 원래 작업 영역(예: 개발 단계)에서 Single Sign-On 메서드를 사용하여 데이터 원본을 GraphQL에 연결하면 데이터 원본 및 GraphQL 항목이 파이프라인의 대상 작업 영역(예: 테스트 단계)에 배포되고 대상 작업 영역의 GraphQL은 대상 작업 영역에서 배포된 로컬 데이터 원본에 자동으로 연결됩니다(아래 다이어그램 참조). SSO를 사용하고 SQL Analytics 엔드포인트를 통해 데이터 원본에 연결하는 경우 특정 제한 사항이 있습니다. 자세한 내용은
두 번째 옵션인 저장된 자격 증명을 사용하면 패브릭 외부의 외부 데이터 원본 및 패브릭 내의 데이터 원본에 연결할 수 있습니다. 그러나 저장된 자격 증명 접근 방식에는 자동 바인딩 이 지원되지 않습니다. 즉, 원래 작업 영역(개발 단계)에서 저장된 자격 증명을 사용하여 데이터 원본을 GraphQL에 연결하면 데이터 원본이 파이프라인의 대상 작업 영역(테스트 단계)에 배포됩니다. 그러나 대상 작업 영역의 GraphQL 항목은 대상 작업 영역의 로컬 데이터 원본에 자동 바인딩하는 대신 저장된 자격 증명을 통해 원래 작업 영역(개발 단계)의 데이터 원본에 연결된 상태로 유지됩니다. (아래 다이어그램 참조)
또한 저장된 자격 증명 메서드를 사용하여 데이터 원본에 연결하는 경우 개발자는 GraphQL 항목을 성공적으로 배포하려면 저장된 자격 증명 정보에 액세스할 수 있어야 합니다.
비고
원래 작업 영역(개발 단계)의 GraphQL용 API가 다른 작업 영역에 있는 데이터 원본에 연결된 경우 대상 작업 영역(테스트 단계)에 배포된 API는 데이터 원본을 GraphQL용 API에 연결하는 데 사용되는 인증 방법에 관계없이 다른 작업 영역에 있는 데이터 원본에 계속 연결됩니다. (아래 다이어그램 참조)
GraphQL Git 통합을 위한 API
GraphQL용 패브릭 API는 소스 제어를 위한 Git 통합을 제공합니다. Git 통합을 사용하면 GraphQL용 API를 백업 및 버전 지정하고, 필요에 따라 이전 단계로 되돌리고, Git 분기를 사용하여 단독으로 공동 작업하거나 작업하며, 완전히 패브릭 내에서 GraphQL 수명 주기에 대한 API를 관리할 수 있습니다.
연결 설정:
작업 영역 설정에서 리포지토리에 대한 연결을 쉽게 설정하여 변경 내용을 커밋하고 동기화할 수 있습니다. 연결을 설정하려면 Git 통합 시작을 참조하세요. 연결되면 GraphQL용 API를 비롯한 항목이 소스 제어 판에 표시됩니다.
GraphQL 인스턴스에 대한 API를 Git 리포지토리에 성공적으로 커밋하면 리포지토리에 GraphQL 폴더 구조가 표시됩니다. 이제 끌어오기 요청 만들기와 같은 향후 작업을 실행할 수 있습니다.
Git의 GraphQL 표현:
다음 이미지는 Git 리포지토리의 GraphQL 항목에 대한 각 API의 파일 구조 예제입니다.
GraphQL용 API 항목을 Git 리포지토리에 커밋하면 GraphQL용 API 정의가 저장됩니다. 이 방법은 패브릭 작업 영역으로 다시 동기화할 때 정확한 복구를 지원합니다.
GraphQL API 정의 형식, 구문 및 예제에 대한 자세한 내용은 패브릭 컨트롤 플레인 API 설명서에서 확인할 수 있습니다.
배포 파이프라인의 GraphQL용 API
다음 단계를 사용하여 배포 파이프라인을 사용하여 GraphQL용 API 배포를 완료합니다.
새 배포 파이프라인을 만들거나 기존 배포 파이프라인을 엽니다. 자세한 내용은 배포 파이프라인 시작을 참조하세요.
배포 목표에 따라 여러 단계에 작업 영역을 할당합니다.
다음 예제와 같이 GraphQL용 API를 포함한 항목을 여러 단계 간에 선택하고 보고 비교합니다. 이전 단계와 현재 단계 사이의 변경된 항목 수를 나타내는 강조 표시된 영역입니다.
- 배포해야 하는 항목을 선택합니다. 배포를 선택하여 개발, 테스트 및 프로덕션 단계에서 선택한 항목(GraphQL 및 연결된 데이터 원본에 대한 API)을 배포합니다.
다음 메시지는 배포하려는 항목을 확인하는 팝업입니다. 배포를 선택하여 배포 프로세스를 확인하고 계속합니다.
현재 제한 사항
패브릭 CI/CD는 자식 항목의 자동 바인딩을 지원하지 않습니다. 즉, GraphQL용 API가 원래 작업 영역(예: 개발 단계)에서 데이터 원본의 자식으로 SQL Analytics 엔드포인트에 연결하는 경우 계보가 대상 작업 영역(예: 테스트 단계)으로 전송되지 않습니다. 따라서 대상 작업 영역(예: 테스트 단계)에서 배포된 GraphQL용 API는 원래 작업 영역(예: 개발 단계)의 SQL Analytics 엔드포인트에 계속 연결됩니다.
데이터 원본 연결에 저장된 자격 증명 방법을 사용하는 경우에는 자동 바인딩이 지원되지 않습니다. 자세한 내용은 위에서 설명한 데이터 원본 인증 방법 섹션을 참조하세요.