Entwicklungsprozess mit Branch Workspace

Ein Branch-Arbeitsbereich ist ein Arbeitsbereich, der mit einem Quellarbeitsbereich verknüpft ist. Damit können Entwickler an Änderungen in einer isolierten Umgebung arbeiten, verstehen, wie sich ihre Arbeit auf andere Arbeitsbereiche bezieht, und Änderungen am Hauptarbeitsbereich mit Vertrauen fördern.

Die Beziehung (Verbindung) zwischen einem Branch-Workspace und seinem Quell-Workspace wird hergestellt, wenn der Benutzer Branch-out durchführt. Für Fabric-Entwickler erzeugt Branch-Out einen neuen Git-Branch aus dem Quell-Workspace-verbundenen Branch. Der Benutzer kann entweder einen neuen Arbeitsbereich erstellen, der mit einem neu erstellten Branch verbunden ist, oder einen bestehenden Arbeitsbereich verwenden, indem er dessen Git-Branch auf den neu erstellten wechselt.

Zweig-Arbeitsbereich

Die Branch-Workspace-Beziehung hat mehrere visuelle Darstellungen in der Fabric-Benutzeroberfläche:

• Arbeitsbereichsbaum: Repräsentiert den Quellarbeitsbereich als Elternteil des Branch-Arbeitsbereichs

  

• Arbeitsbereich-Breadcrumbs: Navigationsoption vom Zweigarbeitsbereich zum Quellarbeitsbereich

  

• Quellcodeverwaltung – Registerkarte "Verwandte Verzweigungen "

  

Verzweigungsvorgang

Wenn ein Branch-out-Vorgang abgeschlossen ist, sind standardmäßig alle Elemente aus dem Quell-Branch im Zielarbeitsbereich enthalten. Dieses Verhalten kann geändert werden, indem beim Einrichten des Branch-Outs Elemente einzeln auswählen gewählt wird, sodass nur ausgewählte Elemente in den Zielarbeitsbereich übernommen werden und Sie schneller mit dem Programmieren beginnen können.

Als Fabric-Entwickler würde der Verzweigungsfluss wie folgt aussehen:

1. Im Bereich Quellcodeverwaltung wählen Sie Verzweigen aus.

   

2. Geben Sie an, ob Sie einen neuen Arbeitsbereich oder eine Verzweigung in einen vorhandenen erstellen möchten. Geben Sie die Namen des neuen Zweigs und Arbeitsbereichs ein oder wählen Sie den bestehenden Arbeitsbereich aus der Dropdown-Liste aus. Wenn du dich entscheidest, in einen neuen Arbeitsbereich zu wechseln, kannst du eventuell das Admin-Profil Use Branch workspace (Vorschau) ein- oder ausschalten

3. Überprüfen Sie die ausgewählten Elemente einzeln , falls Sie nur an einer Teilmenge der Elemente im Branch-Arbeitsbereich arbeiten möchten. Beim Erstellen eines neuen Arbeitsbereichs mit selektiver Verzweigung wird der folgende Screenshot angezeigt.

4. Klicken Sie auf die Schaltfläche „Abzweigen“ (die Schritte 5–9 gelten nur, wenn „Elemente einzeln auswählen“ ausgewählt ist)

5. Mit dieser Aktion wird ein Dialogfeld zum Auswählen von Elementen für Ihren Arbeitsbereich angezeigt.

6. Wählen Sie die gewünschten Elemente für diesen Arbeitsbereich aus.

7. Klicke auf Branch erstellen.

   

8. Wenn Sie eine selektive Verzweigung durchführen, sind alle Abhängigkeiten des Elements erforderlich. Sie können dazu die Schaltfläche "Verwandte Elemente auswählen " verwenden. Wenn Sie keine der Abhängigkeiten auswählen, wird Folgendes angezeigt:

   Note

   Man kann Gegenstände auswählen und mit dem Expandieren beginnen, während Fabric im Hintergrund deren Abhängigkeiten berechnet. Allerdings kann es sein, dass die Operation fehlschlägt, bevor alle zugehörigen Elemente geladen sind.

