Delen via

De uitvoering van de Databricks-app configureren met app.yaml

Het app.yaml bestand in een Databricks-app definieert hoe uw app wordt uitgevoerd. Als voor uw app een andere invoerpunt of omgevingsspecifieke configuratie is vereist, kunt u dit optionele bestand in uw project opnemen om het standaardgedrag te overschrijven.

U kunt de .yaml of .yml bestandsextensie gebruiken. Dit bestand moet zich in de hoofdmap van de projectmap bevinden.

Ondersteunde instellingen

Het app.yaml bestand ondersteunt de volgende instellingen.

Configuratie Typologie Description
command sequence Gebruik deze instelling wanneer u een aangepaste opdracht nodig hebt om uw app uit te voeren. Azure Databricks voert standaard Python-apps uit met behulp van de opdracht python <my-app.py>, waar <my-app.py> is het eerste .py bestand in de bestandsstructuur van uw app. Als uw app Node.jsbevat, is npm run startde standaardopdracht . Zie Implementatielogica.
Omdat Azure Databricks de opdracht niet uitvoert in een shell, zijn omgevingsvariabelen die buiten de app-configuratie zijn gedefinieerd, niet beschikbaar voor uw app. Als voor uw app aanvullende parameters moeten worden uitgevoerd, gebruikt u de env structuur.
Deze instelling is optioneel.
env list In Azure Databricks worden automatisch verschillende standaardomgevingsvariabelen ingesteld in de runtime-omgeving van de app. Deze sleutel op het hoogste niveau definieert een optionele lijst met aanvullende omgevingsvariabelen die aan uw app moeten worden doorgegeven. Elke variabele kan een in code vastgelegde waarde gebruiken of verwijzen naar een externe bron, zoals een geheim of databasevermelding.
De geldige items in de lijst zijn:

Deze instelling is optioneel.

Voorbeeld app.yaml voor een Streamlit-app

In het volgende app.yaml bestand ziet u hoe u een Streamlit-app configureert. Er wordt een aangepaste opdracht gebruikt om de app met streamlit run te starten, en er worden omgevingsvariabelen ingesteld voor de SQL Warehouse-ID en een vlag voor gebruiksregistratie.

command: ['streamlit', 'run', 'app.py']
env:
  - name: 'DATABRICKS_WAREHOUSE_ID'
    value: 'quoz2bvjy8bl7skl'
  - name: 'STREAMLIT_GATHER_USAGE_STATS'
    value: 'false'

Gebruik een dergelijke installatie als uw app is afhankelijk van een specifieke rekenresource, zoals een SQL Warehouse, of vereist bepaalde omgevingsvariabelen om het runtimegedrag te beheren.

Voorbeeld app.yaml voor een Flask-app

In dit voorbeeld ziet u hoe u een Flask-app configureert met behulp van de Gunicorn-server. Met command de instelling worden de opstartparameters van Gunicorn opgegeven en in de env sectie wordt het pad ingesteld op een Unity Catalog-volume als een omgevingsvariabele.

command:
  - gunicorn
  - app:app
  - -w
  - 4
env:
  - name: 'VOLUME_URI'
    value: '/Volumes/catalog-name/schema-name/dir-name'

Gebruik deze methode wanneer uw app een WSGI-server nodig heeft die gereed is voor productie, zoals Gunicorn en wanneer deze afhankelijk is van gegevens die zijn opgeslagen in een Unity Catalog-volume of een ander omgevingsspecifiek pad.

Volgende stappen

  • Last updated on