Proces programowania z wykorzystaniem obszaru roboczego gałęzi

Przestrzeń robocza gałęziowa to przestrzeń robocza powiązana ze źródłową przestrzenią roboczą. Dzięki temu deweloperzy mogą pracować nad zmianami w izolowanym środowisku, zrozumieć, jak ich praca odnosi się do innych obszarów roboczych, i podwyższyć poziom zmian z powrotem do głównego obszaru roboczego z ufnością.

Relacja (link) między obszarem roboczym gałęzi a jego źródłowym obszarem roboczym jest nawiązywana, gdy użytkownik wykonuje operację branch-out. W przypadku deweloperów Fabric operacja branch-out tworzy nową gałąź Git na podstawie gałęzi Git połączonej ze źródłowym obszarem roboczym. Użytkownik może wybrać utworzenie nowego workspace połączonego z nowo utworzonym odgałęzieniem lub skorzystanie z istniejącego workspace, przełączając jego gałąź Git na nowo utworzoną.

Przestrzeń robocza gałęzi

Relacja między gałęzią a obszarem roboczym ma kilka wizualnych przedstawień w interfejsie użytkownika Fabric:

• Drzewo przestrzeni roboczej: Przedstawia źródłową przestrzeń roboczą jako element nadrzędny dla przestrzeni roboczej gałęzi

  

• Okruszki w przestrzeni roboczej: Opcja nawigacji między przestrzenią roboczym gałęzi a przestrzenią źródłową

  

• Kontrola źródła — karta powiązanych gałęzi

  

Operacja rozgałęziająca

Domyślnie, po zakończeniu operacji rozgałęzienia, wszystkie elementy z gałęzi źródłowej są włączane do docelowego obszaru roboczego. To zachowanie można zmienić, wybierając podczas konfigurowania rozgałęzienia opcję Wybierz elementy indywidualnie, aby uwzględnić w docelowej przestrzeni roboczej tylko wybrane elementy i szybciej rozpocząć kodowanie.

Jako deweloper platformy Fabric przepływ rozgałęzień wygląda następująco:

1. W panelu Kontrola źródła wybierz Utwórz gałąź.

   

2. Określ, czy chcesz utworzyć nowy obszar roboczy lub rozgałęzić się w istniejącym. Wpisz nazwy nowej gałęzi i przestrzeni roboczej lub wybierz istniejącą przestrzeń roboczą z listy rozwijanej. Jeśli zdecydujesz się utworzyć nowy obszar roboczy, możesz włączyć lub wyłączyć opcję Użyj profilu administratora obszaru roboczego gałęzi (Wersja zapoznawcza)

3. Zaznacz opcję Wybierz elementy pojedynczo, jeśli chcesz pracować tylko na części elementów w przestrzeni roboczej gałęzi. Zobaczysz poniższy zrzut ekranu podczas tworzenia nowego obszaru roboczego z użyciem selektywnego rozgałęziania.

4. Kliknij przycisk Rozgałęź (kroki 5–9 obowiązują tylko wtedy, gdy wybrano opcję Wybierz elementy pojedynczo)

5. Ta akcja powoduje wyświetlenie okna dialogowego Select items for your workspace (Wybieranie elementów dla obszaru roboczego).

6. Wybierz elementy, które chcesz wybrać dla tego obszaru roboczego.

7. Kliknij pozycję Utwórz gałąź.

   

8. Podczas przeprowadzania rozgałęziania selektywnego wymagane są wszystkie zależności elementu. W tym celu możesz użyć przycisku Wybierz powiązane elementy . Jeśli nie wybierzesz jednej z zależności, zobaczysz następujące informacje:

   Note

   Możesz wybrać elementy i zacząć rozgałęzianie się, podczas gdy Fabric oblicza ich zależności w tle. Jednak kontynuowanie przed załadowaniem wszystkich powiązanych elementów może spowodować niepowodzenie operacji.

9. Po utworzeniu gałęzi możesz sprawdzić, czy jesteś w gałęzi selektywnej, używając ikony na dolnym pasku stanu (dolny lewy róg). Mówi selektywna gałąź.

10. Fabric tworzy nową przestrzeń roboczą oddziału. Zostanie automatycznie przeniesiony do nowego obszaru roboczego. Zawiera wszystkie elementy lub tylko elementy wybrane w przypadku rozgałęziania selektywnego.

Przestrzeń robocza synchronizuje się z twoją gałęzią funkcji i staje się izolowanym środowiskiem do pracy, jak pokazano poniżej. Teraz możesz pracować w tym nowym obszarze roboczym oddziału. Synchronizacja może potrwać kilka minut. Aby uzyskać więcej informacji na temat rozszerzania działalności, zapoznaj się z poradami dotyczącymi rozwiązywania problemów .

