Współdzielony Serverless dla folderów Git

Ważna

Ta funkcja jest dostępna w wersji beta.

Shared Serverless for Git Folders zapewnia pojedynczy zasób obliczeniowy bezserwerowy współdzielony pomiędzy zasobami w folderze Git, w tym notatnikami i plikami. Używaj Shared Serverless for Git Folders do tworzenia wielu plików bez konieczności uruchamiania nowego bezserwerowego 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 używać Shared Serverless dla folderów Git:

  • 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ą powiązane z jednym współdzielonym zasobem obliczeniowym 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 współdzielonego trybu bezserwerowego dla folderów Git 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 Shared Serverless for Git Folders.

    Opcja rozwijanego menu Compute dla współdzielonego przetwarzania bezserwerowego, z odznaką Beta i środowiskiem z pyproject.toml

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

Aby użyć tych samych zasobów obliczeniowych z innego zasobu, otwórz inny notes lub plik w tym samym folderze Git i wybierz Shared Serverless for Git Folders. Zasoby współdzielą moc obliczeniową i środowisko zarządzane przez pyproject.toml.

Zarządzaj środowiskiem za pomocą pyproject.toml

Shared Serverless for Git Folders zarządza zależnościami języka Python dla całego folderu Git za pomocą pliku pyproject.toml w katalogu głównym 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 podłączony do Shared Serverless dla folderów Git.

  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 Shared Serverless for Git Folders.

Zaktualizowane środowisko jest dostępne dla notatników i plików dołączonych do tego samego wspólnego zasobu obliczeniowego. 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ł współdzielony zasób obliczeniowy, może na nim uruchamiać obciążenia. 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