Nasazení aplikace Databricks

Po vytvoření a vývoji aplikace Azure Databricks ji nasaďte, aby byla přístupná v pracovním prostoru Azure Databricks. Nasazení sestaví aplikaci, nainstaluje závislosti a spustí ji pomocí konfigurace definované v souborech projektu. Aplikace můžete nasadit pomocí uživatelského rozhraní Azure Databricks nebo Rozhraní příkazového řádku Azure Databricks.

Poznámka:

Pokud vytvoříte aplikaci ze šablony, Azure Databricks ji automaticky nasadí při prvním vytvoření. Po provedení změn ho ale můžete znovu nasadit později. Viz Vytvoření aplikace Databricks ze šablony.

Logika nasazení

Databricks Apps podporuje nasazování aplikací, které používají Python, Node.jsnebo kombinaci obou. To umožňuje flexibilní architektury, jako je Node.js front-end s back-endem Pythonu.

Během nasazování proces sestavení zkontroluje package.json soubor v kořenovém adresáři vaší aplikace a určí, jestli se Node.js používá. Pokud je k dispozici, zahrnuje kroky sestavení specifické pro Node spolu s kroky Pythonu. Logika nasazení se řídí tímto vzorem:

Pokud package.json je k dispozici:

1. Spusťte příkaz npm install.
2. Spusťte pip install -r requirements.txt (pokud existuje)
3. Spusťte npm run build (pokud build je skript definován v package.json)
4. Spusťte příkaz zadaný v app.yamlparametru , nebo npm run start pokud není zadán žádný příkaz.

Poznámka:

Pokud není ve app.yaml specifikován žádný příkaz, Azure Databricks provede npm run start, i když aplikace obsahuje kód v Pythonu. Pokud chcete spouštět procesy Pythonu i Node.js, definujte vlastní start skript, který používá nástroj jako concurrently k jejich spuštění. Například: concurrently "npm run start:node" "python my_app.py".

Pokud package.json není k dispozici:

1. Spusťte pip install -r requirements.txt (pokud existuje)
2. Spusťte příkaz zadaný v app.yamlparametru , nebo python <my-app>.py pokud není zadán žádný příkaz.

Příprava na nasazení

Před nasazením aplikace ověřte, že projekt obsahuje nezbytné součásti:

• Hlavní skript – Soubor vstupního bodu, například app.py nebo app.js.
• Volitelný app.yaml soubor – Pokud vaše aplikace vyžaduje vlastní příkaz nebo proměnné prostředí, přidejte app.yaml soubor ke konfiguraci provádění. Viz Konfigurace spuštění aplikace Databricks pomocí app.yaml.
• Závislosti – Ujistěte se, že jsou k dispozici všechny závislosti. Viz Správa závislostí pro aplikaci Databricks.
• Tajné kódy nebo hodnoty prostředí – Pokud použijete env oddíl v app.yamlčásti , ověřte, že jsou odkazované tajné kódy nebo externí zdroje správně nakonfigurované a přístupné. Viz Přidání prostředků do aplikace Databricks.

Kromě toho se ujistěte, že aplikace správce služby má přístup ke složce zdrojového kódu.

Nasazení aplikace

Uživatelské rozhraní Databricks

Nasazení aplikace z uživatelského rozhraní Azure Databricks:

1. Nahrajte soubory aplikace do pracovního prostoru Azure Databricks. Pokyny najdete v tématu Import souboru.
2. Klikněte na Počítat v bočním panelu.
3. Přejděte na kartu Aplikace a klikněte na odkaz na aplikaci ve sloupci Název .
4. Klikněte na Nasadit a vyberte složku v pracovním prostoru, kam jste nahráli soubory aplikace.
5. Klikněte na Vybrat a pak nasadit.
6. Zkontrolujte konfiguraci a klikněte na Nasadit.

Příkazové rozhraní Databricks

Nasazení aplikace pomocí rozhraní příkazového řádku:

1. Otevřete terminál a přejděte do adresáře, který obsahuje soubory vaší aplikace.

2. Pomocí příkazu nahrajte soubory aplikace do pracovního prostoru sync Azure Databricks. Cestu nahraďte umístěním pracovního prostoru, kam chcete soubory nahrát.

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

   Příznak --watch udržuje proces synchronizace spuštěný a automaticky nahraje změny při úpravě souborů místně. Pokud chcete vyloučit konkrétní soubory nebo adresáře ze synchronizace, přidejte je do .gitignore souboru v místním adresáři aplikace. Běžné soubory, které se mají vyloučit, jsou node_modules/, .env, __pycache__/.DS_Storea všechny velké datové soubory nebo artefakty sestavení.

3. Ověřte nahrávání zobrazením souborů v pracovním prostoru. Na bočním panelu klikněte na Workspace IconPracovní prostor a přejděte do adresáře, který jste vytvořili pro aplikaci.

4. Nasaďte aplikaci spuštěním následujícího příkazu. Nahraďte název aplikace a cestu ke zdrojovému kódu hodnotami.

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

   Rozhraní příkazového řádku zobrazí průběh nasazení a potvrdí, kdy je aplikace spuštěná.

Po nasazení spustí Azure Databricks vaši aplikaci na základě definovaného command ve vašem app.yaml souboru nebo v případě výchozího nastavení spustí python app.py.

Chování po nasazení

Po dokončení nasazení azure Databricks spustí vaši aplikaci ve spravovaném prostředí. Stránka podrobností aplikace zobrazuje aktuální stav a poskytuje přístup k protokolům, historii nasazení a informacím o prostředí.

Pokud chcete zobrazit výstup nasazené aplikace, klikněte na odkaz aplikace.

Přejděte na kartu Protokoly pro diagnostiku a monitorování běhu. Viz Protokolování a monitorování pro aplikace Databricks.

Aktualizace nebo opětovné nasazení aplikace

Aplikaci můžete chtít aktualizovat nebo znovu nasadit, pokud jste provedli změny zdrojového kódu, aktualizovali app.yaml soubor nebo museli nasadit z jiné cesty ke zdrojovému kódu. Opětovné nasazení použije nejnovější aktualizace, aniž byste museli znovu vytvořit aplikaci od začátku.

Provedení změn nasazené aplikace:

1. Aktualizujte kód nebo app.yaml konfiguraci aplikace.
2. Vraťte se na stránku Aplikace v pracovním prostoru Azure Databricks.
3. Vyberte aplikaci a znovu zvolte Nasadit . Pokud se změnila cesta ke zdrojovému kódu, klikněte na šipku vedle možnosti Nasadit a vyberte Nasadit pomocí jiné cesty ke zdrojovému kódu.

Řešení potíží s nasazením

Pokud se vaší aplikaci nepodaří nasadit nebo se nespustí podle očekávání, vyzkoušejte následující kroky pro řešení potíží:

• Zkontrolujte protokoly – Zobrazte chybové zprávy nebo výstup běhu programu v panelu protokolů.
• Ověřit app.yaml – Ujistěte se, že je syntaxe správná a podporovaná nastavení se používají.
• Ověřte tajemství a proměnné prostředí – ujistěte se, že všechny odkazy v oddílu env správně fungují.
• Potvrďte závislosti – Ujistěte se, že jsou zahrnuté nebo nainstalované všechny požadované balíčky.

Další kroky

• Protokolování a monitorování pro aplikace Databricks
• Konfigurace oprávnění pro aplikaci Databricks
• Konfigurace spuštění aplikace Databricks pomocí app.yaml