Partilhar via

Configure a execução do aplicativo Databricks com app.yaml

O app.yaml ficheiro numa aplicação Databricks define como a sua aplicação corre. Se seu aplicativo exigir um ponto de entrada diferente ou uma configuração específica do ambiente, você poderá incluir esse arquivo opcional em seu projeto para substituir o comportamento padrão.

Você pode usar a extensão de arquivo .yaml ou .yml. Esse arquivo deve estar localizado na raiz do diretório do projeto.

Definições suportadas

O app.yaml ficheiro suporta as seguintes definições.

Configuração Tipo Description
command sequence Use essa configuração quando precisar de um comando personalizado para executar seu aplicativo. Por padrão, o Azure Databricks executa aplicativos Python usando o comando python <my-app.py>, onde <my-app.py> é o primeiro .py arquivo na estrutura de arquivos do seu aplicativo. Se o seu aplicativo incluir Node.js, o comando padrão será npm run start. Consulte Lógica de implantação.
Como o Azure Databricks não executa o comando numa shell, variáveis de ambiente definidas fora da configuração da app não estão disponíveis para a tua app. Se o seu aplicativo precisar de parâmetros adicionais para ser executado, use a env estrutura.
Essa configuração é opcional.
env list O Azure Databricks define automaticamente várias variáveis de ambiente padrão no ambiente de tempo de execução do aplicativo. Essa chave de nível superior define uma lista opcional de variáveis de ambiente adicionais a serem passadas para seu aplicativo. Cada variável pode usar um valor codificado ou fazer referência a uma fonte externa, como uma entrada secreta ou de banco de dados.
Os itens válidos na lista são:
  • name: O nome da variável de ambiente.
  • Um dos seguintes:

Essa configuração é opcional.

Exemplo app.yaml para uma aplicação Streamlit

O arquivo a seguir app.yaml mostra como configurar um aplicativo Streamlit. Ele usa um comando personalizado para iniciar o aplicativo com streamlit run, e define variáveis de ambiente para a ID do armazém SQL e um sinalizador de controlo de utilização.

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

Use uma configuração como esta se seu aplicativo depender de um recurso de computação específico, como um SQL warehouse, ou exigir determinadas variáveis de ambiente para controlar o comportamento do tempo de execução.

Exemplo app.yaml de uma aplicação Flask

Este exemplo mostra como configurar um aplicativo Flask usando o servidor Gunicorn. A command configuração especifica os parâmetros de inicialização do Gunicorn e a env seção define o caminho para um volume do Unity Catalog como uma variável de ambiente.

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

Use essa abordagem quando seu aplicativo precisar de um servidor WSGI pronto para produção, como o Gunicorn, e quando depender de dados armazenados em um volume do Catálogo Unity ou em outro caminho específico do ambiente.

Próximos passos

  • Last updated on