Databricks-alkalmazás üzembe helyezése

Az Azure Databricks alkalmazás létrehozása és fejlesztése után telepítse azt, hogy elérhetővé tegye 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 a 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, 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 azokat az alkalmazásokat, amelyek Python, Node.jsvagy mindkettő kombinációját használják. Ez lehetővé teszi a rugalmas architektúrákat, például egy Node.js előtérrendszert Python háttérrendszerrel.

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 csomópontspecifikus buildelési lépéseket is tartalmazza Python lépések mellett. Az üzembehelyezési logika a következő mintát követi:

Ha package.json jelen van:

1. Az npm install parancs futtatása
2. Telepítse Python függőségeket:
   • Ha requirements.txt létezik, futtassa a pip install -r requirements.txt
   • Ha requirements.txt nem létezik, és pyproject.toml és uv.lock léteznek, futtassa uv sync a függőségek telepítéséhez
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 app.yaml nem adott meg parancsot, Azure Databricks akkor is végrehajtja npm run start, ha az alkalmazás Python kódot tartalmaz. A Python és Node.js folyamatok futtatásához definiáljon egy egyéni start szkriptet, amely a concurrently eszközhöz hasonló eszközt használ mindkettő elindításához. Például: concurrently "npm run start:node" "python my_app.py".

Ha package.json nincs jelen:

1. Telepítse Python függőségeket:
   • Ha requirements.txt létezik, futtassa a pip install -r requirements.txt
   • Ha requirements.txt nem létezik, és pyproject.toml és uv.lock léteznek, futtassa uv sync a függőségek telepítéséhez
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:

• Fő szkript – A belépési pont fájlja, például app.py vagy app.js.
• Választható app.yaml fájl – Ha az alkalmazás egyéni parancsot vagy környezeti változót igényel, adjon meg egy app.yaml fájlt a végrehajtás konfigurálásához. Lásd: A Databricks-alkalmazás végrehajtásának konfigurálása a következővel app.yaml: .
• Függőségek – Győződjön meg arról, hogy minden függőség elérhető. Lásd: Databricks-alkalmazások függőségeinek kezelése.
• Titkos kódok vagy környezeti értékek – Ha a env szakaszt app.yamlhasználja, ellenőrizze, hogy a hivatkozott titkos kulcsok vagy külső források megfelelően vannak-e konfigurálva és hozzáférhetők-e. Lásd: Erőforrások hozzáadása Databricks-alkalmazásokhoz.

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). Megadhat egy forráskód elérési útját is, amely az adattár egy adott könyvtárából telepíthető. Minden fő Git-szolgáltató támogatott, beleértve a GitHub, a GitLab és a Bitbucket szolgáltatást. 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ás között, kivéve, ha a munkaterület rendszergazdája csak a Git-alapú üzembe helyezéseket kényszeríti ki. Lásd: Csak Git-alapú telepítések engedélyezése.

Kizárólag Git-alapú telepítések engedélyezése

A munkaterület rendszergazdái megkövetelhetik, hogy a munkaterület összes alkalmazása üzembe legyen helyezve a Git-adattárakból. A beállítás engedélyezéséhez nyissa meg a Beállítások>fejlesztőalkalmazásokat>, és kapcsolja be a Csak alkalmazástelepítések engedélyezése a Gitből. Alapesetben ez a beállítás ki van kapcsolva.

Ha engedélyezi ezt a beállítást:

• A felhasználóknak konfigurálnia kell egy Git-adattárat az alkalmazás létrehozása előtt.
• A felhasználók csak a Gitből telepíthetnek, munkaterületi mappákból nem.
• A Databricks letiltja az alkalmazássablonokat a munkaterületen.
• A felhasználók nem távolíthatnak el Git-adattárat az olyan alkalmazásokból, amelyek rendelkeznek ilyenekkel.
• A meglévő alkalmazások továbbra is futnak, de a felhasználók csak akkor helyezhetik üzembe vagy indíthatják újra őket, ha az alkalmazás rendelkezik Git-adattárral.

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 a Azure Databricks felhasználói felületén:

