Udostępnij za pośrednictwem

Wdróż aplikację Databricks

Po utworzeniu i opracowaniu aplikacji Azure Databricks wdróż ją, aby była dostępna w obszarze roboczym Azure Databricks. Wdrożenie kompiluje aplikację, instaluje zależności i uruchamia ją przy użyciu konfiguracji zdefiniowanej w plikach projektu. Aplikacje można wdrażać przy użyciu interfejsu użytkownika Azure Databricks lub interfejsu wiersza polecenia usługi Databricks.

Uwaga / Notatka

Jeśli tworzysz aplikację na podstawie szablonu, Azure Databricks wdraża ją automatycznie po pierwszym utworzeniu. Jednak po wprowadzeniu zmian nadal można go ponownie wdrożyć później. Zobacz Tworzenie aplikacji usługi Databricks na podstawie szablonu.

Logika wdrażania

Usługa Databricks Apps obsługuje wdrażanie aplikacji korzystających z Python, Node.jslub kombinacji obu tych aplikacji. Umożliwia to elastyczne architektury, takie jak fronton Node.js z zapleczem Python.

Podczas wdrażania proces kompilacji sprawdza package.json plik w katalogu głównym aplikacji, aby określić, czy Node.js jest używany. Jeśli jest obecny, obejmuje kroki kompilacji specyficzne dla Node.js wraz z krokami Pythona. Logika wdrażania jest zgodna z tym wzorcem:

Jeśli package.json jest obecny:

  1. Uruchom npm install
  2. Zainstaluj zależności Python:
    • Jeśli requirements.txt istnieje, uruchom polecenie pip install -r requirements.txt
    • Jeśli requirements.txt nie istnieje i pyproject.toml oraz uv.lock istnieją, uruchom uv sync, aby zainstalować zależności
  3. Uruchom npm run build (jeśli build skrypt jest zdefiniowany w package.json)
  4. Uruchom polecenie określone w pliku app.yamllub npm run start jeśli nie określono polecenia

Uwaga / Notatka

Jeśli w app.yaml nie określono polecenia, Azure Databricks wykonuje npm run start, nawet jeśli aplikacja zawiera kod Python. Aby uruchomić zarówno procesy Python, jak i Node.js, zdefiniuj niestandardowy skrypt start, który używa narzędzia takiego jak concurrently do uruchomienia obu. Na przykład: concurrently "npm run start:node" "python my_app.py".

Jeśli package.json nie występuje:

  1. Zainstaluj zależności Python:
    • Jeśli requirements.txt istnieje, uruchom polecenie pip install -r requirements.txt
    • Jeśli requirements.txt nie istnieje i pyproject.toml oraz uv.lock istnieją, uruchom uv sync, aby zainstalować zależności
  2. Uruchom polecenie określone w pliku app.yamllub python <my-app>.py jeśli nie określono polecenia

Przygotowanie do wdrożenia

Przed wdrożeniem aplikacji sprawdź, czy projekt zawiera niezbędne składniki:

Ponadto upewnij się, że główna jednostka usługowa aplikacji ma dostęp do folderu kodu źródłowego.

Wybieranie źródła wdrożenia

Aplikacje usługi Databricks można wdrażać z następujących źródeł:

  • Folder obszaru roboczego — przekazywanie plików aplikacji do folderu obszaru roboczego i wdrażanie z tego miejsca. Jest to standardowa metoda wdrażania.
  • Repozytorium Git — skonfiguruj repozytorium Git dla aplikacji i wdróż je bezpośrednio bez przekazywania plików do obszaru roboczego. Aplikacja odczytuje kod ze skonfigurowanej dokumentacji git (gałęzi, tagu lub zatwierdzenia) przy każdym wdrożeniu. Możesz również określić ścieżkę kodu źródłowego do wdrożenia z określonego katalogu w repozytorium. Wszyscy główni dostawcy usługi Git są obsługiwani, w tym GitHub, GitLab i Bitbucket. Aby uzyskać pełną listę obsługiwanych dostawców, zobacz Łączenie dostawcy Usługi Git z usługą Databricks.

