Megosztás:

Databricks-alkalmazás üzembe helyezése

Az Azure Databricks-alkalmazás létrehozása és fejlesztése után helyezze üzembe, hogy az elérhető legyen az Azure Databricks-munkaterületen. Az üzembe helyezés létrehozza az alkalmazást, telepíti a függőségeket, és a projektfájlokban meghatározott konfigurációval futtatja azt. Az alkalmazásokat az Azure Databricks felhasználói felületén vagy a Databricks parancssori felületén helyezheti üzembe.

Megjegyzés:

Ha sablonból hoz létre alkalmazást, az Azure Databricks automatikusan üzembe helyezi azt az első létrehozáskor. A módosítások végrehajtása után azonban később is újra üzembe helyezheti. Lásd: Databricks-alkalmazás létrehozása sablonból.

Üzembehelyezési logika

A Databricks Apps támogatja a Pythont, Node.jsvagy mindkettő kombinációját használó alkalmazások üzembe helyezését. Ez rugalmas architektúrákat tesz lehetővé, például egy Python-szerveroldali rendszerrel rendelkező Node.js kliensoldali felületet.

Az üzembe helyezés során a build folyamat egy package.json fájlt keres az alkalmazáskönyvtár gyökerénél annak megállapításához, hogy Node.js van-e használva. Ha van ilyen, a Python-lépések mellett csomópontspecifikus buildelési lépéseket is tartalmaz. Az üzembehelyezési logika a következő mintát követi:

Ha package.json jelen van:

  1. Az npm install parancs futtatása
  2. Futtasd pip install -r requirements.txt (ha létezik)
  3. Futtatás npm run build (ha egy build szkript definiálva van package.json)
  4. Futtassa a megadott app.yamlparancsot, vagy npm run start ha nincs megadva parancs

Megjegyzés:

Ha nincs megadva parancs, app.yamlaz Azure Databricks akkor is végrehajtja a parancsot npm run start, ha az alkalmazás Python-kódot tartalmaz. Python- és Node.js folyamatok futtatásához definiáljon egy egyéni start szkriptet, amely egy olyan eszközt használ, mint a concurrently, hogy mindkettőt elindítsa. Például: concurrently "npm run start:node" "python my_app.py".

Ha package.json nincs jelen:

  1. Futtasd pip install -r requirements.txt (ha létezik)
  2. Futtassa a megadott app.yamlparancsot, vagy python <my-app>.py ha nincs megadva parancs

Felkészülés az üzembe helyezésre

Az alkalmazás üzembe helyezése előtt ellenőrizze, hogy a projekt tartalmazza-e a szükséges összetevőket:

Emellett győződjön meg arról, hogy az alkalmazás szolgáltatásprincipális hozzáfér a forráskód mappához.

Telepítési forrás kiválasztása

A Databricks-alkalmazásokat a következő forrásokból helyezheti üzembe:

  • Munkaterületi mappa – Alkalmazásfájlok feltöltése munkaterületi mappába, és onnan üzembe helyezés. Ez a szabványos üzembe helyezési módszer.
  • Git-adattár – Git-adattár konfigurálása egy alkalmazáshoz, és közvetlen üzembe helyezés anélkül, hogy fájlokat töltenének fel a munkaterületre. Az alkalmazás minden üzembe helyezéskor beolvassa a kódot a konfigurált Git-referenciaból (ág, címke vagy véglegesítés). Az összes fő Git-szolgáltató támogatott, beleértve a GitHubot, a GitLabetet és a Bitbucketet. A támogatott szolgáltatók teljes listáját a Git-szolgáltató csatlakoztatása a Databrickshez című témakörben találja.

Ugyanahhoz az alkalmazáshoz bármikor válthat a munkaterület és a Git-források között.

Az alkalmazás üzembe helyezése

A következő szakaszok leírják, hogyan lehet üzembe helyezni munkahelyi mappából vagy közvetlenül Git-adattárból.

Üzembe helyezés munkaterületi mappából

Databricks felhasználói felület

Alkalmazás üzembe helyezése az Azure Databricks felhasználói felületén:

  1. Töltse fel az alkalmazásfájlokat az Azure Databricks-munkaterületre. Útmutatásért lásd : Fájl importálása.
  2. Kattintson a Számítás gombra számítási ikonaz oldalsávon.
  3. Lépjen az Alkalmazások lapra, és kattintson az alkalmazásra mutató hivatkozásra a Név oszlopban.
  4. Kattintson az Üzembe helyezés gombra , és válassza ki azt a mappát a munkaterületen, ahová feltöltötte az alkalmazásfájlokat.
  5. Kattintson a Kiválasztás, majd az Üzembe helyezés gombra.
  6. Tekintse át a konfigurációt, és kattintson az Üzembe helyezés gombra.

A Databricks parancssori felülete

