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

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.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

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.
• Dołączone środowisko jest utrwalane w notesie podczas synchronizacji z repozytorium do obszaru roboczego sieć szkieletowa. Obecnie środowiska referencyjne między obszarami roboczymi nie są obsługiwane. Aby uruchomić notes, musisz ręcznie dołączyć do nowego środowiska lub domyślnego ustawienia obszaru roboczego.
• 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.

Ważne

Ta funkcja jest dostępna w wersji zapoznawczej.

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

1. 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).

2. Przypisz obszary robocze do różnych etapów zgodnie z celami wdrożenia.

3. Wybierz, wyświetl i porównaj elementy, w tym notesy między różnymi etapami, jak pokazano w poniższym przykładzie.

   

4. Wybierz pozycję Wdróż , aby wdrożyć notesy na etapach programowania, testowania i produkcji.

5. (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 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

   Jeśli zdecydujesz się na przyjęcie innych jezior w środowisku docelowym, identyfikator usługi Lakehouse musi mieć wartość . Identyfikator lakehouse można znaleźć za pomocą linku adresu URL usługi Lakehouse.

6. Monitoruj stan wdrożenia z historii wdrożenia.

Powiązana zawartość

• Zarządzanie notesami sieci szkieletowej i wykonywanie ich za pomocą publicznych interfejsów API
• Wprowadzenie do integracji z usługą Git
• Wprowadzenie do potoków wdrażania