W dowolnym momencie możesz przełączać się między obszarem roboczym a źródłami usługi Git dla tej samej aplikacji, chyba że administrator obszaru roboczego wymusza wdrożenia tylko w usłudze Git. Zobacz Wymuszanie wdrożeń tylko za pomocą Git.

Wymuszanie wdrożeń wyłącznie przy użyciu Git

Administratorzy obszaru roboczego mogą wymagać wdrożenia wszystkich aplikacji w obszarze roboczym z repozytoriów Git. Aby włączyć to ustawienie, przejdź do pozycji Ustawienia>Programowanie>Aplikacje i włącz opcję Zezwalaj tylko na wdrożenia aplikacji z Git. To ustawienie jest domyślnie wyłączone.

Po włączeniu tego ustawienia:

  • Użytkownicy muszą skonfigurować repozytorium Git przed utworzeniem aplikacji.
  • Użytkownicy mogą wdrażać tylko z usługi Git, a nie z folderów obszaru roboczego.
  • Usługa Databricks wyłącza szablony aplikacji w obszarze roboczym.
  • Użytkownicy nie mogą usunąć repozytorium Git z aplikacji, które je mają.
  • Istniejące aplikacje nadal działają, ale użytkownicy nie mogą ich wdrażać ani uruchamiać ponownie, chyba że aplikacja ma repozytorium Git.

Wdrażanie aplikacji

W poniższych sekcjach opisano sposób wdrażania z folderu obszaru roboczego lub bezpośrednio z repozytorium Git.

Wdrażanie z folderu obszaru roboczego

Interfejs użytkownika usługi Databricks

Aby wdrożyć aplikację z poziomu interfejsu użytkownika Azure Databricks:

  1. Przekaż pliki aplikacji do obszaru roboczego Azure Databricks. Aby uzyskać instrukcje, zobacz Importowanie pliku.
  2. W obszarze roboczym usługi Databricks kliknij ikonę przełącznika aplikacji. Wybierz pozycję Aplikacje usługi Databricks.
  3. Wybierz aplikację w kolumnie Nazwa .
  4. Kliknij pozycję Wdróż i wybierz folder w obszarze roboczym, w którym przekazano pliki aplikacji.
  5. Kliknij Wybierz, a następnie Wdróż.

Interfejs wiersza polecenia usługi Databricks

Aby wdrożyć aplikację przy użyciu interfejsu wiersza polecenia:

  1. Otwórz terminal i przejdź do katalogu zawierającego pliki aplikacji.

  2. Przekaż pliki aplikacji do obszaru roboczego Azure Databricks przy użyciu polecenia sync. Zastąp ścieżkę lokalizacją obszaru roboczego, w której chcesz przesłać pliki.

    databricks sync --watch . /Workspace/Users/my-email@org.com/my-app

    Flaga --watch utrzymuje uruchomiony proces synchronizacji i automatycznie przekazuje zmiany podczas lokalnego modyfikowania plików. Aby wykluczyć określone pliki lub katalogi z synchronizacji, dodaj je do .gitignore pliku w lokalnym katalogu aplikacji. Typowe pliki do wykluczenia to node_modules/, , .env__pycache__/, .DS_Storei wszelkie duże pliki danych lub artefakty kompilacji.

  3. Zweryfikuj przesyłanie, wyświetlając pliki w swoim obszarze roboczym. Kliknij ikonę przełącznika aplikacji.>Lakehouse, a następnie kliknij pozycję Obszar roboczy Ikona obszaru roboczego i przejdź do katalogu utworzonego dla aplikacji.

  4. Wdróż aplikację, uruchamiając następujące polecenie. Zastąp nazwę aplikacji i ścieżkę kodu źródłowego swoimi wartościami.

    databricks apps deploy my-app-name \
   --source-code-path /Workspace/Users/my-email@org.com/my-app

    Interfejs wiersza polecenia wyświetla postęp wdrażania i potwierdza, kiedy aplikacja jest uruchomiona.

Wdrażanie z repozytorium Git

Aby wdrożyć aplikację z repozytorium Git, dodaj repozytorium na poziomie aplikacji, a następnie określ odwołanie git podczas wdrażania. Repozytorium Git musi zawierać pliki aplikacji, w tym app.yaml, zależności i punkt wejścia. Wszyscy główni dostawcy usługi Git są obsługiwani, w tym GitHub, GitLab i Bitbucket. Aplikacje oparte na usłudze Git można również wdrażać przy użyciu interfejsu użytkownika, interfejsu wiersza polecenia, interfejsu API lub pakietów deklaratywnej automatyzacji.