Alkalmazás üzembe helyezése a parancssori felület használatával:

  1. Nyisson meg egy terminált, és keresse meg az alkalmazásfájlokat tartalmazó könyvtárat.

  2. Töltse fel az alkalmazásfájlokat az Azure Databricks-munkaterületre a sync parancs használatával. Cserélje le az elérési utat arra a munkaterületre, ahová fel szeretné tölteni a fájlokat.

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

    A --watch jelölő folyamatosan futtatja a szinkronizálási folyamatot, és automatikusan feltölti a módosításokat a fájlok helyi módosításakor. Ha bizonyos fájlokat vagy könyvtárakat ki szeretne zárni a szinkronizálásból, vegye fel őket egy .gitignore fájlba a helyi alkalmazáskönyvtárban. A kizárandó gyakori fájlok a következők: node_modules/, .env, __pycache__/, .DS_Store, valamint minden nagy adatfájl vagy build-artefaktum.

  3. Ellenőrizze a feltöltést a munkaterület fájljainak megtekintésével. Kattintson a Munkaterület ikonmunkaterületére az oldalsávon, és keresse meg az alkalmazáshoz létrehozott könyvtárat.

  4. Telepítse az alkalmazást az alábbi parancs futtatásával. Cserélje le az alkalmazás nevét és a forráskód elérési útját az értékekre.

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

    A parancssori felület megjeleníti az üzembe helyezés előrehaladását, és megerősíti az alkalmazás futását.

Üzembe helyezés Git-adattárból

Fontos

Ez a funkció bétaverzióban érhető el. Ha egy rendszergazda letiltja a funkciót, a Gitből üzembe helyezett meglévő alkalmazások továbbra is futnak, de nem helyezheti újra és nem indíthatja újra őket, amíg újra nem engedélyezi az előnézetet, vagy nem távolítja el az adattárat az alkalmazásból.

Ha git-adattárból szeretne üzembe helyezni egy alkalmazást, adja hozzá az adattárat az alkalmazás szintjén, majd az üzembe helyezéskor adja meg a Git-referenciát. A Git-adattárnak tartalmaznia kell az alkalmazásfájlokat, beleértve app.yamla függőségeket és a belépési pontot. Az összes fő Git-szolgáltató támogatott, beleértve a GitHubot, a GitLabetet és a Bitbucketet.