9. Nachdem die Verzweigung erstellt wurde, können Sie überprüfen, ob Sie sich in einer selektiven Verzweigung befinden, indem Sie das Symbol in der unteren Statusleiste (untere linke Ecke) verwenden. Es heißt selektiver Zweig.

10. Fabric erstellt den neuen Branch-Arbeitsbereich. Sie werden automatisch zum neuen Arbeitsbereich weitergeleitet. Sie enthält alle Elemente oder nur die Elemente, die Sie bei selektiver Verzweigung ausgewählt haben.

Der Arbeitsbereich synchronisiert sich mit deinem Feature-Branch und wird zu einer isolierten Arbeitsumgebung, wie unten dargestellt. Du kannst jetzt in diesem neuen Branch-Arbeitsbereich arbeiten. Die Synchronisierung kann einige Minuten dauern. Weitere Informationen zum Verzweigen finden Sie unter Tipps zur Problembehandlung.

11. Speichern Sie Ihre Änderungen, und übertragen Sie diese in den Feature-Branch.
12. Wenn Sie fertig sind, erstellen Sie einen PR für den Mainbranch. Die Überprüfungs- und Zusammenführungsprozesse werden über den zugehörigen Git-Anbieter durchgeführt, basierend auf der Konfiguration, die Ihr Team für dieses Repository definiert hat.

Nach Abschluss der Überprüfung und Zusammenführung wird ein neuer Commit für den main-Branch erstellt. Bei diesem Commit wird der Benutzer aufgefordert, die Inhalte im Arbeitsbereich des Entwicklerteams mit den zusammengeführten Änderungen zu aktualisieren.

Weitere Informationen finden Sie unter Verzweigungseinschränkungen.

So fügen Sie zusätzliche Elemente mit selektivem Branching zu einem Arbeitsbereich hinzu

Wenn ein Fabric-Entwickler Elemente hinzufügen muss, die während der Abzweigungsoperation nicht ausgewählt wurden, zeigen die folgenden Schritte, wie zusätzliche Elemente dem Arbeitsbereich hinzugefügt werden können:

1. Wechseln Sie zum erforderlichen Fabric-Arbeitsbereich, und wählen Sie oben die Quellcodeverwaltung aus.
2. Wählen Sie auf der rechten Seite das Verzweigungssymbol aus.
3. Verwenden Sie die Dropdownliste, und wählen Sie "Weitere Elemente auswählen" aus.
4. Mit dieser Aktion wird ein Dialogfeld zum Auswählen von Elementen für Ihren Arbeitsbereich angezeigt. Im Dialogfeld "Elemente auswählen" werden nur Elemente aus der Git-Verzweigung angezeigt, die zuvor nicht ausgewählt wurden.
5. Wählen Sie die zusätzlichen Elemente aus, die Sie dem Arbeitsbereich hinzufügen möchten.
6. Klicken Sie auf Hinzufügen. Die ausgewählten Elemente werden den ausstehenden Updates im Quellcodeverwaltungsbereich hinzugefügt.
7. Klicken Sie auf "Alle aktualisieren". Dieser Vorgang führt eine Aktualisierung von Git aus und erstellt die Elemente im Arbeitsbereich.

Wechseln von Branches

Wenn Ihr Arbeitsbereich mit einem Git-Branch verbunden ist und Sie zu einem anderen Branch wechseln möchten, können Sie dies schnell über den Bereich Quellcodeverwaltung tun, ohne dass Sie die Verbindung unterbrechen und erneut herstellen müssen.

Wenn Sie zwischen Branches wechseln, wird der Arbeitsbereich mit dem neuen Branch synchronisiert, und alle Elemente im Arbeitsbereich werden überschrieben. Wenn die beiden Branches unterschiedliche Versionen desselben Elements enthalten, wird das Element ersetzt.

