Automatisieren Ihrer Bereitstellungspipeline mit Fabric APIs
Mit dem Microsoft Fabric-Tool für Bereitstellungspipelines können Teams einen effizienten und wiederverwendbaren Releaseprozess für ihre Fabric-Inhalte erstellen.
Wichtig
Dieses Feature befindet sich in der Vorschauphase.
Verwenden Sie die Fabric-REST-APIs für Bereitstellungspipelines, um Fabric in den Automatisierungsprozess Ihrer Organisation zu integrieren. Im Folgenden finden Sie einige Beispiele dafür, was mithilfe der API möglich ist:
Integrieren Sie Fabric in vertraute DevOps-Tools wie Azure DevOps oder GitHub Actions.
Planen Sie Pipelinebereitstellungen so, dass sie zu einem bestimmten Zeitpunkt automatisch erfolgen.
Stellen Sie mehrere Pipelines gleichzeitig bereit.
Kaskadieren Sie abhängig von Pipelinebereitstellungen. Wenn Sie über Inhalte verfügen, die pipelineübergreifend verbunden sind, können Sie sicherstellen, dass einige Pipelines vor anderen bereitgestellt werden.
Voraussetzungen
Um mit Bereitstellungspipeline-APIs zu arbeiten, benötigen Sie die folgenden Voraussetzungen:
- Die gleichen Voraussetzungen, die Sie für die Verwendung von Bereitstellungspipelines benötigen.
- Ein Microsoft Entra-Token zur Nutzung von Fabric. Verwenden Sie dieses Token im Autorisierungsheader des API-Aufrufs. Informationen zum Abrufen eines Tokens finden Sie im Fabric-API-Schnellstarter.
Sie können die REST-API ohne PowerShell verwenden; die Skripts in diesem Artikel nutzen aber PowerShell. Um die Skripts ausführen zu können, müssen Sie die folgenden Programme installieren:
API-Funktionen für Bereitstellungspipelines
Die Fabric-REST-APIs für Bereitstellungspipelines machen die folgenden Funktionen möglich:
Bereitstellungspipeline abrufen: Gibt Informationen zur angegebenen Bereitstellungspipeline zurück.
Bereitstellungspipelines auflisten: Gibt eine Liste der Bereitstellungspipelines zurück, auf die der Benutzer Zugriff hat.
Phasen der Listenbereitstellungspipeline: Gibt die Phasen der angegebenen Bereitstellung zurück, einschließlich ihrer ID, Anzeigename, Beschreibung und ob die Phase öffentlich ist oder nicht.
Elemente der Listenbereitstellungspipeline: Gibt die unterstützten Elemente aus dem Arbeitsbereich zurück, welcher der angegebenen Phase der angegebenen Bereitstellungspipeline zugewiesen sind.
Phaseninhalt bereitstellen: Stellt Elemente aus der angegebenen Phase der angegebenen Bereitstellungspipeline bereit.
Verwenden Sie diese API, um alle Elemente bereitzustellen oder um bestimmte Elemente für die Bereitstellung auszuwählen. Wenn keine bestimmten Elemente ausgewählt sind, werden alle Elemente bereitgestellt.
Verwenden Sie die Phasen der Listenbereitstellungspipeline-API, um die entsprechende Phasen-ID für die Bereitstellung zu finden.
Diese API ist in die APIs für lange ausgeführte Vorgänge integriert, um den Bereitstellungsstatus zu überwachen.
- Rufen Sie den Vorgangsstatus ab, um festzustellen, ob der Vorgang mit der API Get Long Running – Get Operation State abgeschlossen ist.
- 24 Stunden nach Abschluss der Bereitstellung sind die erweiterten Bereitstellungsinformationen in der Get Operation Result-API verfügbar.
Sie können auch andere Fabric REST-API-Aufrufe verwenden, um verwandte Vorgänge auszuführen.
PowerShell-Beispiele
Die folgenden PowerShell-Skripts verdeutlichen, wie mehrere Automatisierungsprozesse ausgeführt werden. Verwenden Sie die Links in diesem Abschnitt, um den Text in einem PowerShell-Beispiel anzuzeigen oder zu kopieren.
-
Geben Sie die folgenden Informationen ein:
- Name der Pipeline
- Quellen-Stagename
- Name der Zielstage
- Bereitstellungsnotizen (optional)
-
Geben Sie die folgenden Informationen ein:
- Name der Pipeline
- Quellen-Stagename
- Name der Zielstage
- Bereitzustellende Elemente (Anzeigename und Elementtyp der Elemente)
- Bereitstellungsnotizen (optional)
Überlegungen und Einschränkungen
Bei der Verwendung der Bereitstellungspipeline-APIs sind die folgenden Einschränkungen zu beachten:
Alle Einschränkungen, die für die Bereitstellungspipeline gelten, gelten bei Verwendung der APIs. Weitere Informationen finden Sie unter Bewährte Methoden für Bereitstellungspipelines.
Dataflows werden derzeit nicht unterstützt. Kunden, die Dataflows verwenden, können die Power BI-APIs verwenden.
Dienstprinzipale werden nur für Power-BI-Elemente unterstützt.
Nicht alle Bereitstellungsoptionen, die in den Power BI-APIs verfügbar sind, sind in Fabric verfügbar. Die folgenden APIs sind in der Bereitstellungsphase-Inhalts-API von Fabric nicht verfügbar:
- allowPurgeData
- allowTakeOver
- allowSkipTilesWithMissingPrerequisites
Wenn Sie eine dieser APIs benötigen, verwenden Sie die Power BI-API zum Bereitstellen. Diese APIs funktionieren jedoch nur für Power BI-Elemente.