Notes — kontrola źródła i wdrażanie

Artykuł
11/04/2024

W tym artykule wyjaśniono, jak działają potoki integracji i wdrażania usługi Git dla notesów w usłudze Microsoft Fabric. Dowiedz się, jak skonfigurować połączenie z repozytorium, zarządzać notesami i wdrażać je w różnych środowiskach.

Integracja notesu Git

Notesy sieci szkieletowej oferują integrację usługi Git z kontrolą źródła za pomocą usługi Azure DevOps. Dzięki integracji z usługą Git możesz utworzyć kopię zapasową notesu i wersję notesu, przywrócić poprzednie etapy w razie potrzeby, współpracować lub pracować samodzielnie przy użyciu gałęzi Git oraz zarządzać cyklem życia zawartości notesu w całości w ramach sieci szkieletowej.

Uwaga

Od października 2024 r. integracja usługi Git notesu obsługuje utrwalanie relacji mapowania dołączonego środowiska podczas synchronizacji z nowym obszarem roboczym, co oznacza, że po zatwierdzeniu notesu i dołączonego środowiska razem do repozytorium git i zsynchronizowaniu go z innym obszarem roboczym, nowo wygenerowany notes i środowisko zostaną powiązane razem. To uaktualnienie będzie miało wpływ na istniejące notesy i środowiska zależne, które są wersjonowane w narzędziu git. Identyfikator fizyczny dołączonego środowiska w zawartości metadanych notesu zostanie zastąpiony identyfikatorem logicznym, a zmiana zostanie odzwierciedlona w widoku różnic.

Konfigurowanie połączenia

Z poziomu ustawień obszaru roboczego można łatwo skonfigurować połączenie z repozytorium w celu zatwierdzania i synchronizowania zmian. Aby skonfigurować połączenie, zobacz Wprowadzenie do integracji z usługą Git. Po nawiązaniu połączenia elementy, w tym notesy, są wyświetlane w panelu sterowania Źródło.

Po pomyślnym zatwierdzeniu wystąpień notesu w repozytorium Git zobaczysz strukturę folderów notesu w repozytorium.

Teraz możesz wykonywać przyszłe operacje, takie jak Tworzenie żądania ściągnięcia.

Reprezentacja notesu w usłudze Git

Na poniższej ilustracji przedstawiono przykład struktury plików każdego elementu notesu w repozytorium:

Po zatwierdzeniu elementu notesu w repozytorium Git kod notesu jest konwertowany na format kodu źródłowego zamiast standardowego pliku ipynb. Na przykład notes PySpark konwertuje na plik notebook-content.py. Takie podejście umożliwia łatwiejsze przeglądy kodu przy użyciu wbudowanych funkcji różnic.

W pliku źródłowym zawartości elementu metadane (w tym domyślne środowisko lakehouse i dołączone), komórki markdown i komórki kodu są zachowywane i rozróżniane. Takie podejście obsługuje dokładne odzyskiwanie podczas synchronizowania z powrotem z obszarem roboczym sieci szkieletowej.

Dane wyjściowe komórki notesu nie są uwzględniane podczas synchronizacji z usługą Git.

Uwaga

Obecnie pliki w zasobach notesu nie są zatwierdzane w repozytorium. Zatwierdzanie tych plików jest obsługiwane w nadchodzącej wersji.
Zalecamy zarządzanie notesami i ich środowiskiem zależnym w tym samym obszarze roboczym oraz używanie narzędzia Git do kontrolowania wersji zarówno elementów notesu, jak i środowiska . System Git usługi Fabric będzie obsługiwać relację mapowania podczas synchronizowania notesu i dołączonego środowiska do nowych obszarów roboczych.
Domyślny identyfikator usługi Lakehouse jest utrwalany w notesie podczas synchronizacji z repozytorium do obszaru roboczego sieć szkieletowa. Jeśli zatwierdzisz notes przy użyciu domyślnego magazynu lakehouse, musisz ręcznie odwołać się do nowo utworzonego elementu lakehouse. Aby uzyskać więcej informacji, zobacz Integracja z usługą Git w usłudze Lakehouse.