Alkalmazás konfigurálása és üzembe helyezése a Gitből:

  1. Töltse fel az alkalmazásfájlokat egy Git-adattárba.
  2. Az Azure Databricks-munkaterületen kattintson a Számítás ikonra az oldalsávon.
  3. Lépjen az Alkalmazások lapra, és válasszon ki egy meglévő alkalmazást a szerkesztéshez, vagy kattintson az Alkalmazás létrehozása gombra.
  4. A Git-adattár konfigurálása lépésben adja meg a Git-adattár URL-címét (például https://github.com/org/repo) és válasszon ki egy Git-szolgáltatót.
  5. Kattintson az Alkalmazás létrehozása vagy a Mentés gombra az alkalmazás részleteinek lapjára való visszatéréshez.
  6. Magánadattárak esetén az alkalmazás szolgáltatásnévének konfigurálnia kell egy Git-hitelesítő adatot. Az alkalmazás részletei lapon kattintson a Git-hitelesítő adatok konfigurálása elemre. Másik lehetőségként szerkessze az alkalmazást, és adja hozzá a hitelesítő adatokat a Git-adattár konfigurálása lépéshez. Git-hitelesítő adatok hozzáadásához engedélyekkel kell rendelkeznie CAN MANAGE az alkalmazáshoz. Az egyes szolgáltatókkal kapcsolatos utasításokért lásd: A Git-szolgáltató csatlakoztatása a Databrickshez.

Fontos

A biztonság érdekében az Azure Databricks törli az alkalmazás szolgáltatásnevéhez társított összes Git-hitelesítő adatot az üzembehelyezési forrás módosításakor (Gitről munkaterületre vagy munkaterületről Gitre), vagy amikor módosítja a Git-adattárat. Csak a Git-hivatkozás módosítása nem törli a hitelesítő adatokat. Az üzembehelyezési forrás vagy adattár módosítása után újra kell konfigurálnia a Git hitelesítő adatait, hogy újra üzembe helyezhesse a Gitből.

Megjegyzés:

Az alkalmazáskészítők csak akkor kapnak CAN MANAGE automatikusan engedélyeket a szolgáltatási főfelhasználóra, ha engedélyezve van a Git üzembe helyezési bétaszolgáltatása. Ha a funkció letiltása közben hozott létre alkalmazást, lehet, hogy nincs engedélye Git-hitelesítő adatok hozzáadására.

A szolgáltatásnevek szolgáltatónként egy Git-hitelesítő adatot támogatnak. A hitelesítő adatok (például a fiókkonzolon keresztül) frissítése lecseréli a szolgáltatónál meglévő hitelesítő adatokat, és hatással van az összes, azt a szolgáltatásobjektumot használó alkalmazásra.

Ezután telepítse az alkalmazást:

  1. Az alkalmazás részletei lapon kattintson az Üzembe helyezés gombra.
  2. Válassza a Gitből lehetőséget.
  3. Git-referenciaként adja meg az ág nevét, címkéjét vagy véglegesítési SHA-ját (például main, vagy v1.0.0egy véglegesítési kivonatot).
  4. Referenciatípus esetén adja meg a hivatkozás típusát, például ágat, címkét vagy véglegesítést.
  5. Kattintson az Üzembe helyezés gombra.

Ág- vagy címkehivatkozások esetén az Azure Databricks az adott ágból vagy címkéből telepíti a legutóbbi véglegesítést. A commit SHA-hivatkozások esetében az Azure Databricks mindig telepíti az adott commitot. Ha a szolgáltatási főelem Git-hitelesítő adatai érvénytelenek vagy lejártak, az üzembe helyezés meghiúsul.

Üzembe helyezés utáni viselkedés

Az üzembe helyezés befejezése után az Azure Databricks elindítja az alkalmazást a fájlban command megadott app.yaml vagy az alapértelmezett futtatási python app.pybeállítások alapján. Az alkalmazás részleteinek lapja az aktuális állapotot mutatja, és hozzáférést biztosít a naplókhoz, az üzembe helyezési előzményekhez és a környezeti információkhoz.

Az alkalmazás részleteinek lapjának megtekintése az alkalmazás üzembe helyezése után

Az üzembe helyezett alkalmazás kimenetének megtekintéséhez kattintson az alkalmazás hivatkozására.

Nyissa meg a Naplók lapot a hibakereséshez és a futtatókörnyezet monitorozásához. Lásd: Databricks-alkalmazások naplózása és monitorozása.

Az alkalmazás frissítése vagy ismételt üzembe helyezése

Az alkalmazás ismételt üzembe helyezése a forráskód vagy a konfiguráció módosítása után. Az újbóli üzembe helyezés az alkalmazás újbóli létrehozása nélkül alkalmazza a legújabb frissítéseket. Bármikor újra üzembe helyezheti a munkaterületről vagy a Git-adattárból.

Ismételt üzembe helyezés munkaterületi mappából

Munkaterület mappából történő ismételt üzembe helyezés:

  1. Frissítse az alkalmazásfájlokat a munkaterület mappájában.
  2. Jelölje ki az alkalmazást, és kattintson az Üzembe helyezés gombra.
  3. Ha a forráskód elérési útja megváltozott, vagy egy Git-forrásról vált, kattintson az Üzembe helyezés melletti nyílra, és válassza az Üzembe helyezés másik forrás használatával lehetőséget.

Újbóli üzembe helyezés Git-adattárból

Git-adattárból történő ismételt üzembe helyezés:

  1. Küldje el a módosításokat a Git-adattárba.
  2. Az Azure Databricks-munkaterületen válassza ki az alkalmazást, és kattintson az Üzembe helyezés gombra.
  3. Ha a Git-referencia megváltozott, vagy munkaterület-forrásról vált, kattintson az Üzembe helyezés melletti nyílra, és válassza az Üzembe helyezés másik forrás használatával lehetőséget.

A Git-adattár vagy -hitelesítő adatok módosításához szerkessze az alkalmazás konfigurációját. A Git-adattár alkalmazásból való eltávolítása kényszeríti az üzembe helyezést a munkaterületről.

Fontos

A Git-adattár módosítása vagy az üzembehelyezési források (Git és munkaterület) közötti váltás törli az alkalmazás szolgáltatásnévhez tartozó összes Git-hitelesítő adatot. A Gitből való ismételt üzembe helyezés előtt újra kell konfigurálnia a hitelesítő adatokat.

Üzembehelyezési problémák elhárítása

Ha az alkalmazás üzembe helyezése sikertelen vagy nem a várt módon fut, próbálkozzon a következő hibaelhárítási lépésekkel:

  • Ellenőrizze a naplókban a hibaüzeneteket vagy a futásidejű kimenetet.
  • Szintaxis és beállítások ellenőrzése app.yaml .
  • Ellenőrizze, hogy a env szakaszban szereplő titkos kódok és környezeti változók megfelelően feloldódnak-e.
  • Győződjön meg arról, hogy az összes szükséges függőség megtalálható vagy telepítve van.

Git-adattár üzembe helyezése esetén:

  • Magánadattárak esetén ellenőrizze, hogy az alkalmazás szolgáltatási azonosítójához konfigurálva van-e a Git-hitelesítő adat.
  • Ellenőrizze, hogy a Git-adattár URL-címe helyes-e.
  • Ellenőrizze, hogy a Git-hivatkozás (ág, címke vagy véglegesítés) létezik-e az adattárban.

Következő lépések

  • Last updated on