Was ist ein Bereitstellungsplan in Microsoft Fabric? (Vorschau)

Ein Microsoft Fabric-Bereitstellungsplan ist ein Arbeitsbereichselement, das einem Bereitstellungsvorgang eine explizite Elementreihenfolge und automatisierte Aktionen hinzufügt. Verwenden Sie einen Plan, um Gegenstände in einer bestimmten Reihenfolge aufzustellen. Sie können es auch verwenden, um ein Notebook, eine Datenpipeline oder ein anderes unterstütztes Element vor oder nach der Bereitstellung eines Elements auszuführen.

Ein Bereitstellungsplan funktioniert mit diesen Bereitstellungstools:

  • Git-Integration
  • Bereitstellungspipelines
  • Unterstützte REST-APIs

In diesem Artikel bezieht sich Bereitstellungswerkzeug auf eines dieser unterstützten Werkzeuge. Man führt keinen Plan allein durch. Du befestigst es, wenn du eine Operation mit einem Deployment-Tool startest.

Important

Dieses Feature befindet sich in der Vorschauphase.

Wann man einen Deployment-Plan verwenden sollte

Verwenden Sie einen Einsatzplan, wenn:

Scenario Wie ein Plan hilft
Gegenstände müssen in einer Reihenfolge eingesetzt werden, die die Fabric-Linie nicht repräsentiert. Der Plan definiert explizite Abhängigkeiten zwischen Deployment-Gruppen.
Die Arbeit muss vor oder nach dem Einsatz eines Gegenstands ablaufen. Der Plan führt unterstützte Elemente als Aktionen vor oder nach der Bereitstellung aus.
Die Operation benötigt sowohl explizite Reihenfolge als auch Fabric-Artikelabhängigkeiten. Fabric kombiniert den Plan mit der Abstammung, wenn es die Artikelreihenfolge bestimmt.

Du brauchst keinen Deployment-Plan, wenn die Standardreihenfolge des Deployment-Tools ausreichend ist und keine Maßnahmen erforderlich sind.

Komponenten des Einsatzplans

Ein Bereitstellungsplan enthält folgende Komponenten:

Bestandteil Purpose
Bereitstellungsgruppe Ein Element zur Bereitstellung und dessen Aktionen vor oder nach der Bereitstellung.
Step Setzt den Gegenstand in einer Einsatzgruppe ein.
Action Ein Durchlauf eines unterstützten Gegenstands vor oder nach dem Einsatz des Gruppengegenstands.

Informationen zu unterstützten Aktionsarten und zum Verhalten von Aktionen finden Sie unter Aktionen des Bereitstellungsplans.

Wie ein Bereitstellungsplan funktioniert

Jede Bereitstellungsoperation kombiniert drei Eingaben:

  • Ausgewählte Gegenstände: Die für die Operation ausgewählten Gegenstände.
  • Einsatzplan: Die explizite Reihenfolge und Aktionen, die mit diesen Elementen verbunden sind.
  • Fabric Lineage: Die Abhängigkeiten, die Fabric zwischen den Artikeln erkennt.

Diagramm, das ausgewählte Artikel, einen Bereitstellungsplan und die Fabric-Linie zeigt, die kombiniert werden, um die Artikelreihenfolge und Aktionen für einen Zielarbeitsbereich zu bestimmen.

Bestimmung des Einsatzumfangs

Das Einsatzwerkzeug bestimmt Quelle, Ziel und Gegenstände im Einsatz. Einen Plan anzuhängen ersetzt diese Auswahl nicht. Ausgewählte Elemente, die keiner Bereitstellungsgruppe angehören, werden dennoch gemäß dem Standardverhalten des Tools bereitgestellt.

Das Anhängen eines Plans wählt nicht automatisch die Elemente aus, auf die er Bezug nimmt. Wählen Sie auf einer selektiven Bereitstellungsfläche die Items aus, die Sie einsetzen möchten, und stellen Sie sicher, dass die für die Planaktionen benötigten Items im Zielarbeitsbereich verfügbar sind, wenn diese Aktionen ausgeführt werden.

Ein Deployment-Plan steuert die Verteilung und Aktionen der Items. Es bereitet keine Workspace-Konfigurationen wie Workspace-Identitäten, Verbindungen, Gateway-Bindings oder Spark-Einstellungen bereit. Die Konfiguration des Zielarbeitsbereichs vor einer Aktion hängt von diesen Einstellungen ab.

Bereitstellungsreihenfolge beheben

Fabric kombiniert explizite Abhängigkeiten zwischen Deployment-Gruppen mit Abhängigkeiten, die aus der Abstammung erkannt werden. Ein Plan kann eine Reihenfolge hinzufügen, die Linie nicht repräsentiert, aber er entfernt keine Abhängigkeiten, die Fabric erkennt.

Für ein detailliertes Szenario, das zeigt, wie die ausgewählten Elemente, Planabhängigkeiten, Abstammung und Laufzeitaktionen zusammenwirken, siehe Beispiele für Bereitstellungspläne.

Ausführen von Deployment-Gruppen und Aktionen

Für jede Bereitstellungsgruppe führt Fabric die Aktionen vor der Bereitstellung aus, stellt das Element der Gruppe bereit und führt dann die Aktionen nach der Bereitstellung aus. Abhängigkeiten zwischen Gruppen und Aktionen bestimmen deren Reihenfolge. Die Position eines Gegenstands in der Planakte definiert nicht seine Reihenfolge.