Notes w potokach wdrażania

Możesz również użyć potoku wdrażania, aby wdrożyć kod notesu w różnych środowiskach, takich jak programowanie, testowanie i produkcja. Ta funkcja umożliwia usprawnienie procesu programowania, zapewnienie jakości i spójności oraz zmniejszenie błędów ręcznych przy użyciu lekkich operacji z małą ilością kodu. Możesz również użyć reguł wdrażania, aby dostosować zachowanie notesów podczas ich wdrażania, takie jak zmiana domyślnego magazynu lakehouse notesu.

Uwaga

Teraz używasz nowego projektu potoku wdrażania, do którego można uzyskać dostęp do starego interfejsu użytkownika, wyłączając opcję "Nowy potok wdrażania".
Od października notes usługi Fabric obsługuje funkcję automatycznego wiązania, która będzie wiązać domyślne środowisko lakehouse i dołączone w tym samym obszarze roboczym podczas wdrażania na następnym etapie. Zmiana będzie miała wpływ na istniejące notesy w potoku wdrażania.
- Domyślne środowisko lakehouse i dołączone (gdy wszystkie elementy zależne znajdują się w tym samym obszarze roboczym) zostaną zastąpione przez nowo wygenerowane elementy w docelowym obszarze roboczym, zmiana metadanych notesu zostanie wyróżniona w widoku różnic w następnej rundzie wdrożenia.
- Możesz ustawić reguły wdrażania dla domyślnej usługi Lakehouse, aby zastąpić automatycznie powiązaną usługę lakehouse.
Znany problem: Stan zamrożonej komórki w notesie zostanie utracony podczas wdrażania. Obecnie pracujemy nad powiązanymi zadaniami.

Wykonaj poniższe kroki, aby ukończyć wdrażanie notesu przy użyciu potoku wdrażania.

Utwórz nowy potok wdrażania lub otwórz istniejący potok wdrażania. (Aby uzyskać więcej informacji, zobacz Wprowadzenie do potoków wdrażania).
Przypisz obszary robocze do różnych etapów zgodnie z celami wdrożenia.
Wybierz, wyświetl i porównaj elementy, w tym notesy między różnymi etapami, jak pokazano w poniższym przykładzie. Wyróżniony wskaźnik wskazujący zmienioną liczbę elementów między poprzednim etapem a bieżącym etapem.
Wybierz pozycję Wdróż , aby wdrożyć notesy na etapach programowania, testowania i produkcji.
(Opcjonalnie). Możesz wybrać pozycję Reguły wdrażania, aby utworzyć reguły wdrażania dla procesu wdrażania. Wpis reguł wdrażania znajduje się na etapie docelowym procesu wdrażania.

Sieć szkieletowa obsługuje parametryzowanie domyślnej bazy danych lakehouse dla każdego wystąpienia notesu podczas wdrażania przy użyciu reguł wdrażania. Dostępne są trzy opcje określania docelowej domyślnej bazy danych typu lakehouse: takie same jak w przypadku źródła lakehouse, N/A (bez domyślnego jeziora) i innego jeziora.

Można uzyskać bezpieczną izolację danych, konfigurując tę regułę. Domyślny magazyn lakehouse notesu jest zastępowany przez element docelowy określony podczas wdrażania.

Uwaga

W przypadku ustawiania domyślnej usługi Lakehouse w regułach wdrażania musi być wyświetlany identyfikator usługi Lakehouse. Identyfikator usługi Lakehouse można pobrać z linku adresu URL elementu. Reguły wdrażania mają wyższy priorytet niż automatyczne powiązanie, a automatycznie powiązana usługa Lakehouse zostanie zastąpiona po skonfigurowaniu reguły wdrażania.
Monitoruj stan wdrożenia z historii wdrożenia.