1. Töltse fel az alkalmazásfájlokat a Azure Databricks munkaterületre. Útmutatásért lásd : Fájl importálása.
2. A Databricks-munkaterületen kattintson az , válassza a Databricks alkalmazások közül a Databricks Apps lehetőséget.
3. Válassza ki az alkalmazást 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.

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 a Azure Databricks munkaterületre a sync paranccsal. 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 az App Switcher >Lakehouse, majd a munkaterülete elemre, é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

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. Minden fő Git-szolgáltató támogatott, beleértve a GitHub, a GitLab és a Bitbucket szolgáltatást. A Git által támogatott alkalmazásokat a felhasználói felület, a parancssori felület, az API vagy a Deklaratív automatizálási csomagok használatával is üzembe helyezheti.

Databricks felhasználói felület

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. A Databricks-munkaterületen kattintson az , válassza a Databricks alkalmazások közül a Databricks Apps lehetőséget.
3. Jelöljön ki egy meglévő alkalmazást a szerkesztéshez, vagy kattintson az + Alkalmazás létrehozása elemre.
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, vagy 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. A nyilvános adattárakhoz nincs szükség Git-hitelesítő adatokra. Az egyes szolgáltatókkal kapcsolatos utasításokért lásd: A Git-szolgáltató csatlakoztatása a Databrickshez.

Ezután telepítse az alkalmazást:

1. Az alkalmazás áttekintési oldalán 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. (Nem kötelező) A forráskód elérési útjaként adja meg az adattár egy adott könyvtárának elérési útját. Az alkalmazás ezt a könyvtárat a legfelső szintű könyvtárként kezeli, és nem fér hozzá a rajta kívüli fájlokhoz. Ha nem ad meg elérési utat, a Databricks az adattár gyökerét használja.
6. Kattintson az Üzembe helyezés gombra.

A Databricks parancssori felülete

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

1. Töltse fel az alkalmazásfájlokat egy Git-adattárba.

2. Konfigurálja az alkalmazás Git-adattárát az alkalmazás létrehozásakor, vagy vegye fel egy meglévő alkalmazásba. A támogatott szolgáltatók közé tartoznak: gitHub, gitHubEnterprise, gitLab, gitLabEnterpriseEdition, bitbucketCloud, bitbucketServer, azureDevOpsServices, és awsCodeCommit.

   Ha egy git-adattárral konfigurált új alkalmazást szeretne létrehozni, használja a létrehozási parancsot:

   databricks apps create my-app \
      --json '{"git_repository": {"url": "https://github.com/org/repo", "provider": "gitHub"}}'
   

   Git-adattár meglévő alkalmazáshoz való hozzáadásához vagy frissítéséhez használja a create-update parancsot:

   databricks apps create-update my-app \
      --json '{"update_mask": "git_repository", "git_repository": {"url": "https://github.com/org/repo", "provider": "gitHub"}}'
   

3. Privát adattárak esetén konfiguráljon egy Git-hitelesítő adatot az alkalmazás szolgáltatásnévéhez. Git-hitelesítő adatok hozzáadásához engedélyekkel kell rendelkeznie CAN MANAGE az alkalmazáshoz. A nyilvános adattárakhoz nincs szükség Git-hitelesítő adatokra.

   Ha Git-hitelesítő adatokat szeretne hozzáadni az alkalmazás szolgáltatásnévéhez a parancssori felület használatával, futtassa a következőt:

   databricks git-credentials create --json '{
     "git_provider": "gitHub",
     "git_email": "your-email@example.com",
     "personal_access_token": "YOUR_TOKEN",
     "principal_id": YOUR_SP_ID,
     "name": "GitHub credentials for SP"
   }'
   

   Cserélje le YOUR_SP_ID az alkalmazás szolgáltatásnév-azonosítójára. Az egyes szolgáltatókhoz tartozó személyes hozzáférési jogkivonat beszerzésére vonatkozó utasításokat a Git-szolgáltató csatlakoztatása a Databrickshez című témakörben találja.

