Afmelden voor vooraf geïnstalleerde Python-bibliotheken voor Databricks-apps

Op deze pagina wordt beschreven hoe u zich afmeldt voor vooraf geïnstalleerde Python-bibliotheken in een horizontaal geschaalde Databricks-app, uw eigen afhankelijkheden beheert en de vooraf geïnstalleerde bibliotheken later weer inschakelt. Afmelden is alleen beschikbaar voor horizontaal geschaalde apps die zijn geconverteerd vanuit een standaard-app. Zie Een standaard-app converteren om horizontaal schalen te gebruiken. Horizontaal schalen bevindt zich in bèta.

Wanneer u een standaard-app omzet naar horizontale schaalbaarheid, koppelt Azure Databricks de geconverteerde app aan de vooraf geïnstalleerde Python-bibliotheken, zodat de bestaande imports van uw app blijven werken. Meld u af om de app uit te voeren op een schone basisimage van het besturingssysteem en geef elke bibliotheek zelf op.

Afmelden voor vooraf geïnstalleerde bibliotheken

Als u zich afmeldt, zorgt u ervoor dat Azure Databricks uw volgende implementatie bouwt op basis van een schone basisinstallatiekopie van het besturingssysteem. De vooraf geïnstalleerde bibliotheken zijn niet meer beschikbaar, tenzij u ze declareert in requirements.txt of pyproject.toml.

Afmelden:

1. Klik op de pagina met app-details op Bewerken.
2. Schakel in de stap Configure het selectievakje Vooraf geïnstalleerde Python-bibliotheken gebruiken uit.
3. Klik op Opslaan. De momenteel actieve implementatie wordt niet beïnvloed.
4. Implementeer uw app opnieuw vanaf het tabblad Implementaties . Deze nieuwe implementatie bouwt op basis van de schone basisinstallatiekopieën van het besturingssysteem.

Aanbevolen werkstroom

Uw afhankelijkheden bevatten mogelijk vooraf geïnstalleerde bibliotheken transitief, dus het is niet altijd duidelijk welke bibliotheken uw app rechtstreeks nodig heeft. Spoor ontbrekende bibliotheken op in een test-app voordat u dit in productie uitschakelt:

1. Maak een nieuwe horizontaal geschaalde app. Nieuwe horizontaal opgeschaalde apps draaien al op de schone basis-OS-image, dus dit komt overeen met uw beoogde situatie na opt-out.
2. Implementeer de bron van uw productie-app in de test-app. Werk requirements.txt (of pyproject.toml) bij en implementeer opnieuw totdat de test-app wordt gestart, aanvragen verwerkt en uw tests doorstaan.
3. Kopieer de uiteindelijke afhankelijkheidsdeclaraties naar de bron van uw productie-app.
4. Volg in de productie-app de stappen in Afmelden voor vooraf geïnstalleerde bibliotheken en implementeer de bijgewerkte bron.

Productie blijft draaien op de image met de vooraf geïnstalleerde bibliotheken totdat uw nieuwe implementatie de healthchecks doorstaat, zodat deze aanpak downtime voorkomt terwijl u ontbrekende afhankelijkheden in de test-app opspoort.

Fouten oplossen na afmelden

De meest voorkomende fout nadat u zich hebt afgemeld, is een ModuleNotFoundError bij het opstarten van de app, veroorzaakt door een framework of bibliotheek die uw code impliciet heeft geïmporteerd uit de vooraf geïnstalleerde set. U kunt dit oplossen:

1. Open het tabblad Logboeken op de pagina met app-details.
2. Zoek de ontbrekende modulenaam in de build- of runtimelogboeken.
3. Voeg het bijbehorende pakket toe aan requirements.txt (of pyproject.toml) en implementeer het opnieuw.

Een nieuwe implementatie vervangt alleen de actieve implementatie als het app-proces de eerste paar seconden na het opstarten actief blijft. Een opt-out-deployment die onmiddellijk vastloopt door een ontbrekende import, neemt het verkeer nooit over en het verkeer blijft naar de vorige werkende deployment gaan terwijl u de lijst met afhankelijkheden corrigeert. De opstartcontrole is ondiep, dus test of uw app daadwerkelijk aanvragen verwerkt nadat u zich afmeldt in plaats van te vertrouwen op de controle om beschadigde implementaties te ondervangen.

Vooraf geïnstalleerde bibliotheken weer inschakelen

Als u wilt terugkeren naar de vooraf geïnstalleerde bibliotheken nadat u zich hebt afgemeld:

1. Klik op de pagina met app-details op Bewerken.
2. Schakel in de stap Configure het selectievakje Vooraf geïnstalleerde Python-bibliotheken gebruiken in.
3. Klik op Opslaan.
4. Implementeer uw app opnieuw vanaf het tabblad Implementaties . Deze nieuwe implementatie bouwt op basis van de basisinstallatiekopieën met de vooraf geïnstalleerde bibliotheken.

Uw requirements.txt en pyproject.toml blijven van toepassing, dus eventuele expliciete declaraties die u hebt toegevoegd terwijl u zich afmeldt, blijven behouden.