Bezserwerowy katalog Git

Ważna

Ta funkcja jest dostępna w wersji beta.

Git Folder Serverless zapewnia pojedynczy zasób obliczeniowy bezserwerowy współdzielony między zasobami w folderze Git, w tym notatnikami i plikami. Używaj Git Folder Serverless do tworzenia wielu plików bez uruchamiania nowego serwerowego zasobu obliczeniowego lub tworzenia środowiska dla każdego notesu czy pliku. Środowisko jest zarządzane przez pyproject.toml plik w folderze Git root.

Wymagania

Aby korzystać z folderu Git Serverless:

  • Twój projekt musi być w folderze Git.
  • Musisz otworzyć folder Git w edytorze folderów Git.
  • Jeśli folder Git zawiera plik pyproject.toml w katalogu głównym, parametr environment_version musi być ustawiony na wartość 5 lub nowszą.

Współdzielone obliczenia i środowisko

  • Notatniki i pliki w tym samym folderze Git są przypisywane do jednego bezserwerowego zasobu obliczeniowego Git Folder Serverless i korzystają ze środowiska zarządzanego przez pyproject.toml.
  • Tylko zasoby znajdujące się w powiązanym folderze Git mogą zostać dołączone do tego zasobu obliczeniowego.
  • Zmienne Python zdefiniowane w jednym notesie nie są dostępne w innym notesie.
  • Terminal internetowy otwarty z dowolnego przypisanego notatnika lub pliku w folderze Git działa na tym samym zasobu obliczeniowym.

Użyj Git Folder Serverless w edytorze folderów Git

  1. W pasku bocznym workspace kliknij Workspace i przejdź do folderu Git.

  2. Kliknij Otwórz w edytorze.

  3. Otwórz notatnik lub plik w folderze Git.

  4. Kliknij menu rozwijane w trybie obliczeniowym.

  5. Wybierz Git Folder Serverless.

    Rozwijane menu Compute z widoczną wybraną opcją Git Folder Serverless i wersją środowiska 5

  6. Uruchom notatnik lub plik, aby rozpocząć zasób obliczeniowy.

Aby użyć tego samego obliczenia z innego zasobu, otwórz inny notes lub plik w tym samym folderze Git i wybierz Git Folder Serverless. Zasoby współdzielą moc obliczeniową i środowisko zarządzane przez pyproject.toml.

Zarządzaj środowiskiem za pomocą pyproject.toml

Git Folder Serverless zarządza zależnościami Python dla całego folderu Git z plikiem pyproject.toml będącym u podstaw folderu. Różni się to od standardowych notebooków bezserwerowych, gdzie zależności skonfigurowane w panelu bocznym Environment dotyczą jednego notebooka.

Możesz dodawać zależności i wprowadzać zmiany środowiska za pomocą poleceń notatnika lub edytując pyproject.toml.

Używaj poleceń notatnika

  1. Otwórz notatnik połączony z Git Folder Serverless.

  2. Sprawdź, czy pyproject.toml plik znajduje się u korzenia folderu Git. Jeśli nie istnieje, otwórz panel boczny Środowisko i kliknij Create pyproject.toml.

  3. Uruchom %uv add <package>, aby dodać zależność do głównego pliku pyproject.toml. Przykład:

    %uv add cowsay
    
  4. Uruchom %uv sync , aby zastosować zależności do środowiska współdzielonego i wygeneruj lub zaktualizuj uv.lock.

    %uv sync
    

Edytuj pyproject.toml

  1. W edytorze folderów Git sprawdź, czy pyproject.toml plik znajduje się u podstawy folderu Git. Jeśli nie istnieje, otwórz panel boczny Środowisko i kliknij Create pyproject.toml.

  2. Otwórz plik pyproject.toml.

  3. Ręcznie edytuj listę dependencies . Przykład:

    [project]
    name = "my-project"
    version = "0.1.0"
    dependencies = [
      "simplejson==3.18.1",
    ]
    
    [tool.databricks.environment]
    environment_version = "5"
    
  4. Na górze edytora pyproject.toml plików kliknij Apply , aby zastosować zmiany środowiska do Git Folder Serverless.

Zaktualizowane środowisko jest dostępne dla notatników i plików dołączonych do tego samego folderu Git w środowisku Serverless compute. Aby sprawdzić środowisko, otwórz panel boczny Środowiska . Zobacz Konfiguruj środowisko bezserwerowe , aby uzyskać informacje o wersjach środowisk bezserwerowych i zainstalowanych zależnościach.

Współpraca przez Git

Tylko użytkownik, który uruchomi bezserwerowy zasób obliczeniowy Git Folder, może uruchamiać na nim obciążenia robocze. Jeśli inny użytkownik otworzy ten sam folder Git, zostaje zablokowany przed uruchamianiem notatników lub plików na istniejącym zasobu obliczeniowym.

Databricks zaleca, aby każdy współpracownik sklonował repozytorium do folderu Git w swoim osobistym folderze workspace. Każdy współpracownik otrzymuje osobny zasób obliczeniowy i środowisko zarządzane przez pyproject.toml dla jego klonu.

Korzystaj z gałęzi, commitów, pushów i pullów, aby wymieniać zmiany za pośrednictwem zdalnego repozytorium Git. Zobacz Współpraca w folderach Git.

Ograniczenia

  • Współdzielenie zasobów obliczeniowych jest ograniczone do bezserwerowych zasad użycia. Notatniki i pliki w tym samym folderze Git, które używają różnych polityk użytkowania, są przypisywane do oddzielnych zasobów obliczeniowych zamiast współdzielić jeden.

Dodatkowe zasoby