Wdróż aplikację Databricks

Po utworzeniu i opracowaniu aplikacji usługi Azure Databricks wdróż ją, aby była dostępna w obszarze roboczym usługi 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 usługi Azure Databricks lub interfejsu wiersza polecenia usługi Databricks.

Uwaga / Notatka

Jeśli tworzysz aplikację na podstawie szablonu, usługa 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 języka Python, Node.jslub kombinacji obu tych elementów. Umożliwia to elastyczne architektury, takie jak fronton Node.js z zapleczem języka 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 obecne, obejmuje kroki kompilacji specyficzne dla Node wraz z krokami w języku Python. Logika wdrażania jest zgodna z tym wzorcem:

Jeśli package.json jest obecny:

1. Uruchom npm install
2. Uruchom pip install -r requirements.txt (jeśli istnieje)
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 usłudze Azure Databricks nie określono polecenia w app.yaml, Azure Databricks wykonuje npm run start, nawet jeśli aplikacja zawiera kod w języku Python. Aby uruchomić zarówno procesy języka Python, jak i Node.js, zdefiniuj skrypt niestandardowy start , który używa narzędzia, takiego jak concurrently do uruchamiania obu. Na przykład: concurrently "npm run start:node" "python my_app.py".

Jeśli package.json nie występuje:

1. Uruchom pip install -r requirements.txt (jeśli istnieje)
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:

• Skrypt główny — plik punktu wejścia, taki jak app.py lub app.js.
• Opcjonalny app.yaml plik — jeśli aplikacja wymaga niestandardowego polecenia lub zmiennych środowiskowych, dołącz plik do konfiguracji app.yaml uruchomienia. Zobacz Konfigurowanie wykonywania aplikacji usługi Databricks za pomocą polecenia app.yaml.
• Zależności — upewnij się, że wszystkie zależności są dostępne. Zobacz Zarządzanie zależnościami dla aplikacji usługi Databricks.
• Sekrety lub wartości środowiskowe — jeśli używasz części env w app.yaml, sprawdź, czy wskazane sekrety lub źródła zewnętrzne są poprawnie skonfigurowane i dostępne. Zobacz Dodawanie zasobów do aplikacji Databricks.

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

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 usługi Azure Databricks:

1. Przekaż pliki aplikacji do obszaru roboczego usługi Azure Databricks. Aby uzyskać instrukcje, zobacz Importowanie pliku.
2. Kliknij Komputer na pasku bocznym.
3. Przejdź do karty Aplikacje i kliknij link do aplikacji 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óż.
6. Przejrzyj konfigurację i kliknij pozycję 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 usługi Azure Databricks przy użyciu sync polecenia . 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 na pasku bocznym i przejdź do katalogu, który utworzyłeś dla swojej 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

Ważne

Ta funkcja jest dostępna w wersji beta. Jeśli administrator wyłączy tę funkcję, istniejące aplikacje wdrożone z usługi Git będą nadal uruchamiane, ale nie można ich ponownie wdrożyć ani ponownie uruchomić, dopóki nie włączysz podglądu lub usuniesz repozytorium z aplikacji.

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.

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

1. Przekaż pliki aplikacji do repozytorium Git.
2. W obszarze roboczym usługi Azure Databricks kliknij Obliczenia na pasku bocznym.
3. Przejdź do karty Aplikacje i 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 usługi Git. Alternatywnie zmodyfikuj aplikację i dodaj poświadczenia w kroku Konfigurowanie repozytorium Git . Aby dodać poświadczenia Git, musisz mieć CAN MANAGE uprawnienia do aplikacji. Aby uzyskać instrukcje dla każdego dostawcy, zobacz Łączenie dostawcy Git z usługą Databricks.

Ważne

Ze względów bezpieczeństwa Azure Databricks usuwa wszystkie poświadczenia Git skojarzone z głównym elementem usługi aplikacji, kiedy zmieniasz źródło wdrożenia (z Git na obszar roboczy lub z obszaru roboczego na Git) lub gdy zmieniasz repozytorium Git. Zmiana tylko referencji Git nie powoduje usunięcia poświadczeń. Po zmianie źródła wdrożenia lub repozytorium należy ponownie skonfigurować poświadczenie usługi Git, aby wdrożyć je ponownie z usługi Git.

Uwaga / Notatka

Twórcy aplikacji automatycznie otrzymują CAN MANAGE uprawnienia do jednostki usługi tylko wtedy, gdy funkcja wdrożenia usługi Git Beta jest włączona. Jeśli aplikacja została utworzona, gdy funkcja została wyłączona, być może nie masz uprawnień do dodawania poświadczeń usługi Git.

Jednostki usług obsługują jedno poświadczenie Git na dostawcę. Aktualizacja poświadczenia, na przykład za pomocą konsoli konta, zastępuje istniejące poświadczenie dla tego dostawcy i wpływa na wszystkie aplikacje korzystające z jednostki usługi tego dostawcy.

Następnie wdróż aplikację:

1. Na stronie szczegółów 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. Kliknij Wdróż.

W przypadku odwołań do gałęzi lub tagów, Azure Databricks wdraża najnowszy commit z tej gałęzi lub tego tagu. W przypadku odwołań do SHA zatwierdzeń usługa Azure Databricks zawsze wdraża właśnie te konkretne zatwierdzenie. Jeśli poświadczenie usługi Git jednostki usługi jest nieprawidłowe lub wygasło, wdrożenie zakończy się niepowodzeniem.

Zachowanie po wdrożeniu

Po zakończeniu wdrażania usługa Azure Databricks uruchamia aplikację na podstawie wartości zdefiniowanej w pliku app.yaml lub domyślnie uruchamiając 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.

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 usługi Azure Databricks wybierz aplikację i kliknij pozycję Wdróż.
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. 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. 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.

W przypadku wdrożeń repozytorium Git:

• W przypadku repozytoriów prywatnych sprawdź, czy główny element usługi aplikacji ma skonfigurowane poświadczenie Git.
• Sprawdź, czy adres URL repozytorium Git jest poprawny.
• Sprawdź, czy w repozytorium istnieje referencja Git (gałąź, tag lub commit).

Dalsze kroki

• Rejestrowanie i monitorowanie aplikacji usługi Databricks
• Konfigurowanie uprawnień dla aplikacji usługi Databricks
• Konfigurowanie wykonywania aplikacji usługi Databricks za pomocą polecenia app.yaml