implantado a Databricks app

Depois de criar e desenvolver seu aplicativo Databricks, o senhor está pronto para implantá-lo. A implantação torna o aplicativo acessível no site Databricks workspace e o executa usando as configurações definidas nos arquivos do projeto.

nota

Se o senhor criar um aplicativo a partir de um padrão, o Databricks o implantará automaticamente quando o criar pela primeira vez. No entanto, o senhor ainda pode reimplantá-lo mais tarde, depois de fazer alterações. Consulte Criar um aplicativo Databricks a partir de um padrão.

Lógica de implantação

Databricks O Apps suporta aplicativos implantados que usam Python, Node.js, ou uma combinação de ambos. Isso permite arquiteturas flexíveis, como um frontend Node.js com um backend Python.

Durante a implementação, o processo de compilação verifica se há um arquivo package.json na raiz do diretório do aplicativo para determinar se o Node.js é usado. Se estiver presente, ele inclui etapas de compilação específicas do Node juntamente com as etapas do Python. A lógica de implantação segue esse padrão:

Se package.json estiver presente :

1. Executar npm install
2. execução pip install -r requirements.txt (se existir)
3. execução npm run build (se um script build estiver definido em package.json)
4. executar o comando especificado em app.yaml, ou npm run start se nenhum comando for especificado

nota

Se nenhum comando for especificado em app.yaml, a Databricks executa npm run start, mesmo que o aplicativo inclua código Python. Para executar os processos Python e Node.js, defina um script start personalizado que use uma ferramenta como o concurrently para iniciar ambos. Por exemplo: concurrently "npm run start:node" "python my_app.py".

Certifique-se de definir todas as dependências necessárias do Node.js em package.json, pois nenhuma biblioteca do Node.js é pré-instalada no ambiente do Databricks Apps.

Se package.json não estiver presente :

1. execução pip install -r requirements.txt (se existir)
2. executar o comando especificado em app.yaml, ou python <my-app>.py se nenhum comando for especificado

Prepare-se para a implantação

Antes de implantar o aplicativo, verifique se o projeto inclui os componentes necessários:

• Script principal - Seu arquivo de ponto de entrada, como app.py ou app.js.
• Arquivo app.yaml opcional - Se o seu aplicativo exigir um comando personalizado ou uma variável de ambiente, inclua um arquivo app.yaml para configurar a execução. Consulte Configurar a execução do aplicativo Databricks com app.yaml.
• Dependências - Certifique-se de que todas as dependências estejam disponíveis. Consulte gerenciar dependências para um aplicativo Databricks.
• Segredos ou valores do ambiente - Se você usar a seção env em app.yaml, verifique se os segredos referenciados ou as fontes externas estão corretamente configurados e acessíveis. Consulte Adicionar recurso a um aplicativo Databricks.

Além disso, certifique-se de que a entidade de serviço do aplicativo tenha acesso à pasta do código-fonte.

implantado o aplicativo

Databricks UI

Para implantar um aplicativo na interface do usuário Databricks:

1. Faça upload dos arquivos do aplicativo para o site Databricks workspace. Para obter instruções, consulte Importar um arquivo.
2. Clique em Calcular na barra lateral.
3. Acesse Apps tab e clique no link do seu aplicativo na coluna Name (Nome ).
4. Clique em implantado e selecione a pasta em seu site workspace onde o senhor carrega os arquivos do aplicativo.
5. Clique em Select e depois em implantado .
6. Revise a configuração e clique em implantado .

Databricks CLI

Para implantar um aplicativo usando o site CLI:

1. Abra um terminal, navegue até o diretório que contém os arquivos do aplicativo e execute o comando sync para upload para Databricks. Substitua o caminho pelo local workspace onde o senhor deseja colocar os arquivos upload.

   Bash

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

   Para excluir arquivos ou diretórios específicos, adicione-os a um arquivo .gitignore no diretório local do aplicativo.

2. Para view os arquivos em seu workspace, clique em workspace na barra lateral e vá para o diretório criado para seu aplicativo.

3. Para implantar o aplicativo, execute o seguinte comando em um terminal. Substitua o caminho do código-fonte pelo local workspace dos arquivos do aplicativo.

   Bash

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

Uma vez implantado, o Databricks começará seu aplicativo com base no command definido em seu arquivo app.yaml ou executará por padrão o python app.py.

Comportamento pós-implantação

Após a implantação, o aplicativo é executado em um ambiente gerenciado. Para view o status da implantação, acesse a página de visão geral do aplicativo.

Para view a saída do aplicativo implantado, clique no link do aplicativo.

Acesse os registros tab para depuração e monitoramento do tempo de execução. Veja a visualização logs para seu aplicativo Databricks.

Atualize ou reimplante o aplicativo

Talvez o senhor queira atualizar ou reimplantar o aplicativo se tiver feito alterações no código-fonte, atualizado o arquivo app.yaml ou se precisar implantá-lo a partir de um caminho de código-fonte diferente. O Re-implantado aplica as atualizações mais recentes sem a necessidade de recriar o aplicativo do zero.

Para fazer alterações em um aplicativo implantado:

1. Atualize o código do seu aplicativo ou a configuração app.yaml.
2. Retorne à página Apps no site Databricks workspace.
3. Selecione seu aplicativo e escolha implantado novamente. Se o caminho do código-fonte for alterado, clique na seta ao lado de implantado e selecione implantado usando um caminho de código-fonte diferente

Solucionar problemas de implantação

Se o aplicativo não for implantado ou não for executado conforme o esperado, tente as seguintes etapas de solução de problemas:

• Verificar logs - visualizar mensagens de erro ou saída de tempo de execução no painel logs.
• Validar app.yaml - Certifique-se de que a sintaxe esteja correta e que as configurações suportadas sejam usadas.
• Verifique os segredos e a variável de ambiente - Certifique-se de que todas as referências na seção env sejam resolvidas corretamente.
• Confirmar dependências - Certifique-se de que todos os pacotes necessários estejam incluídos ou instalados.