Das Ausführen eines Switch-Branchs beeinflusst nicht die Beziehung (Verbindung) zwischen einem Branch-Arbeitsbereich und seinem Quell-Arbeitsbereich. Der Branch-Wechsel ist eine Git-Zustandsänderung. Das Wechseln von Branches erstellt oder ändert keine Beziehungen im Arbeitsbereich. Wenn ein Arbeitsbereich bereits über eine Beziehung verfügt, wird er beibehalten.

Standardmäßig ist das Wechseln der Git-Verzweigung eines verbundenen Arbeitsbereichs (oder das Auschecken einer neuen Verzweigung) auf Arbeitsbereichsadministratoren beschränkt. Ein Workspace-Admin kann jedoch die Einstellung pro Arbeitsbereich aktivieren, die Benutzern mit mindestens der Rolle Contributor erlaubt, den Git-Branch zu ändern , um Branch-Switch-Funktionen für Mitglieder/Mitwirkende zu ermöglichen. Diese Einstellung ist pro Arbeitsbereich konfiguriert und erfordert eine aktive Git-Verbindung. Die vollständige Berechtigungsmatrix finden Sie unter "Berechtigungen".

Führen Sie die folgenden Schritte aus, um zwischen Branches zu wechseln:

1. Im Bereich „Quellcodeverwaltung“ klicken Sie auf Weitere Optionen (...), und wählen Sie dann Branch wechseln.

   

2. Geben Sie im Dropdownmenü den Branch an, mit dem Sie eine Verbindung herstellen möchten, oder erstellen Sie einen neuen Branch. Dieser Zweig muss dasselbe Verzeichnis wie der aktuelle Zweig enthalten.

3. Setzen Sie ein Häkchen in das Kontrollkästchen bei Ich verstehe, dass Arbeitsbereichselemente möglicherweise gelöscht und nicht wiederhergestellt werden können. und wählen Sie Verzweigung wechseln aus.

   

Sie können den Branch nicht wechseln, wenn sie unbestätigte Änderungen im Arbeitsbereich haben. Wählen Sie Abbrechen aus, um zurückzugehen und Ihre Änderungen zu speichern, bevor Sie den Zweig wechseln.

Um den aktuellen Arbeitsbereich mit einem neuen Branch zu verbinden, während der vorhandene Arbeitsbereichsstatus beibehalten wird, wählen Sie Neuen Branch auschecken aus. Erfahren Sie mehr über das Auschecken eines neuen Branch unter Auflösen von Konflikten in Git.

Erweitern Sie Ihren Bereitstellungsplan

Fügen Sie einen Deployment-Plan hinzu, wenn Items in einer bestimmten Reihenfolge bereitgestellt werden müssen oder wenn Notebooks, Datenpipelines oder andere unterstützte Aktionen während des Branch-Outs ausgeführt werden müssen. Der Deployment-Plan steuert, wie Fabric den verzweigten Arbeitsbereich befüllt; er ändert nichts, wie der Git-Branch oder Arbeitsbereich erstellt wird.

Bevor du beginnst, speichere den Deployment-Plan und committe ihn in den aktuellen Git-Branch mit den Items, auf die er verwiesen ist. Nur in Git verfügbare Einsatzpläne können während des Branch-Outs ausgewählt werden.

Um einen Einsatzplan zu erweitern:

1. Wähle auf der Registerkarte „Branches“ im Bereich „Quellcodeverwaltung“„Branch mit Bereitstellungsplan erstellen“ aus.

   

2. Konfigurieren Sie den neuen Branch und den Zielarbeitsbereich. Wählen Sie Weiteraus.

   

3. Wählen Sie im Branch-Out-Wizard einen Einsatzplan aus. Um das Standardverhalten beim Verzweigen zu verwenden, wählen Sie Kein Bereitstellungsplan.