Einen Plan anzuhängen ist optional. Ohne Plan verwendet das ausgewählte Einsatzwerkzeug sein Standardverhalten.

Fügen Sie einen Einsatzplan hinzu

Sie können einen Plan anhängen, wenn Sie eine unterstützte Git-Integration verwenden, Inhalte über eine Deployment-Pipeline bereitstellen oder eine unterstützte REST-API aufrufen. Der Anhang gilt nur für diese Operation. Für die unterstützten Oberflächen und das Verhalten bei der Planauswahl siehe Bereitstellungsplan anfügen.

Erstellen und versionieren Sie einen Bereitstellungsplan

Erstellen Sie einen Plan auf der Deployment Plan-Canvas, in dem Sie Deployment-Gruppen hinzufügen, ihre Reihenfolge definieren und Aktionen konfigurieren. Für Anleitungen siehe Erstellen eines Einsatzplans.

Ein Einsatzplan ist ein Arbeitsbereichselement. Wenn der Arbeitsbereich mit Git verbunden ist, committe den Plan mit den Elementen, auf die er verweist, damit der Plan durch deinen CI/CD-Prozess laufen kann.

Wenn eine Operation fehlschlägt

Der Vorgang wird angehalten, wenn ein Element oder eine Aktion fehlschlägt, und bereits abgeschlossene Vorgänge werden nicht rückgängig gemacht. Für Fehlerverhalten und Lösungsschritte siehe Troubleshoot deployment plans.

Überlegungen und Einschränkungen

Allgemeine Einschränkungen des Einsatzplans

  • Du kannst nicht mit einem Plan in mehr als einem Arbeitsbereich in einem einzigen Durchlauf deployen.
  • Du kannst nur einen Deployment-Plan an eine Deployment-Operation anhängen.

Einschränkungen für das Anhängen eines Plans

  • Ein Plananhang gilt nur für den aktuellen Betrieb. Du kannst keinen Plan als Standard für zukünftige Einsätze konfigurieren oder den Plan selbst planen. Wenn ein Deployment-Tool einen Vorgang plant, muss der Vorgang den Plan bei jeder Ausführung einbinden.
  • Man kann keinen Plan an eine Importoperation mit nur einem einzelnen Artikel anhängen.
  • Die Bibliothek fabric-cicd unterstützt keine Bereitstellungspläne.

Einschränkungen während eines Einsatzes

  • Man kann keine unabhängigen Deployment-Gruppen parallel bereitstellen.
  • Ein fehlgeschlagener Einsatz wird nicht rückgängig gemacht. Bereits eingesetzte Items bleiben im Ziel-Arbeitsbereich, und spätere Items werden nicht mehr eingesetzt.

Einschränkungen für Planmaßnahmen

  • Nur unterstützte Element- und Jobtyp-Kombinationen können als Vor- oder Nachbereitstellungsaktionen ausgeführt werden. Siehe Gegenstandstypen, die du als Aktion ausführen kannst.
  • Du kannst denselben Dataflow Gen2-Punkt nicht in mehr als einer Aktion eines Plans verwenden. Der Aktualisierungsauftrag kann nicht mehr als einmal zur gleichen Zeit ausgeführt werden. Daher warnt dich der Canvas, wenn du eine zweite Instanz hinzufügst, und die zweite Instanz wird bei der Bereitstellung blockiert.
  • Sie können nicht mehr als 512 KB aus einer Benutzerdatenfunktion zurückgeben. Größere Ausgaben werden abgeschnitten. Die Aktion gelingt trotzdem.
  • Man kann nicht erzwingen, dass eine Aktion wartet, bis die Dienste, die sie versorgt, aufgeholt haben. Eine Aktion wird abgeschlossen, wenn die Aktion selbst endet, sodass die nächste Aktion starten kann, bevor die erzeugten Daten abfragbar sind.
  • Du kannst keinen Deployment-Plan verwenden, um während der Bereitstellung den aktiven Wertesatz einer Variablenbibliothek zu ändern. Variablenreferenzen werden anhand des Wertesatzes aufgelöst, der im Zielarbeitsbereich bereits aktiv ist. In einem neu erstellten Ziel-Arbeitsbereich ist Standard aktiv, bis du einen weiteren Werte-Satz auswählst und speicherst. Weitere Informationen finden Sie unter Variable Library CI/CD.

Einschränkungen beim Erstellen von Plänen

  • Du kannst nicht mehr als einen Gegenstand zu einer Einsatzgruppe hinzufügen.
  • Die Leinwand unterstützt nur automatisches Layout.

Größenbeschränkungen für den Einsatzplan

Ein Plan, der eine dieser Grenzen überschreitet, wird abgelehnt, wenn er gespeichert wird. Die Beschränkungen werden immer dann durchgesetzt, wenn ein Plan gespeichert wird, daher gelten sie sowohl für die Canvas, die REST-API, einen Pull aus Git als auch für externe Tools.

Element Limit
Größe des Plans 1 MB
Länge eines Gruppen- oder Stufennamens 60 Zeichen
Gruppen in einem Plan 1,000
Abhängigkeiten von einer Gruppe 1,000
Aktionen vor dem Einsatz in einer Gruppe 20
Aktionen nach dem Einsatz in einer Gruppe 20
Abhängigkeiten von einer Aktion 20
Parameter einer Aktion 20

Verwandte Inhalte

  • Zuletzt aktualisiert um