11. Zapisz zmiany i zatwierdź je w gałęzi funkcji.
12. Gdy będziesz gotowy, utwórz pull request do gałęzi main. Procesy przeglądu i scalania są wykonywane za pośrednictwem powiązanego dostawcy Usługi Git na podstawie konfiguracji zdefiniowanej przez zespół dla tego repozytorium.

Po zakończeniu przeglądu i scalania zostanie utworzony nowy commit w gałęzi main. To zatwierdzenie monituje użytkownika o zaktualizowanie zawartości w obszarze roboczym zespołu deweloperów za pomocą scalonych zmian.

Aby uzyskać więcej informacji, zobacz rozgałęzianie ograniczeń.

Jak dodać dodatkowe elementy do obszaru roboczego z rozgałęzianiem selektywnym

Gdy deweloper Fabric musi dodać elementy, które nie zostały wybrane podczas operacji rozgałęzienia, poniższe kroki opisują sposób dodawania dodatkowych elementów do obszaru roboczego:

1. Przejdź do wymaganego obszaru roboczego Microsoft Fabric i wybierz opcję Kontrola źródła u góry.
2. Po prawej stronie wybierz symbol rozgałęzienia.
3. Użyj listy rozwijanej i wybierz pozycję Wybierz dodatkowe elementy.
4. Ta akcja powoduje wyświetlenie okna dialogowego Select items for your workspace (Wybieranie elementów dla obszaru roboczego). W oknie dialogowym wyboru elementów są wyświetlane tylko elementy z gałęzi git, które nie zostały wcześniej wybrane.
5. Wybierz dodatkowe elementy, które chcesz dodać do obszaru roboczego.
6. Kliknij przycisk Dodaj. Wybrane elementy są dodawane do oczekujących aktualizacji w okienku kontroli źródła.
7. Kliknij pozycję Aktualizuj wszystko. Ta operacja wykonuje aktualizację z repozytorium git i tworzy elementy w obszarze roboczym.

Przełączanie gałęzi

Jeśli obszar roboczy jest połączony z gałęzią Git i chcesz przełączyć się do innej gałęzi, możesz to zrobić szybko w okienku kontroli źródła bez odłączania i ponownego łączenia.

Podczas przełączania gałęzi obszar roboczy jest synchronizowany z nową gałęzią, a wszystkie elementy w obszarze roboczym są zastępowane. Jeśli w każdej gałęzi istnieją różne wersje tego samego elementu, element zostanie zastąpiony.

Przełączenie gałęzi nie wpływa na powiązanie między przestrzenią roboczą gałęzi a jej źródłową przestrzenią roboczą. Przełączanie gałęzi to zmiana stanu w Git. W związku z tym przełączanie gałęzi nie tworzy ani nie modyfikuje relacji obszaru roboczego. Jeśli obszar roboczy ma już relację, zostanie ona zachowana.

Domyślnie przełączanie gałęzi Git połączonego obszaru roboczego (lub wyewidencjonowanie nowej gałęzi) jest ograniczone do administratorów obszaru roboczego. Jednak Administrator obszaru roboczego może włączyć ustawienie dla obszaru roboczego Pozwól użytkownikom z co najmniej rolą Współtwórcy przełączać gałąź Git, aby umożliwić Członkom i Współtwórcom przełączanie gałęzi. To ustawienie jest skonfigurowane dla poszczególnych obszarów roboczych i wymaga aktywnego połączenia usługi Git. Pełną macierz uprawnień znajdziesz w sekcji Uprawnienia.

Aby przełączyć się między gałęziami, wykonaj następujące kroki:

1. W panelu Kontrola źródła wybierz Więcej opcji (...), a następnie wybierz Przełącz gałąź.

   

2. Określ gałąź, z którą chcesz nawiązać połączenie, lub utwórz nową gałąź. Ta gałąź musi zawierać ten sam katalog co gałąź bieżąca.

3. Zaznacz, iż zrozumiałem, że elementy obszaru roboczego mogą zostać usunięte i nie będą mogły być przywrócone. Wybierz opcję Przełącz gałąź.

   

Nie można przełączać gałęzi, jeśli masz jakiekolwiek niezatwierdzone zmiany w obszarze roboczym. Wybierz Anuluj, aby wrócić i zatwierdzić zmiany przed przełączeniem gałęzi.

Aby połączyć bieżący obszar roboczy z nową gałęzią przy zachowaniu stanu istniejącego obszaru roboczego, wybierz pozycję Przełącz na nową gałąź. Dowiedz się więcej na temat przejścia na nową gałąź w Rozwiązywaniu konfliktów w usłudze Git.

Rozszerz plan wdrożenia