4. Wenn Sie ausgewählt haben, einzelne Elemente auswählen (Vorschau), wählen Sie die Elemente aus, die im verzweigten Arbeitsbereich aufgenommen werden sollen, einschließlich der Elemente, die für die Aktionen des Plans benötigt werden. Durch das Anhängen des Plans werden diese Elemente nicht automatisch für Sie ausgewählt.

5. Wählen Sie Branch erstellen.

   

Fabric erstellt den Branch und den Arbeitsbereich und verwendet dann beim Füllen des Zielarbeitsbereichs den Bereitstellungsplan. Wie die ausgewählten Elemente, Planbeziehungen, Fabric-Linie und Aktionen die Bereitstellung bestimmen, siehe Wie ein Bereitstellungsplan funktioniert.

Verzweigen ohne Bereitstellungsplan funktioniert wie bisher: Fabric stellt die ausgewählten Elemente mit seiner standardmäßigen Abhängigkeitsbehandlung bereit und führt keine Aktionen vor oder nach der Bereitstellung aus.

Verzweigungseinschränkungen

• Das Administratorprofil für den Branch-Workspace ist als Vorschau verfügbar.
• Zum Verzweigen sind die in der Berechtigungstabelle aufgeführten Berechtigungen erforderlich.
• Für diese Aktion muss eine verfügbare Kapazität vorhanden sein.
• Alle Arbeitsbereichs- und Brachnamensbeschränkungen gelten auch bei Verzweigungen in einen neuen Arbeitsbereich.
• Nur unterstützte Git-Elemente sind im neuen Arbeitsbereich verfügbar.
• In der Liste der zugehörigen Branches werden nur Branches und Arbeitsbereiche angezeigt, die Sie sehen dürfen.
• Die Git-Integration muss aktiviert sein.
• Beim Verzweigen wird eine neue Verzweigung erstellt, und die Einstellungen aus der ursprünglichen Verzweigung werden nicht kopiert. Passen Sie alle Einstellungen oder Definitionen an, um sicherzustellen, dass der neue Arbeitsbereich den Richtlinien Ihrer Organisation entspricht.
• Beim Trennen eines Branch-Workspaces von Git wird auch dessen Beziehung zum Quell-Workspace entfernt.
• Beim Trennen eines mit Git-verbundenen Arbeitsbereichs mit verwandten Branch-Arbeitsbereichen werden auch alle Branch-Workspace-Beziehungen entfernt.
• Beim Löschen eines Arbeitsbereichs mit verwandten Branch-Workspaces werden alle Branch-Workspace-Beziehungen entfernt, und die Branch-Workspaces werden zu regulären Workspaces.
• Beim Wechseln zu einem vorhandenen Arbeitsbereich:
  • Der Zielarbeitsbereich muss eine Git-Verbindung unterstützen.
  • Der Benutzer muss Administrator des Zielarbeitsbereichs sein oder im Zielarbeitsbereich die Rolle Mitglied/Mitwirkender haben, wobei die Einstellung Benutzern mit mindestens der Rolle „Mitwirkender“ das Ändern des Git-Branches erlauben aktiviert sein muss.
  • Der Zielarbeitsbereich muss über Kapazität verfügen.
  • Der Arbeitsbereich kann keine Vorlagen-Apps enthalten.
  • Der Ziel-Arbeitsbereich darf keine zugehörigen Branch-Arbeitsbereiche haben.
  • Wenn du zu einem bestehenden Arbeitsbereich expandierst, können alle Items, die nicht in Git gespeichert sind, verloren gehen. Es wird empfohlen, alle Elemente, die Sie beibehalten möchten, vor dem Verzweigen zu committen.

Verwandte Inhalte

• Entwicklungsprozess in Microsoft Fabric
• Konfigurieren eines Administratorprofils des Arbeitsbereichs für eine Zweigstelle
• Grundlegende Konzepte in der Git-Integration
• Git-Integrations-Tenant-Einstellungen
• Informationen zu Mandanteneinstellungen
• Rollen in Arbeitsbereichen in Microsoft Fabric