Aby skonfigurować i wdrożyć aplikację z usługi Git:

  1. Przekaż pliki aplikacji do repozytorium Git.
  2. W obszarze roboczym usługi Databricks kliknij ikonę przełącznika aplikacji. Wybierz pozycję Aplikacje usługi Databricks.
  3. Wybierz istniejącą aplikację do edycji lub kliknij pozycję + Utwórz aplikację.
  4. W kroku Konfigurowanie repozytorium Git wprowadź adres URL repozytorium Git (na przykład https://github.com/org/repo) i wybierz dostawcę git.
  5. Kliknij pozycję Utwórz aplikację lub Zapisz , aby powrócić do strony szczegółów aplikacji.
  6. W przypadku repozytoriów prywatnych główny użytkownik usługi aplikacji musi mieć skonfigurowane poświadczenie Git. Na stronie szczegółów aplikacji kliknij pozycję Konfiguruj poświadczenia git lub edytuj aplikację i dodaj poświadczenia w kroku Konfigurowanie repozytorium Git . Aby dodać poświadczenia Git, musisz mieć CAN MANAGE uprawnienia do aplikacji. Repozytoria publiczne nie wymagają poświadczeń usługi Git. Aby uzyskać instrukcje dla każdego dostawcy, zobacz Łączenie dostawcy Git z usługą Databricks.

Następnie wdróż aplikację:

  1. Na stronie przeglądu aplikacji kliknij pozycję Wdróż.
  2. Wybierz Git.
  3. W polu Odwołanie do Git wprowadź nazwę gałęzi, tag lub identyfikator SHA zatwierdzenia (na przykład main, v1.0.0 lub skrót zatwierdzenia).
  4. W polu Typ odwołania określ typ odwołania, taki jak gałąź, tag lub zatwierdzenie.
  5. (Opcjonalnie) W polu Ścieżka kodu źródłowego wprowadź ścieżkę do określonego katalogu w repozytorium. Aplikacja traktuje ten katalog jako katalog najwyższego poziomu i nie może uzyskać dostępu do plików poza nim. Jeśli nie określisz ścieżki, usługa Databricks używa katalogu głównego repozytorium.
  6. Kliknij Wdróż.

W przypadku odniesień do gałęzi lub tagów Azure Databricks wprowadza najnowsze zatwierdzenie z tej gałęzi lub tagu. Dla referencji SHA zatwierdzeń Azure Databricks zawsze wdraża to konkretne zatwierdzenie. Jeśli poświadczenie usługi Git jednostki usługi jest nieprawidłowe lub wygasło, wdrożenie zakończy się niepowodzeniem.

Uwaga / Notatka

Aplikacje utworzone przed udostępnieniem wdrożenia usługi Git nie są automatycznie przydzielane twórcom CAN MANAGE uprawnień do jednostki usługi aplikacji. Jeśli musisz dodać poświadczenia usługi Git do starszej aplikacji, poproś administratora obszaru roboczego o przyznanie ci CAN MANAGE uprawnień do jednostki usługi.

Jednostki usług obsługują jedno poświadczenie Git na dostawcę. Jeśli zaktualizujesz poświadczenie w innym miejscu niż główna aplikacja, na przykład za pomocą konsoli konta, zastąpi ono istniejące poświadczenie dla tego dostawcy.

Zachowanie po wdrożeniu

Po zakończeniu wdrażania Azure Databricks uruchamia twoją aplikację na podstawie zdefiniowanego command w pliku app.yaml lub domyślnie uruchamia python app.py. Strona szczegółów aplikacji zawiera bieżący stan i zapewnia dostęp do dzienników, historii wdrożenia i informacji o środowisku.

Wyświetlanie strony szczegółów aplikacji po wdrożeniu aplikacji

Aby wyświetlić dane wyjściowe wdrożonej aplikacji, kliknij link aplikacji.

Przejdź do karty Dzienniki na potrzeby debugowania i monitorowania środowiska uruchomieniowego. Zobacz Rejestrowanie i monitorowanie aplikacji usługi Databricks.

Aktualizowanie lub ponowne wdrażanie aplikacji

Ponownie wdróż aplikację po wprowadzeniu zmian w kodzie źródłowym lub konfiguracji. Ponowne wdrożenie stosuje najnowsze aktualizacje bez potrzeby ponownego tworzenia aplikacji. W dowolnym momencie można przeprowadzić ponowne wdrożenie z poziomu obszaru roboczego lub repozytorium Git.

Ponowne wdrażanie z folderu roboczego

Aby ponownie wdrożyć z folderu obszaru roboczego:

  1. Zaktualizuj pliki aplikacji w folderze obszaru roboczego.
  2. Wybierz aplikację i kliknij pozycję Wdróż.
  3. Jeśli ścieżka kodu źródłowego została zmieniona lub przełączasz się ze źródła usługi Git, kliknij strzałkę obok pozycji Wdróż i wybierz pozycję Wdróż przy użyciu innego źródła.

Ponowne wdrażanie z repozytorium Git

Aby ponownie wdrożyć z repozytorium Git:

  1. Wypchnij zmiany do repozytorium Git.
  2. W obszarze roboczym Azure Databricks wybierz aplikację i kliknij pozycję Deploy.
  3. Jeśli odwołanie Git zostało zmienione lub przełączasz się z innego źródła obszaru roboczego, kliknij strzałkę obok Wdróż i wybierz Wdróż przy użyciu innego źródła.

Aby zmienić repozytorium Git lub poświadczenia, zmodyfikuj konfigurację aplikacji. Aby zaktualizować repozytorium Git przy użyciu interfejsu wiersza polecenia lub interfejsu API, użyj polecenia create-update . Usunięcie repozytorium Git z aplikacji wymusza wdrożenie z obszaru roboczego.

Ważne

Zmiana repozytorium Git lub przełączanie się między źródłami wdrożenia (Git i obszarem roboczym) powoduje usunięcie wszystkich poświadczeń usługi Git dla jednostki usługi aplikacji. Zmiana tylko referencji Git nie powoduje usunięcia poświadczeń. Przed ponownym wdrożeniem z usługi Git należy ponownie skonfigurować poświadczenia.

Rozwiązywanie problemów z wdrażaniem

Jeśli wdrożenie aplikacji nie powiedzie się lub nie zostanie uruchomione zgodnie z oczekiwaniami, spróbuj wykonać następujące kroki rozwiązywania problemów:

  • Sprawdź dzienniki pod kątem komunikatów o błędach lub danych wyjściowych środowiska uruchomieniowego.
  • Zweryfikuj app.yaml składnię i ustawienia.
  • Sprawdź, czy wpisy tajne i zmienne środowiskowe w env sekcji są prawidłowo rozpoznawane.
  • Upewnij się, że wszystkie wymagane zależności są dołączone lub zainstalowane.
  • Jeśli obszar roboczy używa Private Link lub ograniczonych zasad sieci wychodzących, sprawdź, czy wymagane domeny są dozwolone. Brakujące wpisy na liście dozwolonych połączeń wychodzących są częstą przyczyną błędów wdrażania w środowiskach Private Link. Zobacz Wdrażanie aplikacji w środowiskach Private Link.

W przypadku wdrożeń repozytorium Git:

  • W przypadku repozytoriów prywatnych sprawdź, czy jednostka usługi aplikacji ma skonfigurowane poświadczenie Git.
  • Sprawdź, czy adres URL repozytorium Git jest poprawny i że w repozytorium istnieje odwołanie git (gałąź, tag lub zatwierdzenie).
  • Jeśli administrator obszaru roboczego wymusza wdrożenia tylko w usłudze Git, nie można wdrożyć ani uruchomić aplikacji, chyba że ma skonfigurowane repozytorium Git.
  • W przypadku wdrożenia z poziomu interfejsu wiersza polecenia, interfejsu API lub pakietów deklaratywnej automatyzacji najpierw utwórz aplikację, a następnie dodaj poświadczenie Git do jednostki usługi aplikacji.

Dalsze kroki

  • Last updated on