Dołącz plan wdrożenia, gdy elementy muszą być wdrażane w określonej kolejności lub gdy notatniki, potoki danych albo inne obsługiwane akcje muszą być uruchamiane podczas tworzenia odgałęzienia. Plan wdrożenia określa, jak Fabric wypełnia obszar roboczy utworzony z odgałęzienia; nie zmienia sposobu tworzenia gałęzi Git ani obszaru roboczego.

Zanim zaczniesz, zapisz plan wdrożenia i zawrz go do aktualnej gałęzi Git wraz z elementami, do których się odwołuje. Podczas rozgałęziania można wybrać tylko plany wdrożenia dostępne w Gicie.

Aby rozszerzyć działania zgodnie z planem wdrożenia:

1. Z zakładki Gałęzie w panelu kontroli źródeł wybierz Rozgałęzienie z planem wdrożenia.

   

2. Konfiguruj nową gałąź i docelową przestrzeń roboczą. Wybierz Dalej.

   

3. Wybierz plan wdrożenia w kreatorze rozgałęzień. Aby użyć standardowego sposobu rozgałęziania, wybierz Brak planu wdrożenia.

4. Jeśli wybrałeś Wybierz elementy pojedynczo (Podgląd), wybierz elementy, które chcesz uwzględnić w rozgałęzionej przestrzeni roboczej, w tym elementy wymagane przez akcje planu. Dołączenie planu nie spowoduje automatycznego zaznaczenia tych elementów.

5. Wybierz Utwórz gałąź.

   

Fabric tworzy gałąź i przestrzeń roboczą, a następnie używa planu wdrożenia podczas uzupełniania docelowej przestrzeni roboczej. Aby dowiedzieć się, jak wybrane elementy, relacje planowe, linia Fabric oraz akcje decydują o wdrożeniu, zobacz: Jak działa plan wdrożenia.

Rozszerzanie się bez planu wdrożenia działa jak wcześniej: Fabric wdraża wybrane elementy za pomocą standardowego zarządzania zależnościami i nie wykonuje akcji przed ani po wdrożeniu.

Rozgałęzianie ograniczeń

• Profil administratora obszaru roboczego gałęzi jest dostępny w wersji zapoznawczej.
• Rozgałęzienie wymaga uprawnień wymienionych w tabeli uprawnień.
• Dla tej akcji musi istnieć dostępna pojemność.
• Wszystkie ograniczenia dotyczące nazewnictwa obszarów roboczych i gałęzi mają zastosowanie podczas rozgałęziania się do nowego obszaru roboczego.
• W nowym obszarze roboczym są dostępne tylko elementy obsługiwane przez Git.
• Lista powiązanych gałęzi zawiera tylko gałęzie i obszary robocze, do których masz uprawnienia do wyświetlania.
• Integracja z usługą Git musi być włączona.
• Podczas rozgałęziania zostanie utworzona nowa gałąź, a ustawienia z oryginalnej gałęzi nie są kopiowane. Dostosuj ustawienia lub definicje, aby nowy workspace spełniał zasady Twojej organizacji.
• Podczas odłączania przestrzeni roboczej gałęzi od Gita, jej relacja z przestrzenią źródłową również zostaje usunięta.
• Podczas odłączania obszaru roboczego połączonego z repozytorium Git, który ma powiązane obszary robocze gałęzi, wszystkie relacje między tymi obszarami roboczymi również zostaną usunięte.
• Podczas usuwania przestrzeni roboczej, która ma powiązane przestrzenie robocze gałęzi, wszystkie relacje między przestrzeniami roboczymi są usuwane, a przestrzenie robocze z gałęzi stają się zwykłymi przestrzeniami roboczymi.
• Podczas rozgałęziania do istniejącego obszaru roboczego:
  • Docelowy obszar roboczy musi obsługiwać połączenie z Git.
  • Użytkownik musi być administratorem docelowego obszaru roboczego albo członkiem lub współautorem w docelowym obszarze roboczym przy włączonym ustawieniu Zezwalaj użytkownikom z co najmniej rolą Współautor na zmianę gałęzi Git.
  • Docelowy obszar roboczy musi mieć pojemność.
  • Obszar roboczy nie może mieć aplikacji wzorcowych.
  • Docelowy obszar roboczy nie może mieć żadnych powiązanych obszarów roboczych gałęzi.
  • Gdy rozgałęziasz się na istniejącą przestrzeń roboczą, wszystkie przedmioty, które nie są zapisane w Gicie, mogą zostać utracone. Zalecamy zatwierdzenie wszelkich elementów, które chcesz zachować przed utworzeniem nowej gałęzi.

Treści powiązane

• Proces tworzenia w Microsoft Fabric
• Konfiguruj profil administratora Branch WorkAPCE
• Podstawowe pojęcia dotyczące integracji z usługą Git
• Ustawienia tenant integracji z Gitem
• Informacje o ustawieniach najemcy
• Role w przestrzeniach roboczych w Microsoft Fabric