Udostępnij za pośrednictwem

Automatyzowanie potoku wdrażania przy użyciu interfejsów API sieci szkieletowej

  • Artykuł

Narzędzie potoków wdrażania usługi Microsoft Fabric umożliwia zespołom tworzenie wydajnego i wielokrotnego użytku procesu wydawania zawartości sieci Szkieletowej.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

Użyj interfejsów API REST usługi Fabric potoków wdrażania, aby zintegrować sieć szkieletową z procesem automatyzacji organizacji. Oto kilka przykładów tego, co można zrobić przy użyciu interfejsów API:

  • Zintegruj sieć szkieletową z znanymi narzędziami DevOps, takimi jak Azure DevOps lub GitHub Actions.

  • Zaplanuj automatyczne wdrożenia potoków w określonym czasie.

  • Wdróż wiele potoków w tym samym czasie.

  • Kaskada w zależności od wdrożeń potoków. Jeśli masz zawartość połączoną między potokami, możesz upewnić się, że niektóre potoki są wdrażane przed innymi.

Wymagania wstępne

Do pracy z interfejsami API potoku wdrażania potrzebne są następujące wymagania wstępne:

  • Te same wymagania wstępne, które należy użyć potoków wdrażania.
  • Token entra firmy Microsoft dla usługi Fabric. Użyj tego tokenu w nagłówku autoryzacji wywołania interfejsu API. Aby uzyskać informacje o sposobie uzyskiwania tokenu, zobacz Przewodnik Szybki start dotyczący interfejsu API sieci szkieletowej.

Interfejsy API REST można używać bez programu PowerShell, ale skrypty w tym artykule używają programu PowerShell. Aby uruchomić skrypty, należy zainstalować następujące programy:

Funkcje interfejsu API potoków wdrażania

Interfejsy API REST potoków wdrażania sieci szkieletowej umożliwiają wykonywanie następujących funkcji:

  • Pobieranie potoku wdrażania: zwraca informacje o określonym potoku wdrażania.

  • Potoki wdrażania listy: zwraca listę potoków wdrażania, do których użytkownik ma dostęp.

  • Pobieranie etapów potoku wdrażania: zwraca etapy określonego wdrożenia, w tym jego identyfikatora, nazwy wyświetlanej, opisu i tego, czy etap jest publiczny, czy nie.

  • Pobieranie elementów etapu potoku wdrażania: zwraca obsługiwane elementy z obszaru roboczego przypisanego do określonego etapu określonego potoku wdrażania.

  • Wdrażanie zawartości etapu: wdraża elementy z określonego etapu określonego potoku wdrażania.

    • Użyj tego interfejsu API, aby wdrożyć wszystkie elementy lub wybrać określone elementy do wdrożenia. Jeśli nie wybrano żadnych określonych elementów, zostaną wdrożone wszystkie elementy.

    • Aby znaleźć odpowiedni identyfikator etapu do wdrożenia, użyj interfejsu API Pobierz etapy potoku wdrażania.

    • Ten interfejs API jest zintegrowany z interfejsami API operacji długotrwałych w celu monitorowania stanu wdrożenia.

Do wykonania powiązanych operacji można również użyć innych wywołań interfejsu API REST usługi Fabric.

Przykłady programu PowerShell

Poniższe skrypty programu PowerShell umożliwiają zrozumienie sposobu wykonywania kilku procesów automatyzacji. Aby wyświetlić lub skopiować tekst w przykładzie programu PowerShell, użyj linków w tej sekcji.

  • Wdróż wszystko

    Podaj poniższe informacje:

    • Nazwa potoku
    • Nazwa etapu źródłowego
    • Nazwa etapu docelowego
    • Uwagi dotyczące wdrażania (opcjonalnie)

  • Selektywne wdrażanie

    Podaj poniższe informacje:

    • Nazwa potoku
    • Nazwa etapu źródłowego
    • Nazwa etapu docelowego
    • Elementy do wdrożenia (nazwa wyświetlana elementów i typ elementu)
    • Uwagi dotyczące wdrażania (opcjonalnie)

Rozważania i ograniczenia

W przypadku korzystania z interfejsów API potoków wdrażania należy wziąć pod uwagę następujące ograniczenia:

  • Wszystkie ograniczenia, które mają zastosowanie do potoku wdrażania, mają zastosowanie podczas korzystania z interfejsów API. Aby uzyskać więcej informacji, zobacz Najlepsze rozwiązania dotyczące potoków wdrażania.

  • Przepływy danych nie są obecnie obsługiwane. Klienci korzystający z przepływów danych mogą korzystać z interfejs API usługi Power BI.

  • Jednostki usługi są obsługiwane tylko w przypadku elementów usługi Power BI.

  • Nie wszystkie opcje wdrażania dostępne w interfejs API usługi Power BI są dostępne w sieci szkieletowej. Następujące interfejsy API nie są dostępne w interfejsie API wdrażania etapu sieci szkieletowej:

    • allowPurgeData
    • allowTakeOver
    • allowSkipTilesWithMissingPrerequisites

    Jeśli potrzebujesz jednego z tych interfejsów API, użyj interfejs API usługi Power BI do wdrożenia. Jednak te interfejsy API działają tylko dla elementów usługi Power BI.

Powiązana zawartość