4. Az alkalmazás üzembe helyezése a Git-referencia megadásával. Megadhat egy branch, tagvagy commit (ezek kölcsönösen kizáró). Opcionálisan adja hozzá a source_code_path elemet, hogy az adattár egy alkönyvtárából történjen az üzembe helyezés.

   databricks apps deploy my-app \
      --json '{"git_source": {"branch": "main"}}'
   

   Egy meghatározott címke vagy kódrészlet üzembe helyezése:

   databricks apps deploy my-app \
      --json '{"git_source": {"tag": "v1.0.0"}}'
   

   databricks apps deploy my-app \
      --json '{"git_source": {"commit": "abc123def456"}}'
   

   Az adattár alkönyvtárából történő üzembe helyezés:

   databricks apps deploy my-app \
      --json '{"git_source": {"branch": "main", "source_code_path": "apps/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.

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

Megjegyzés:

Azok az alkalmazások, amelyeket a Git bevezetése előtt hoztak létre, nem biztosítanak automatikusan engedélyeket az alkotóknak CAN MANAGE hozzáférésére a szolgáltatásfelelőshöz. Ha Git-hitelesítő adatokat kell hozzáadnia egy régebbi alkalmazáshoz, kérje meg a munkaterület rendszergazdáját, hogy adjon engedélyeket a szolgáltatási fő azonosítóhoz CAN MANAGE önnek.

A szolgáltatásnevek szolgáltatónként egy Git-hitelesítő adatot támogatnak. Ha máshol, például a fiókkonzolon keresztül frissíti a hitelesítő adatokat, az lecseréli az adott szolgáltató meglévő hitelesítő adatait.

Üzembe helyezés utáni viselkedés

Az üzembe helyezés befejeződése után az Azure Databricks elindítja az alkalmazást a command fájlban megadott app.yaml alapján, vagy alapértelmezésben a python app.py futtatásával. 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 ü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. A Azure Databricks munkaterületen válassza ki az alkalmazást, és kattintson a Deploy elemre.
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 parancssori felülettel vagy API-val való frissítéséhez használja a create-update parancsot. 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. Csak a Git-hivatkozás módosítása nem törli a hitelesítő adatokat. 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.
• Ha a munkaterület Private Link vagy korlátozott kimenő hálózati házirendeket használ, ellenőrizze, hogy a szükséges tartományok engedélyezve vannak-e. A hiányzó kimenő forgalom engedélyezési lista bejegyzései gyakran okoznak üzembe helyezési hibákat Private Link környezetekben. Lásd: Alkalmazások üzembe helyezése Private Link környezetekben.

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

• Privát adattárak esetén ellenőrizze, hogy az alkalmazás szolgáltatásnévéhez konfigurálva van-e Git-hitelesítő adat.
• Ellenőrizze, hogy a Git-adattár URL-címe helyes-e, és hogy a Git-hivatkozás (ág, címke vagy véglegesítés) létezik-e az adattárban.
• Ha egy munkaterület rendszergazdája csak Git-alapú telepítéseket kényszerít ki, csak akkor helyezhet üzembe vagy indíthat el alkalmazásokat, ha konfigurálva van egy Git-adattár.
• Ha a parancssori felületről, az API-ból vagy a deklaratív automatizálási csomagokból telepíti az alkalmazást, először hozza létre az alkalmazást, majd adja hozzá a Git-hitelesítő adatokat az alkalmazás szolgáltatásnévhez.

Következő lépések

• Databricks-alkalmazások naplózása és monitorozása
• Databricks-alkalmazások engedélyeinek konfigurálása
• Databricks-alkalmazás végrehajtásának konfigurálása app.yaml